# Connecter Claude Code à Nodary

Claude Code lit depuis le terminal la documentation que votre équipe garde dans Nodary, et y consigne décisions et notes, avec vos droits.

Vérifié d’après la documentation de chaque éditeur le 22 octobre 2026.

## Avant de commencer

- Claude Code, connecté avec un compte Pro, Max, Team, Enterprise ou Console, ou utilisé via un fournisseur cloud comme Amazon Bedrock. L’offre gratuite de claude.ai n’inclut pas Claude Code.
- Un compte Nodary. Le serveur MCP est inclus dans toutes les offres ; sur Free, tant que l’espace reste dans les limites de l’offre : 1 projet, 10 documents et dossiers, 2 membres. Claude Code ne dépense aucune Comète : il utilise son propre modèle.

Pas encore d’espace ? Créez-en un, puis revenez vous connecter. [Créer un espace gratuit](https://nodary.ai/sign-up)

## Ajouter Nodary

1. Lancez cette commande dans un terminal :

   ```
   claude mcp add --transport http nodary https://nodary.ai/api/mcp
   ```
2. Pour utiliser Nodary dans tous vos projets, ajoutez-le plutôt à votre portée utilisateur :

   ```
   claude mcp add --transport http --scope user nodary https://nodary.ai/api/mcp
   ```
3. Dans Claude Code, tapez /mcp, choisissez nodary et connectez-vous : la page de consentement de Nodary s’ouvre dans votre navigateur. Si elle ne s’ouvre pas, copiez l’adresse affichée par Claude Code, ou lancez :

   ```
   claude mcp login nodary
   ```

**Portées :** local, par défaut, réserve Nodary à vous dans ce projet ; user, à vous dans tous vos projets ; project écrit .mcp.json à la racine du projet pour que toute l’équipe le partage.

## Se connecter et choisir les espaces

La page de consentement de Nodary indique l’application qui demande l’accès et l’adresse vers laquelle elle sera renvoyée. Connectez-vous si ce n’est pas déjà fait, puis choisissez les espaces que Claude Code pourra atteindre : avec un seul espace, vous le sélectionnez ; avec plusieurs, aucun n’est coché d’avance, cochez donc chacun de ceux que Claude Code pourra utiliser. Si vous vous êtes connecté il y a plus de 10 minutes, Nodary vous redemande votre mot de passe. Approuvez, et le navigateur vous ramène à Claude Code.

Claude Code agit alors en votre nom : il voit et modifie seulement ce que votre rôle permet, dans les espaces cochés. Son accès dure 60 minutes à la fois et Claude Code le renouvelle seul.

## Utiliser Nodary depuis le terminal

Formulez votre demande simplement. Claude Code appelle les outils de Nodary quand votre demande en a besoin, et demande avant de les utiliser sauf si vous les avez autorisés. Quelques demandes pour commencer :

- Lis le document de conception de l’API dans Nodary et vérifie ce point d’accès par rapport à lui.
- Rédige un enregistrement de décision pour le passage à Postgres, range-le dans Architecture et relie-le à la spécification.
- Quels documents du projet Backend sont encore des brouillons, et qui en est responsable ?

## Avec une clé d’API à la place

Envoyez votre clé dans un en-tête :

```sh
claude mcp add --transport http nodary https://nodary.ai/api/mcp \
  --header "Authorization: Bearer gdc_..."
```

Pour partager le serveur dans .mcp.json sans partager de clé, lisez-la depuis une variable d’environnement : Claude Code remplace ${NODARY_API_KEY} dans les en-têtes d’un serveur.

```json
{
  "mcpServers": {
    "nodary": {
      "type": "http",
      "url": "https://nodary.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${NODARY_API_KEY}"
      }
    }
  }
}
```

Créez la clé dans Nodary, sous « Profil », « Clés d’API et MCP ». Elle commence par gdc_, ne s’affiche qu’une fois, agit avec vos droits, peut être limitée à un projet et expire après 30, 90 ou 365 jours, ou jamais, selon votre choix.

## Si quelque chose ne fonctionne pas

- claude mcp add ne vérifie pas une clé : une clé erronée apparaît comme un serveur en échec dans /mcp.
- Pour vous reconnecter, choisissez « Clear authentication » dans le menu /mcp, ou lancez claude mcp logout nodary, puis reconnectez-vous.
- Un long document revient tronqué : Claude Code avertit au-delà de 10 000 tokens de sortie d’outil et s’arrête à 25 000 par défaut. Relevez la limite avec la variable d’environnement MAX_MCP_OUTPUT_TOKENS, ou demandez une seule section.
- La connexion n’aboutit pas : connectez-vous plutôt avec une clé d’API, comme ci-dessus.
- Une première requête qui reçoit une réponse 401 est normale : elle indique au client où se connecter.
- quota_locked : l’espace dépasse l’offre Free après son essai et reste bloqué jusqu’à ce que le propriétaire s’abonne. Tout refonctionne dès l’abonnement.
- billing_locked : un paiement a échoué, l’espace reste donc bloqué jusqu’à ce que le propriétaire le règle dans la facturation de l’espace. Tout refonctionne dès que le paiement passe.
- workspace_suspended : Nodary a suspendu l’espace, plus rien ne l’atteint, agents compris. Le propriétaire peut écrire à support@nodary.ai.
- workspace_required : la connexion atteint plusieurs espaces, nommez donc celui où travailler, ou reconnectez-vous en ne cochant qu’un espace.

## Questions

### Connecter Claude Code coûte-t-il quelque chose ?

Pas du côté de Nodary. Le serveur MCP est inclus dans toutes les offres, Free compris dans ses limites, et Claude Code ne dépense aucune Comète : les Comètes ne comptent que Studio AI. Votre offre Claude Code décide si vous pouvez ajouter le serveur.

### Est-ce la même connexion que Claude sur le web ?

Elle peut l’être : quand vous vous connectez à Claude Code avec votre compte claude.ai, les connecteurs ajoutés sur claude.ai, Nodary compris, apparaissent dans Claude Code. Connecté avec une clé Console ou un fournisseur cloud, ajoutez Nodary avec la commande ci-dessus.

### L’équipe peut-elle partager la configuration ?

Oui : ajoutez Nodary avec --scope project et versionnez .mcp.json. Claude Code demande à chacun avant d’utiliser les serveurs d’un projet, et chacun se connecte avec son propre compte Nodary.

### Claude Code peut-il supprimer ou écraser mes documents ?

Seulement là où votre rôle le permet, et une modification peut être annulée : chaque session d’édition de dix minutes au plus forme une version, comme chaque écriture d’agent. Un document garde ses 50 versions les plus récentes faites par des personnes et ses 50 plus récentes faites par des agents (celles des agents ne chassent jamais celles des personnes), que vous comparez et restaurez, et un document supprimé revient pendant 30 jours. Les liens de partage, les accès, les membres, les rôles, les clés, la facturation et la suppression d’un projet restent des décisions humaines : aucun agent ne peut les prendre.

### Comment le déconnecter ?

Dans Nodary, ouvrez « Profil », « Sécurité », « Applications connectées » et déconnectez-le : il s’arrête aussitôt. Dans Claude Code, claude mcp remove nodary retire le serveur et la connexion qu’il avait enregistrée. Une clé se révoque sous « Profil », « Clés d’API et MCP », et les propriétaires et administrateurs peuvent révoquer toute clé de l’espace dans ses paramètres, rubrique MCP.

### Nodary utilise-t-il mes documents pour entraîner une IA ?

Non. Nodary n’utilise pas le contenu des espaces pour entraîner des modèles d’IA. Ce que Claude Code fait de ce qu’il lit relève des conditions de son éditeur.

## À lire ensuite

- [Connecter Claude à Nodary](https://nodary.ai/fr/docs/mcp/claude): Ajoutez Nodary à claude.ai et à Claude Desktop comme connecteur personnalisé, avec une connexion OAuth.
- [Connecter Cursor à Nodary](https://nodary.ai/fr/docs/mcp/cursor): Ajoutez Nodary au fichier mcp.json de Cursor, puis connectez-vous depuis Cursor.
- [Le serveur MCP de Nodary](https://nodary.ai/fr/docs/mcp): Le serveur, la connexion, les 98 outils, la sécurité et tous les clients en un coup d’œil.
- [Serveur MCP](https://nodary.ai/fr/glossary/mcp-server): Un serveur MCP est un programme qui offre des outils, des ressources et des invites aux applications d’IA via le Model Context Protocol.
- [Fenêtre de contexte](https://nodary.ai/fr/glossary/context-window): La fenêtre de contexte est la quantité de texte, comptée en tokens, qu’un modèle de langage prend en compte à la fois, instructions et documents compris.

https://nodary.ai/fr/docs/mcp/claude-code