Auch auf: English, Español, Português, 日本語, Français, 한국어, 简体中文, Italiano, हिन्दी · Alle Anleitungen auf Deutsch
Offenlegung: Wir entwickeln Carbon Forge bei 100monkeys.ai, lesen Sie dies also als Bericht des Herstellers. Einer unserer KI-Agenten hat diese Anleitung aus der öffentlichen Dokumentation unter carbonforge.dev/docs (auf Englisch) entworfen, das Unternehmen hat sie geprüft; diese deutsche Fassung ist eine Übersetzung der englischen Originalanleitung. Die Carbon-Forge-Schritte zitieren die Dokumentation; der Claude-Code-Befehl stammt aus der Hilfe von Claude Code selbst, claude mcp add --help. Wo die Dokumentation eine Frage offenlässt, sagt es der letzte Abschnitt.
Warum verbinden
Ein Coding-Agent vergisst zwischen Sitzungen, sofern seine Notizen nicht an einem Ort liegen, den er wieder lesen kann. Carbon Forge ist dieser Ort, geteilt mit den Menschen im Projekt. Die Dokumentation nennt MCP "a primary product surface, co-equal with the human editor, against the same atoms, pages, links, and embeddings" (eine primäre Produktoberfläche, gleichrangig mit dem menschlichen Editor; A shared cortex for LLMs). Die Seite eines Agenten ist eine Seite, die ein Mensch öffnen, korrigieren und verlinken kann.
Schritt 1. Den Nur-Lese-Endpunkt ohne Token ausprobieren
Bevor Sie sich registrieren, verbinden Sie sich mit öffentlichen Inhalten. Aus 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:" (Fügen Sie den MCP-Endpunkt der Instanz ohne Authorization-Header zu Ihrem Client hinzu; mit Claude Code:)
claude mcp add --transport http cortex-public https://carbonforge.dev/api/mcpSie erhalten zweiundzwanzig Nur-Lese-Tools, mit einem Ratenlimit pro IP-Adresse. Bitten Sie Claude Code, die Seite home im Workspace docs zu lesen; ohne Token gibt es keinen aktuellen Workspace, also nennt jeder Aufruf workspace. Entfernen Sie diesen Eintrag mit claude mcp remove cortex-public, bevor Sie den authentifizierten hinzufügen, damit der Agent nicht zwei Oberflächen liest.
Schritt 2. Anmelden und den Workspace wählen
Melden Sie sich unter carbonforge.dev/login mit einem E-Mail-Link oder dem 100monkeys-Knopf an; es gibt keine Passwörter. Öffentliche Workspaces sind kostenlos, und jedes Konto enthält einen kostenlosen privaten Workspace (Preise). Entscheiden Sie, welchen Workspace der Agent als Gedächtnis nutzt. Ein privater hält die Notizen bei den Mitgliedern.
Schritt 3. Ein Token mit dem engsten passenden Umfang erstellen
Aus MCP tokens: Öffnen Sie die Einstellungen und wählen Sie API tokens; wählen Sie den Workspace und eine Rollenobergrenze (viewer, editor oder admin); wählen Sie einen Tool-Umfang; benennen Sie das Token nach dem Agenten; kopieren Sie das Geheimnis, das "is shown once, then only the prefix" (einmal angezeigt wird, danach nur das Präfix).
Für gemeinsames Gedächtnis erlaubt Basic LLM memory dem Agenten "read and write pages, atoms and tags, and run search, with basic graph reads" (Seiten, Atome und Tags lesen und schreiben und suchen), was die Dokumentation "the minimum for an LLM that uses Carbon Forge as its memory" nennt (das Minimum für ein LLM, das Carbon Forge als Gedächtnis nutzt). Für einen Agenten, der sich nur erinnert, schreibt Read-only memory nichts. Für Arbeit an Code ergänzt SCM agent Lanes, Trees und Landings (MCP token scopes). Ein Tool außerhalb des Umfangs "answers exactly as a tool that does not exist" (antwortet genau wie ein Tool, das es nicht gibt).
Schritt 4. Den Server mit dem Token zu Claude Code hinzufügen
Die Dokumentation sagt, den Client auf den Endpunkt zu richten, "with the token in the Authorization header" (mit dem Token im Authorization-Header). Claude Code setzt Header mit --header:
claude mcp add --transport http carbon-forge https://carbonforge.dev/api/mcp \
--header "Authorization: Bearer ‹your token›"Legen Sie das Token in eine Umgebungsvariable und schreiben stattdessen $CARBON_FORGE_TOKEN, expandiert Ihre Shell sie, bevor Claude Code sie sieht; das Geheimnis landet also trotzdem in der Konfiguration von Claude Code. Behandeln Sie diese Konfiguration in beiden Fällen als Geheimnis und belassen Sie den Server im Standard-Scope local oder im Scope user, nicht in einer Datei, die Sie committen.
Schritt 5. Den Agenten sich orientieren lassen
Starten Sie eine Sitzung und bitten Sie Claude Code, cortex.ground aufzurufen. Die Dokumentation macht es zum ersten Aufruf: Er "Returns the per-instance README, the calling identity, what the bearer can do, what is reachable, and helper-service health" (liefert das README der Instanz, die aufrufende Identität, was der Inhaber darf, was erreichbar ist und den Zustand der Hilfsdienste; cortex.ground). Der rohe Aufruf lautet:
{ "jsonrpc": "2.0", "id": 1,
"method": "tools/call",
"params": { "name": "cortex.ground" } }Der Server liefert dieselben Angaben auch beim Handshake initialize und beim ersten Tool-Aufruf einer Sitzung, sodass ein Agent, der diesen Schritt auslässt, trotzdem orientiert ist. Lesen Sie den Block capabilities, um zu bestätigen, dass das Token schreiben darf.
Schritt 6. Gedächtnis schreiben und dann zitieren
Bitten Sie den Agenten, das Gelernte als Seite festzuhalten, etwa eine Entscheidung und ihren Grund, und diese Seite zu Beginn der nächsten Sitzung zu lesen. Zwei Eigenschaften machen daraus ein Gedächtnis statt eines Caches. Jedes Speichern schreibt eine neue Version, und nichts überschreibt eine alte, sodass Sie lesen können, was der Agent letzte Woche geschrieben hat. Und "every entity-returning tool decorates the result with a clickable permalink so an LLM can hand a working URL back to its human" (jedes Tool, das eine Entität liefert, versieht das Ergebnis mit einem klickbaren Permalink; How MCP works): Bitten Sie den Agenten, den Permalink jeder Seite zu zitieren, auf die er sich stützt, und prüfen Sie sie.
Auch Code liegt im selben Datensatz. Ein Agent öffnet eine Lane, statt zu klonen, und eine Landung ist ein einziges Changeset, in einer Transaktion geschrieben oder gar nicht (Working in lanes).
Schritt 7. Das Audit-Log beobachten und am Ende widerrufen
"Every tool call lands in the audit log under the token identity." (Jeder Tool-Aufruf landet im Audit-Log unter der Identität des Tokens.) Braucht der Agent keinen Zugriff mehr oder ist das Token durchgesickert, widerrufen Sie es in den Einstellungen; "in-flight calls fail on the next request" (laufende Aufrufe scheitern bei der nächsten Anfrage; MCP tokens).
Was die Dokumentation offenlässt
- Den Endpunkt für eine Instanz auf eigenem Host. Die Seite zum anonymen Zugriff nennt
https://carbonforge.dev/api/mcp"for this instance"; sie sagt nicht, welche URL für eine Instanz auf eigener Subdomain oder eigener Domain gilt. - Zwei Pfade. Dieselbe Seite nutzt
/api/mcp; das curl-Beispiel auf How MCP works sendet an/mcp. Wir nutzen/api/mcp. - Die Lebensdauer eines Tokens. Die Dokumentation beschreibt den Widerruf, sagt aber nicht, ob ein Token von selbst abläuft.
- Client-spezifische Konfiguration. Die Dokumentation gibt keinen Claude-Code-Befehl an; der obige ist die dokumentierte Syntax von Claude Code für einen Header.