Claude Code, Cursor, Devin : toute la documentation leur est servie en texte brut, et un serveur MCP la cherche, la lit et l’essaie en mode test.

La documentation en Markdown

Nos pages font une centaine de kilo-octets de HTML pour quelques kilo-octets de texte utile. Un agent qui en lit trois a rempli son contexte de balises. Les mêmes pages se servent donc en Markdown pur, à trois adresses :

• /llms.txt — le sommaire, avec un lien vers chaque page. C’est ce qu’un agent lit en premier.
• /llms-full.txt — toute la documentation en une seule requête, pour qui préfère tout avaler d’un coup.
• /n-importe-quelle-page.md — chaque page, seule. Par exemple /api/paiements/creer.md ou /webhooks.md.

Elles sont rendues depuis les mêmes sources que les pages que vous lisez : la spécification pour la référence, le texte des guides pour le reste. Elles ne peuvent pas être en retard.

curl https://docs.payiz.app/llms.txt
curl https://docs.payiz.app/api/paiements/creer.md

Le serveur MCP

Mieux que de tout avaler : branchez https://docs.payiz.app/mcp. L’agent cherche ce dont il a besoin, lit la page entière, et peut essayer l’appel en mode test avant d’écrire une ligne.

Dans Claude Code, une ligne suffit — --scope project l’écrit dans le fichier que votre équipe partage :

claude mcp add --transport http payiz https://docs.payiz.app/mcp --scope project

Ou directement dans .mcp.json, à la racine de votre projet — Claude Code, Cursor et les autres lisent ce fichier :

{
  "mcpServers": {
    "payiz": {
      "type": "http",
      "url": "https://docs.payiz.app/mcp"
    }
  }
}

Quatre outils :

• chercher_dans_la_documentation — la question en mots ordinaires, les pages qui répondent avec leur extrait.
• lire_une_page — une page entière, en Markdown.
• lister_les_appels — les 27 appels de l’API, leur méthode et leur chemin.
• essayer_un_appel — appelle vraiment l’API, en mode test : il lance même une demande sur le simulateur, et pose sa clé d’idempotence.

Laisser l’agent essayer

Le dernier outil ne fait rien tant qu’on ne lui a pas confié de clé. Donnez-lui une clé secrète de test dans l’en-tête du serveur :

claude mcp add --transport http payiz https://docs.payiz.app/mcp \
  --header "Authorization: Bearer sk_test_votre_cle"

Ou dans le fichier :

{
  "mcpServers": {
    "payiz": {
      "type": "http",
      "url": "https://docs.payiz.app/mcp",
      "headers": { "Authorization": "Bearer sk_test_votre_cle" }
    }
  }
}

Une clé réelle est refusée, quoi qu’on lui demande : cet outil ne prend que sk_test_. Un agent qui se trompe d’appel perd une minute, pas de l’argent.

Et la spécification

Si votre outil sait lire de l’OpenAPI, api.payiz.app/v1/openapi.json se lit sans clé et décrit les 27 appels avec tous leurs champs, et ses webhooks. C’est elle qui écrit la référence, et elle génère un client dans à peu près tous les langages.