Serveur MCP

Chaque site Jamdesk inclut un serveur MCP (Model Context Protocol) intégré. Tandis que llms.txt fournit aux outils IA un instantané statique de votre documentation, MCP leur permet d'effectuer des recherches et des requêtes de manière interactive — utile lorsque les agents IA ont besoin de trouver des réponses précises plutôt que de tout lire.

Qu'est-ce que MCP ?

Le Model Context Protocol est un standard ouvert permettant aux outils IA d'accéder à des sources de données externes. Votre documentation Jamdesk expose deux outils via MCP :

Configuration rapide

claude mcp add --transport http my-docs https://my-project.jamdesk.app/_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://my-project.jamdesk.app/_mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

# Search for content
curl -X POST https://my-project.jamdesk.app/_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 parallèlement à votre documentation :

• Classement BM25 — Classe les résultats par pertinence
• Correspondance approximative — Gère les fautes de frappe (tolérance d'1 caractère)
• Pondération des champs — Les titres et en-têtes de section ont un poids supérieur au contenu du corps
• Filtrage par type — Filtrez les résultats par type de contenu (API, guide, etc.)

L'index est reconstruit à chaque déploiement.

Limites de débit

L'endpoint MCP a une limite de débit de 60 requêtes par minute par adresse IP. C'est suffisant pour une utilisation normale avec un assistant IA. Si vous dépassez cette limite, vous recevrez une réponse 429.

Dépannage

curl https://my-project.jamdesk.app/_mcp

Et ensuite ?