Configuration Claude Desktop

Cette page concerne Claude Desktop en configuration locale, c'est-à-dire l'édition manuelle du fichier claude_desktop_config.json.

Si vous utilisez claude.ai (web ou application de bureau) avec les connecteurs, ne suivez pas cette page : passez par OAuth, c'est plus simple et plus sûr. Voir « Les deux modes de connexion » et « Problème connexion spécifique à Claude ».

Avant de commencer

Récupérez votre token sur le tableau de bord. C'est un secret permanent : traitez-le comme un mot de passe.

Configuration recommandée

Elle transmet le token dans l'en-tête HTTP, où il n'apparaît ni dans les journaux d'URL ni dans votre historique de commandes.

{
  "mcpServers": {
    "OpenLegi": {
      "type": "streamable-http",
      "url": "https://mcp.openlegi.fr/legifrance/mcp",
      "headers": {
        "Authorization": "Bearer VOTRE_TOKEN"
      }
    }
  }
}

Repli pour les versions plus anciennes

Si votre version de Claude Desktop ne gère pas streamable-http, passez par mcp-remote, qui fait le pont :

{
  "mcpServers": {
    "OpenLegi": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.openlegi.fr/legifrance/mcp",
        "--header",
        "Authorization: Bearer VOTRE_TOKEN"
      ]
    }
  }
}

Vous rencontrerez parfois une variante qui place le token directement dans l'URL (...?token=VOTRE_TOKEN). Elle fonctionne, mais évitez-la si vous le pouvez : le secret circule alors dans l'URL, susceptible d'être enregistré par des intermédiaires.

Cette configuration nécessite Node.js installé sur votre machine.

Où se trouve le fichier

Si le fichier n'existe pas, créez-le avec le contenu ci-dessus. S'il existe déjà et contient d'autres serveurs, ajoutez seulement l'entrée "OpenLegi" à l'intérieur de l'objet mcpServers existant — n'écrasez pas le fichier.

Redémarrez complètement Claude Desktop après modification : fermer la fenêtre ne suffit pas, quittez l'application.

Ajouter les autres services

Chaque service a son propre point d'accès. Ajoutez une entrée par service souhaité :

RNE et EUR-Lex sont accessibles sur abonnement — voir la page d'accueil pour en demander l'activation.

Vérifier que ça marche

Posez une question qui ne peut aboutir que par un appel d'outil, par exemple :

« Donne-moi l'article 1240 du Code civil. »

Claude doit indiquer qu'il utilise un outil OpenLegi et vous répondre avec un lien vers Légifrance. Si rien ne se passe, vérifiez dans l'ordre :

1. L'application a bien été quittée puis relancée.
2. Le JSON est valide — une virgule en trop suffit à faire ignorer tout le fichier.
3. Le token est correct : testez-le avec curl https://mcp.openlegi.fr/health (ce point d'accès ne demande pas d'authentification et confirme que le service répond).

La page « Dépannage — codes d'erreur » détaille les erreurs 400, 401 et 403.