Aller au contenu

Permis Online · Connexion MCP

Connecter un assistant à nos fiches

Un client compatible MCP peut rechercher nos fiches et les consulter à la demande. Les fiches consultées conservent leur lien et les sources qui les documentent.

Configurer un client compatible

Une adresse. Deux outils.

Ajoute ce serveur dans les réglages MCP de ton client. Celui-ci doit prendre en charge les serveurs distants en Streamable HTTP.

Transport
Streamable HTTP, messages JSON
Authentification
Aucune clé pour ces données publiques
Accès
Lecture des fiches de référence uniquement
  1. Ajoute un serveur distant

    Ouvre les réglages MCP de ton client et crée une connexion par URL.

  2. Colle l’adresse du serveur

    Utilise l’URL ci-dessus avec le transport Streamable HTTP. Aucune clé d’API n’est demandée.

  3. Recherche puis consulte une fiche

    Le client découvre les outils search et fetch. Demande-lui de conserver le lien de la fiche dans sa réponse.

Les noms des réglages et la disponibilité des connexions MCP dépendent du client utilisé.

Les outils disponibles

Rechercher, puis lire la source.

search(query)

Recherche les fiches correspondant à une question. Les résultats fournissent les identifiants nécessaires pour les consulter.

Exemple de recherchepermis provisoire en Wallonie

fetch(id)

Récupère une fiche précise avec son contenu, son contexte et les références associées.

Exemple d’identifiant réelfait-f2a7c629fbe649c3

Une demande à essayer

Recherche les fiches Permis Online sur le permis provisoire en Wallonie. Consulte les fiches utiles, distingue les conditions selon la région et cite leurs liens avec la date de vérification.

Le périmètre

Des références publiques, en lecture seule.

Ce que le serveur permet

Rechercher et consulter les 365 fiches publiques : faits documentés, expertise, équipe, offres, pages professionnelles, articles, leçons et ressources. Les liens de citation et les références disponibles accompagnent les données.

Des informations à contextualiser

La région, la date et la portée de la vérification restent importantes. L’assistant doit consulter les références pertinentes avant de résumer une condition ou une démarche.

Prêt à brancher

Des exemples à copier.

Utilise un client MCP distant ou le SDK officiel. Le serveur fournit les outils search et fetch, sans clé ni compte Permis Online.

Vérifier la connexion

Teste la connexion en recherchant et en consultant une fiche publique.

Compatibilité

Transport Streamable HTTP, protocole 2025-11-25, réponses JSON, sans session persistante. Le client doit envoyer Accept: application/json, text/event-stream, puis MCP-Protocol-Version: 2025-11-25 après initialize. Un navigateur sur un autre domaine doit utiliser l’API REST ou un relais serveur ; les origines externes ne sont pas activées sur la route MCP.

La disponibilité d’un serveur MCP distant dépend de l’application et de son offre. La connexion ne nécessite aucune inscription chez Permis Online.

Rechercher puis lire une fiche avec le SDK MCPjavascript

Avec Node.js 20 ou ultérieur, installe npm install @modelcontextprotocol/sdk@1.30.0, puis enregistre ce code dans un fichier .mjs. Le SDK gère l’initialisation et les en-têtes du protocole. La lecture utilise l’identifiant réellement renvoyé par la recherche. Conserve le champ url comme citation visible dans ton interface.

javascript
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const client = new Client({ name: 'exemple-permis-online', version: '1.0.0' }, { capabilities: {} });
const transport = new StreamableHTTPClientTransport(new URL('https://permis-online.be/mcp'));

function readTool(result) {
  if (result.isError) throw new Error('L’outil MCP n’a pas pu traiter la demande.');
  if (result.structuredContent) return result.structuredContent;
  const content = result.content?.find(item => item.type === 'text');
  if (!content) throw new Error('Réponse MCP sans contenu.');
  return JSON.parse(content.text);
}

try {
  await client.connect(transport);
  const available = await client.listTools();
  if (!['search', 'fetch'].every(name => available.tools.some(tool => tool.name === name))) {
    throw new Error('Les outils attendus ne sont pas disponibles.');
  }
  const search = readTool(await client.callTool({
    name: 'search', arguments: { query: 'permis provisoire' }
  }));
  if (!search.results.length) {
    console.log('Aucune fiche trouvée.');
  } else {
    const record = readTool(await client.callTool({
      name: 'fetch', arguments: { id: search.results[0].id }
    }));
    console.log(JSON.stringify(record, null, 2));
  }
} finally {
  await client.close();
}

En cas d’erreur

400 : corrige les paramètres. 404 : refais une recherche pour retrouver une fiche disponible. 429 : respecte le délai Retry-After. 503 : réessaie plus tard avec un nombre limité de tentatives. En MCP, contrôle aussi error et isError dans la réponse.

Cette documentation et ses exemples en Markdown

Mise à jour automatique

Retrouver la version actuelle d’une information

L’API et le serveur MCP donnent accès aux publications publiques de Permis Online. Les informations disponibles suivent les mises à jour du site, avec un lien vers la page d’origine et les références associées.

Pour préparer une réponse ou actualiser ton outil, consulte à nouveau les fiches utiles. Tu retrouves ainsi leur version disponible, leurs sources et leurs dates.

Conditions de réutilisation

Réutiliser en citant la source

Les contenus publics de Permis Online peuvent être consultés, cités et résumés pour documenter une réponse ou construire un outil, y compris commercial, avec une attribution visible et un lien vers la page utilisée : « Source : Permis Online ».

Conserve les références, la région et les réserves qui accompagnent l’information. Indique les adaptations apportées et distingue les règles officielles des analyses, offres et contenus pédagogiques de Permis Online.

Les documents et visuels de tiers restent soumis à leurs propres conditions. Pour republier intégralement un cours ou un article de Permis Online, demande une autorisation à contact@permis.online. L’accès aux données ne vaut pas partenariat ni approbation de ton service par Permis Online.

Toujours retrouver l’origine

Des fiches consultables par tous.

Chaque information peut être relue sur le site, avec les références qui l’accompagnent.