Serveur MCP

Chaque site Jamdesk inclut un serveur MCP (Model Context Protocol) intégré. Alors que llms.txt donne aux outils IA un instantané statique de votre documentation, MCP leur permet de rechercher et d'interroger de façon interactive — utile lorsque les agents IA doivent trouver des réponses précises plutôt que de tout lire.

Qu'est-ce que MCP ?

Le Model Context Protocol est une norme ouverte qui permet aux outils IA d'accéder à des sources de données externes. Votre documentation Jamdesk expose deux outils via MCP :

URL de votre endpoint

Votre endpoint MCP est l'URL de votre documentation à laquelle /_mcp est ajouté. Si vous avez un domaine personnalisé actif, utilisez-le :

Configuration rapide

claude mcp add --transport http my-docs https://docs.acme.com/_mcp

Outils disponibles

searchDocs

Recherchez dans votre documentation et obtenez des résultats classés.

Paramètres :

Exemple de requête :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "searchDocs",
    "arguments": {
      "query": "authentication",
      "limit": 5
    }
  }
}

Exemple de réponse :

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [{
      "type": "text",
      "text": "{\"query\":\"authentication\",\"total\":1,\"results\":[{\"title\":\"Authentication\",\"description\":\"How to authenticate API requests\",\"url\":\"/docs/api/authentication\",\"type\":\"api\",\"score\":0.95}]}"
    }]
  }
}

getPage

Récupère le contenu complet d'une page de documentation spécifique.

Paramètres :

Exemple de requête :

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "getPage",
    "arguments": {
      "slug": "api/authentication"
    }
  }
}

Exemple de réponse :

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [{
      "type": "text",
      "text": "{\"title\":\"Authentication\",\"description\":\"How to authenticate\",\"content\":\"## Overview\\n\\nUse API keys to authenticate...\",\"url\":\"/docs/api/authentication\"}"
    }]
  }
}

Tester l'endpoint

Vous pouvez tester votre endpoint MCP directement avec curl :

# List available tools
curl -X POST https://docs.acme.com/_mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

# Search for content
curl -X POST https://docs.acme.com/_mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"searchDocs","arguments":{"query":"getting started"}}}'

Fonctionnement

L'endpoint MCP utilise un index de recherche construit en même temps que votre documentation :

• Classement BM25 - Classe les résultats par pertinence
• Correspondance floue - Gère les fautes de frappe (tolérance de 1 caractère)
• Pondération des champs - Les titres et les en-têtes de section sont pondérés plus fortement que le contenu du corps
• Filtrage par type - Filtre les résultats par type de contenu (API, guide, etc.)

L'index est reconstruit à chaque déploiement.

Limites de débit

L'endpoint MCP applique une limite de débit de 60 requêtes par minute par adresse IP. Cela suffit pour un usage normal par un assistant IA. Si vous dépassez la limite, vous recevrez une réponse 429.

Dépannage

curl https://docs.acme.com/_mcp

Et ensuite ?