Serveur MCP pour votre base de connaissances

Ce que fait un serveur MCP de base de connaissances

Le Model Context Protocol (MCP) est un standard ouvert qui permet aux assistants IA d'appeler des outils et des sources de données externes de façon uniforme. Plutôt que de copier des articles dans un prompt ou d'espérer qu'un modèle ait été entraîné sur votre documentation, l'assistant interroge directement votre base de connaissances : il cherche, lit l'article pertinent et répond avec un lien vers la source.

Pour un centre d'aide, cela comble un vrai manque. Vos clients comme votre équipe posent de plus en plus leurs questions dans des assistants IA plutôt que sur votre site. Un endpoint MCP fait de votre documentation publiée et à jour la référence que ces assistants lisent : les réponses reflètent le produit d'aujourd'hui, pas une indexation vieille de plusieurs mois.

Votre endpoint : un par portail, actif par défaut

Chaque portail est exposé automatiquement. Rien à installer, aucune clé API à émettre, aucun serveur à héberger. Si vous gérez plusieurs portails de marque, chacun a son propre endpoint et ne renvoie que son propre contenu.

• URL : https://be.multibase.io/api/mcp/<portal-slug>, également servie sur l'hôte du portail à /mcp (y compris votre domaine personnalisé).
• Transport : Streamable HTTP, sans état, réponses JSON.
• Compatible avec tout client MCP prenant en charge les serveurs Streamable HTTP distants, par exemple Claude, Cursor et VS Code.
• Les articles sont renvoyés en Markdown avec leur URL canonique, pour que les assistants puissent citer votre portail et y renvoyer.

Connecter un client MCP

La plupart des clients acceptent un serveur distant sous forme de nom et d'URL. L'exemple ci-dessous utilise la structure courante mcpServers. Les clés exactes varient selon le client : VS Code, par exemple, utilise un objet servers avec "type": "http", et Claude permet d'ajouter un serveur distant comme connecteur personnalisé en collant l'URL. Vérifiez le format exact dans la documentation de votre client.

{
  "mcpServers": {
    "acme-help": {
      "url": "https://be.multibase.io/api/mcp/acme"
    }
  }
}

Tester avec curl

L'endpoint étant du JSON-RPC sans état sur HTTP, vous pouvez l'inspecter sans client. Envoyez un POST avec les en-têtes content-type et accept comme ci-dessous. Le premier appel liste les outils disponibles, le second lance une recherche.

curl -X POST https://be.multibase.io/api/mcp/acme \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

curl -X POST https://be.multibase.io/api/mcp/acme \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"search_kb","arguments":{"query":"reset password","limit":5}}}'

Référence des outils

L'argument locale permet à un assistant de demander une langue précise lorsque l'article y est publié, ce qui compte pour les portails proposant du contenu dans plusieurs des 9 langues prises en charge.

Sécurité et périmètre

• Contenu public et publié uniquement. Les brouillons, les langues non publiées et les articles réservés à des groupes de lecteurs ne sont jamais exposés.
• Lecture seule. Aucun outil ne peut créer, modifier ou supprimer quoi que ce soit.
• Limite de débit par endpoint pour protéger votre portail et garder un usage prévisible.
• Isolation par portail. L'endpoint d'un portail ne renvoie que ses propres articles.
• Visible dans les statistiques. Les recherches et lectures d'articles via MCP apparaissent avec la source "MCP", à côté du trafic web et du chat IA, pour voir ce que demandent les assistants.

Cas d'usage

• Les agents du support qui travaillent dans Claude ou Cursor répondent aux tickets à partir de votre vraie documentation, avec des liens à transmettre aux clients.
• Les copilotes internes et assistants d'ingénierie consultent le comportement du produit sans que personne n'entretienne une copie séparée de la documentation.
• Les agents IA de vos clients se connectent à votre centre d'aide public et résolvent les questions pratiques sans ouvrir de ticket.
• Les recherches MCP infructueuses alimentent les mêmes statistiques que celles des lecteurs : les lacunes repérées par les assistants deviennent des idées d'articles.

Ce qui n'est pas encore disponible

L'accès authentifié n'est pas disponible aujourd'hui. Il n'y a ni flux OAuth ni moyen pour un client MCP de lire le contenu des groupes de lecteurs ou tout autre contenu privé : l'endpoint couvre uniquement le contenu public. Si votre besoin principal est de donner à des agents IA l'accès à une documentation interne avec gestion des droits, le serveur MCP de Multibase ne le couvre pas encore, et un outil conçu autour de l'accès authentifié vous conviendra mieux pour l'instant.