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 (auf Englisch) entworfen, vor allem Reading a public cortex without an account (R#64944) und MCP tokens (R#61824), und das Unternehmen hat sie geprüft; diese deutsche Fassung ist eine Übersetzung der englischen Originalanleitung. Der Befehl, der Beispielaufruf und die zitierten Sätze stammen aus der Dokumentation; für diese Anleitung wurde nichts davon ausgeführt. Zitate bleiben auf Englisch, mit der Übersetzung daneben. Wo die Dokumentation eine Frage offen lässt, sagt es der letzte Abschnitt.
Warum ohne Konto lesen
Öffentliche Workspaces auf Carbon Forge werden von Menschen im Browser und von Agenten über MCP gelesen, über denselben Server. Die anonyme Oberfläche lässt einen Agenten eine öffentliche Wissensbasis nutzen, etwa die Carbon-Forge-Dokumentation selbst, bevor sich jemand angemeldet oder einen Schlüssel erzeugt hat. Die Dokumentation fasst die Regel in eine Zeile: Ein Client ohne Token "can read what a browser visitor can read." (kann lesen, was ein Besucher im Browser lesen kann.)
Schritt 1. Den Endpunkt finden
Jede öffentliche Instanz bietet MCP über Streamable HTTP an. Für carbonforge.dev ist der Endpunkt https://carbonforge.dev/api/mcp. Anonymes Lesen gibt es nur auf einer Instanz, deren öffentlicher Schalter an ist; eine mit ausgeschaltetem Schalter "asks you to sign in, exactly as it always has." (bittet Sie, sich anzumelden, genau wie immer.)
Schritt 2. Ohne Authorization-Header verbinden
Fügen Sie den Endpunkt Ihrem Client hinzu und senden Sie keinen Authorization-Header. Der Befehl der Dokumentation für Claude Code:
claude mcp add --transport http cortex-public https://carbonforge.dev/api/mcp Jeder Client, der Streamable HTTP spricht, nimmt dieselbe URL. Senden Sie gar keinen Header statt eines leeren oder alten: "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." (Ein falsches, abgelaufenes oder widerrufenes Token wird sofort abgelehnt, statt still als anonym behandelt zu werden, sodass ein Client nie weniger liest, als er glaubt.)
Schritt 3. Zuerst grounden
Der Handshake initialize antwortet mit dem Grounding-Dokument der Instanz, ihren öffentlichen Workspaces und den Werkzeugen, die Sie aufrufen dürfen. "No session id is issued; you do not need one." (Es wird keine Sitzungs-ID ausgegeben; Sie brauchen keine.) Rufen Sie cortex.ground auf, um sich zu orientieren: Es ist eines der Werkzeuge, die Ihnen offenstehen, und die Workspaces, die es auflistet, können Sie im nächsten Schritt nennen.
Schritt 4. Den Workspace bei jedem Aufruf nennen
Ein Token trägt einen Zeiger auf den aktuellen Workspace. Ohne Token gibt es keinen Zeiger, also übergibt jeder Aufruf, der in einem Workspace wirkt, workspace, als Slug oder UUID. Das Beispiel der Dokumentation liest die Startseite der Dokumentation:
{ "name": "pages.read", "arguments": { "workspace": "docs", "pathOrId": "home" } } Lassen Sie workspace weg, sagt Ihnen der Aufruf, dass Sie ihn angeben müssen. Um eine andere öffentliche Instanz zu lesen, fügen Sie instance mit ihrem Slug hinzu.
Schritt 5. Lesen, suchen und Links folgen
Die Dokumentation zählt zweiundzwanzig Werkzeuge, die nur lesen. Darunter: öffentliche Workspaces auflisten und auflösen, Seiten und Atome auflisten und lesen, hybrid und nach exakter Teilzeichenkette suchen, den Discovery-Katalog durchsehen und durchsuchen, Querverweisen und semantischen Nachbarn folgen, Kommentar-Threads und Medien-Metadaten lesen, und files.list und trees.get für Code. Zwei davon verhalten sich anders als die übrigen: Die beiden Suchwerkzeuge "search across every public instance whatever you pass" (durchsuchen jede öffentliche Instanz, was immer Sie übergeben), und die Hülle des Ergebnisses sagt das. Um in einem Workspace zu bleiben, lesen und listen Sie, statt zu suchen.
Schritt 6. Die Geschichte einer Seite lesen
Revisionsgeschichte und Diffs gehören zu den anonymen Lesezugriffen. Ein Agent, der eine öffentliche Seite zitiert, kann also die gelesene Revision nennen und später prüfen, was sich seitdem geändert hat, ohne Konto. Es ist derselbe Datensatz, den ein angemeldeter Bearbeiter sieht, beschränkt auf öffentliche Inhalte.
Schritt 7. An der Grenze langsamer werden
Anonyme Anfragen sind pro IP-Adresse begrenzt. An der Grenze lautet die Antwort 429 mit einem Header Retry-After und einer Meldung, die sagt, wie viele Sekunden zu warten sind, um langsameres Vorgehen bittet und auf die Anmeldung verweist. Beachten Sie Retry-After im Client, statt sofort zu wiederholen.
Schritt 8. Wissen, wann Sie ein Token brauchen
"Everything else answers as though it did not exist." (Alles andere antwortet, als gäbe es es nicht.) Eine private Seite, ein privater Workspace und eine Seite, die nicht existiert, antworten alle mit "not found" (nicht gefunden), wie im Browser, sodass ein anonymer Client nicht erfahren kann, was ihm nicht gezeigt wird. Ein Token brauchen Sie, "to write, to read private content, or to lift the anonymous limit" (um zu schreiben, private Inhalte zu lesen oder die anonyme Grenze aufzuheben); es hat eine eigene, getrennte Ratenbegrenzung. Jedes Konto enthält einen kostenlosen privaten Workspace, und öffentliche Workspaces sind kostenlos (siehe Preise). Die Seite MCP tokens geht das Token-Formular durch: Workspace, Rollengrenze, Werkzeugbereich, ein Name und ein Secret, das einmal angezeigt wird.
Um Claude Code ein Token mit engem Bereich zu geben und Gedächtnis in Ihren eigenen Workspace zu schreiben, lesen Sie unsere Anleitung Claude Code per MCP mit Carbon Forge verbinden.
Was die Dokumentation offen lässt
- Die Ratenbegrenzung selbst. Die Dokumentation sagt, dass Anfragen pro IP-Adresse begrenzt sind, und beschreibt die 429, nennt aber weder Zahl noch Zeitfenster.
- Die Liste der zweiundzwanzig Werkzeuge mit Namen. Die Seite beschreibt sie nach Gruppen und nennt nur
cortex.ground,files.listundtrees.get. - Wie ein Client, der nicht Claude Code ist, eingerichtet wird. Nur der Befehl für Claude Code ist angegeben.
- Ob anonyme Lesezugriffe eine Lane, einen Cut oder ein Changeset sehen können. Die Seite nennt Code-Bäume und Dateien, erwähnt aber keine Lanes, Cuts oder Changesets.