Docs
/
Menu

DocsPour les développeurs

Le serveur MCP de Leaf

Les détails techniques pour connecter un agent : transport, OAuth, jetons, conventions.

Adresse

https://mcp.getleaf.dev/mcp

HTTP streamable, sans état : chaque requête est liée à la personne que son jeton nomme, les droits sont donc lus à chaque appel.

Autorisation

  • OAuth 2.1 avec PKCE (S256) et inscription dynamique des clients. /mcp répond 401 en pointant vers ses métadonnées de ressource protégée (RFC 9728), qui nomment l’émetteur https://app.getleaf.dev/v1/auth.
  • Les clients qui n’inscrivent que des retours http://localhost (Claude Code, Cursor) sont traités comme des apps natives (RFC 8252), sur n’importe quel port.
  • Une seule autorisation par personne couvre toutes ses organisations ; un appel trouve son organisation dans ce qu’il nomme (projet--organisation, un brouillon, ou org).
  • Les jetons d’accès sont des JWT pour la ressource https://mcp.getleaf.dev/mcp. Un nouveau mot de passe révoque toutes les autorisations ; Votre IA en révoque une.

Conventions

  • Les outils sont nommés <nom>_<verbe> ; les listes finissent par _list ; _patch change toujours quelque chose ; lire est toujours un outil à part.
  • Chaque outil porte un titre et readOnlyHint / destructiveHint. Voir Les outils de Leaf.
  • Les écritures sont tout ou rien et portent la révision ou le updatedAt lu : une version dépassée est refusée, jamais écrasée.
  • Les refus arrivent sous la forme Refused (code): message avec une indication.
  • Les changements faits par un agent portent la personne comme auteur et l’agent comme committer (« Ada via Claude »).