Aussi en: English, Español, Português, 日本語, Deutsch, 한국어, 简体中文, Italiano, हिन्दी · Tous les guides en français
Transparence : nous développons Carbon Forge chez 100monkeys.ai ; lisez donc ceci comme le récit du fabricant. Ce guide a été rédigé par l'un de nos agents d'IA à partir de la documentation publique sur carbonforge.dev/docs (en anglais) et relu par l'entreprise ; cette version française est une traduction du guide original en anglais. Les étapes Carbon Forge citent la documentation ; la commande Claude Code vient de l'aide de Claude Code lui-même, claude mcp add --help. Là où la documentation laisse une question ouverte, la dernière section le dit.
Pourquoi les relier
Un agent de code oublie d'une session à l'autre, sauf si ses notes vivent dans un endroit qu'il peut relire. Carbon Forge est cet endroit, partagé avec les personnes du projet. La documentation qualifie MCP de "a primary product surface, co-equal with the human editor, against the same atoms, pages, links, and embeddings" (une surface principale du produit, à égalité avec l'éditeur humain ; A shared cortex for LLMs). La page d'un agent est une page qu'une personne peut ouvrir, corriger et lier.
Étape 1. Essayer le point d'accès en lecture seule sans jeton
Avant de vous inscrire, connectez-vous au contenu public. D'après Reading a public cortex without an account : "Add the instance's MCP endpoint to your client with no Authorization header. For this instance that is https://carbonforge.dev/api/mcp over Streamable HTTP. With Claude Code:" (ajoutez le point d'accès MCP de l'instance à votre client sans en-tête Authorization ; avec Claude Code :)
claude mcp add --transport http cortex-public https://carbonforge.dev/api/mcpVous obtenez vingt-deux outils en lecture seule, avec une limite de débit par adresse IP. Demandez à Claude Code de lire la page home de l'espace de travail docs ; sans jeton, il n'y a pas d'espace de travail courant, donc chaque appel indique workspace. Retirez cette entrée avec claude mcp remove cortex-public avant d'ajouter l'entrée authentifiée, pour que l'agent ne lise pas deux surfaces.
Étape 2. Se connecter et choisir l'espace de travail
Connectez-vous sur carbonforge.dev/login avec un lien par e-mail ou le bouton 100monkeys ; il n'y a pas de mot de passe. Les espaces de travail publics sont gratuits, et chaque compte inclut un espace de travail privé gratuit (tarifs). Choisissez l'espace de travail que l'agent utilisera comme mémoire. Un espace privé réserve les notes aux membres.
Étape 3. Créer un jeton à la portée la plus étroite possible
D'après MCP tokens : ouvrez les réglages et choisissez API tokens ; sélectionnez l'espace de travail et un rôle maximal (viewer, editor ou admin) ; choisissez une portée d'outils ; nommez le jeton d'après l'agent ; copiez le secret, qui "is shown once, then only the prefix" (est affiché une fois, puis seulement son préfixe).
Pour une mémoire partagée, Basic LLM memory permet à l'agent de "read and write pages, atoms and tags, and run search, with basic graph reads" (lire et écrire des pages, des atomes et des tags, et lancer des recherches), ce que la documentation appelle "the minimum for an LLM that uses Carbon Forge as its memory" (le minimum pour un LLM qui utilise Carbon Forge comme mémoire). Pour un agent qui ne fait que se souvenir, Read-only memory n'écrit rien. Pour le travail sur le code, SCM agent ajoute les lanes, les arbres et l'intégration (MCP token scopes). Un outil hors de la portée "answers exactly as a tool that does not exist" (répond exactement comme un outil qui n'existe pas).
Étape 4. Ajouter le serveur à Claude Code avec le jeton
La documentation dit de pointer le client vers le point d'accès "with the token in the Authorization header" (avec le jeton dans l'en-tête Authorization). Claude Code définit les en-têtes avec --header :
claude mcp add --transport http carbon-forge https://carbonforge.dev/api/mcp \
--header "Authorization: Bearer ‹your token›"Si vous placez le jeton dans une variable d'environnement et écrivez $CARBON_FORGE_TOKEN à la place, votre shell la développe avant que Claude Code ne la voie ; le secret est donc tout de même stocké dans la configuration de Claude Code. Traitez cette configuration comme un secret dans les deux cas, et gardez le serveur dans la portée par défaut local ou dans la portée user, plutôt que dans un fichier que vous committez.
Étape 5. Laisser l'agent s'orienter
Démarrez une session et demandez à Claude Code d'appeler cortex.ground. La documentation en fait le premier appel : il "Returns the per-instance README, the calling identity, what the bearer can do, what is reachable, and helper-service health" (renvoie le README de l'instance, l'identité appelante, ce que le porteur peut faire, ce qui est accessible et l'état des services auxiliaires ; cortex.ground). L'appel brut est :
{ "jsonrpc": "2.0", "id": 1,
"method": "tools/call",
"params": { "name": "cortex.ground" } }Le serveur fournit aussi ces mêmes informations lors du handshake initialize et au premier appel d'outil d'une session ; un agent qui saute cette étape est donc quand même orienté. Lisez le bloc capabilities pour confirmer que le jeton peut écrire.
Étape 6. Écrire en mémoire, puis la citer
Demandez à l'agent de consigner ce qu'il a appris sous forme de page, par exemple une décision et sa raison, et de lire cette page au début de la session suivante. Deux propriétés font de cela une mémoire et non un cache. Chaque enregistrement écrit une nouvelle version et rien ne réécrit une version passée, donc vous pouvez lire ce que l'agent a écrit la semaine dernière. Et "every entity-returning tool decorates the result with a clickable permalink so an LLM can hand a working URL back to its human" (chaque outil qui renvoie une entité ajoute un permalien cliquable au résultat ; How MCP works) : demandez à l'agent de citer le permalien de chaque page sur laquelle il s'est appuyé, et vérifiez-les.
Le code vit dans le même registre. Un agent ouvre une lane au lieu de cloner, et une intégration est un seul changeset, écrit en une transaction ou pas du tout (Working in lanes).
Étape 7. Surveiller le journal d'audit et révoquer à la fin
"Every tool call lands in the audit log under the token identity." (Chaque appel d'outil arrive dans le journal d'audit sous l'identité du jeton.) Quand l'agent n'a plus besoin d'accès, ou si le jeton a fuité, révoquez-le dans les réglages ; "in-flight calls fail on the next request" (les appels en cours échouent à la requête suivante ; MCP tokens).
Ce que la documentation laisse sans réponse
- Le point d'accès d'une instance sur son propre hôte. La page d'accès anonyme nomme
https://carbonforge.dev/api/mcp"for this instance" ; elle ne dit pas quelle URL utiliser pour une instance sur son propre sous-domaine ou un domaine personnalisé. - Deux chemins. La même page utilise
/api/mcp; l'exemple curl de How MCP works envoie vers/mcp. Nous utilisons/api/mcp. - La durée de vie d'un jeton. La documentation décrit la révocation d'un jeton, mais ne dit pas s'il expire de lui-même.
- La configuration propre à chaque client. La documentation ne donne pas de commande Claude Code ; celle ci-dessus est la syntaxe documentée de Claude Code pour un en-tête.