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 (en anglais), surtout Reading a public cortex without an account (R#64944) et MCP tokens (R#61824), puis relu par l'entreprise ; cette version française est une traduction du guide original en anglais. La commande, l'appel d'exemple et les phrases citées viennent de la documentation ; rien n'a été exécuté pour ce guide. Les citations restent en anglais, avec leur traduction à côté. Là où la documentation laisse une question ouverte, la dernière section le dit.
Pourquoi lire sans compte
Les workspaces publics de Carbon Forge sont lus par des personnes dans un navigateur et par des agents via MCP, à travers le même serveur. La surface anonyme permet à un agent d'utiliser une base de connaissances publique, comme la documentation de Carbon Forge elle-même, avant que quiconque se soit inscrit ou ait créé une clé. La documentation tient la règle en une ligne : un client sans jeton "can read what a browser visitor can read." (peut lire ce que peut lire un visiteur dans un navigateur.)
Étape 1. Trouver le point d'accès
Chaque instance publique sert MCP en Streamable HTTP. Pour carbonforge.dev, le point d'accès est https://carbonforge.dev/api/mcp. La lecture anonyme n'existe que sur une instance dont l'interrupteur public est activé ; une instance dont l'interrupteur est désactivé "asks you to sign in, exactly as it always has." (vous demande de vous connecter, exactement comme toujours.)
Étape 2. Se connecter sans en-tête Authorization
Ajoutez le point d'accès à votre client et n'envoyez aucun en-tête Authorization. La commande de la documentation pour Claude Code :
claude mcp add --transport http cortex-public https://carbonforge.dev/api/mcpTout client qui parle Streamable HTTP prend la même URL. N'envoyez aucun en-tête plutôt qu'un en-tête vide ou ancien : "A wrong, expired or revoked token is refused outright rather than quietly treated as anonymous, so a client can never be reading less than it thinks it is." (Un jeton erroné, expiré ou révoqué est refusé d'emblée au lieu d'être traité en silence comme anonyme, si bien qu'un client ne lit jamais moins qu'il ne le croit.)
Étape 3. Commencer par l'ancrage
La poignée de main initialize répond avec le document d'ancrage de l'instance, ses workspaces publics et les outils que vous pouvez appeler. "No session id is issued; you do not need one." (Aucun identifiant de session n'est émis ; vous n'en avez pas besoin.) Appelez cortex.ground pour vous orienter : c'est l'un des outils qui vous sont ouverts, et les workspaces qu'il liste sont ceux que vous pourrez nommer à l'étape suivante.
Étape 4. Nommer le workspace à chaque appel
Un jeton porte un pointeur vers le workspace courant. Sans jeton, il n'y a pas de pointeur : chaque appel qui agit dans un workspace passe donc workspace, par slug ou UUID. L'exemple de la documentation lit la page d'accueil de la documentation :
{ "name": "pages.read", "arguments": { "workspace": "docs", "pathOrId": "home" } }Si vous omettez workspace, l'appel vous demande de le fournir. Pour lire une autre instance publique, ajoutez instance avec son slug.
Étape 5. Lire, chercher et suivre les liens
La documentation compte vingt-deux outils en lecture seule. Parmi eux : lister et résoudre les workspaces publics, lister et lire les pages et les atomes, chercher en mode hybride et par sous-chaîne exacte, parcourir et interroger le catalogue de découverte, suivre les liens croisés et les voisins sémantiques, lire les fils de commentaires et les métadonnées des médias, et files.list et trees.get pour le code. Deux d'entre eux se comportent autrement que les autres : les deux outils de recherche "search across every public instance whatever you pass" (cherchent dans toutes les instances publiques, quoi que vous passiez), et l'enveloppe du résultat le précise. Pour rester dans un workspace, lisez et listez plutôt que de chercher.
Étape 6. Lire l'historique d'une page
L'historique des révisions et les diffs font partie des lectures anonymes. Un agent qui cite une page publique peut donc nommer la révision qu'il a lue et vérifier plus tard ce qui a changé depuis, sans compte. C'est le même registre que voit un éditeur connecté, limité au contenu public.
Étape 7. Ralentir à la limite
Les requêtes anonymes sont limitées par adresse IP. À la limite, la réponse est un 429 avec un en-tête Retry-After et un message qui indique combien de secondes attendre, demande de ralentir et renvoie vers l'inscription. Respectez Retry-After dans le client au lieu de réessayer aussitôt.
Étape 8. Savoir quand il faut un jeton
"Everything else answers as though it did not exist." (Tout le reste répond comme s'il n'existait pas.) Une page privée, un workspace privé et une page inexistante répondent tous "not found" (introuvable), comme dans le navigateur, si bien qu'un client anonyme ne peut pas apprendre ce qu'on ne lui montre pas. Un jeton est ce qu'il vous faut "to write, to read private content, or to lift the anonymous limit" (pour écrire, lire du contenu privé ou lever la limite anonyme) ; il a sa propre limite de débit, distincte. Chaque compte comprend un workspace privé gratuit et les workspaces publics sont gratuits (voir les tarifs). La page MCP tokens parcourt le formulaire de jeton : workspace, plafond de rôle, périmètre d'outils, un nom, et un secret affiché une seule fois.
Pour donner à Claude Code un jeton au périmètre étroit et écrire une mémoire dans votre propre workspace, lisez notre guide Connecter Claude Code à Carbon Forge par MCP.
Ce que la documentation laisse sans réponse
- La limite de débit elle-même. La documentation dit que les requêtes sont limitées par adresse IP et décrit le 429, mais ne donne ni chiffre ni fenêtre.
- La liste des vingt-deux outils par leur nom. La page les décrit par groupe et ne nomme que
cortex.ground,files.listettrees.get. - Comment configurer un client qui n'est pas Claude Code. Seule la commande pour Claude Code est donnée.
- Si la lecture anonyme voit une lane, un cut ou un changeset. La page cite les arbres de code et les fichiers, mais ne mentionne ni lanes, ni cuts, ni changesets.