También en: English, Português, 日本語, Deutsch, Français, 한국어, 简体中文, Italiano, हिन्दी · Todas las guías en español
Aviso: construimos Carbon Forge en 100monkeys.ai, así que lee esto como el relato de quien lo fabrica. Esta guía la redactó uno de nuestros agentes de IA a partir de la documentación pública, sobre todo Reading a public cortex without an account (R#64944) y MCP tokens (R#61824), y la revisó la empresa; esta versión en español es una traducción de la guía original en inglés. El comando, la llamada de ejemplo y las frases citadas son de la documentación, y las citas van en inglés con la traducción al lado; nada se ejecutó para esta guía. Donde la documentación deja una pregunta abierta, la última sección lo dice.
Por qué leer sin cuenta
Los espacios de trabajo públicos de Carbon Forge los leen personas en un navegador y agentes por MCP a través del mismo servidor. La superficie anónima deja que un agente use una base de conocimiento pública, como la propia documentación de Carbon Forge, antes de que nadie se haya registrado o haya creado una clave. La documentación lo resume en una línea: un cliente sin token "can read what a browser visitor can read." (puede leer lo que puede leer un visitante en el navegador).
Paso 1. Encuentra el endpoint
Cada instancia pública sirve MCP por Streamable HTTP. Para carbonforge.dev el endpoint es https://carbonforge.dev/api/mcp. Las lecturas anónimas solo existen en una instancia con el interruptor público activado; una con el interruptor apagado "asks you to sign in, exactly as it always has." (te pide iniciar sesión, exactamente como siempre).
Paso 2. Conéctate sin cabecera Authorization
Añade el endpoint a tu cliente y no envíes cabecera Authorization. El comando de la documentación para Claude Code:
claude mcp add --transport http cortex-public https://carbonforge.dev/api/mcpCualquier cliente que hable Streamable HTTP acepta la misma URL. No envíes ninguna cabecera, en lugar de una vacía o antigua: "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 token erróneo, caducado o revocado se rechaza sin más en lugar de tratarse en silencio como anónimo, así que un cliente nunca puede estar leyendo menos de lo que cree).
Paso 3. Oriéntate primero
El handshake initialize responde con el documento de orientación de la instancia, sus espacios públicos y las herramientas que puedes llamar. "No session id is issued; you do not need one." (No se emite id de sesión; no lo necesitas). Llama a cortex.ground para orientarte: es una de las herramientas abiertas para ti, y los espacios que enumera son los que puedes nombrar en el paso siguiente.
Paso 4. Nombra el espacio de trabajo en cada llamada
Un token lleva un puntero al espacio de trabajo actual. Sin token no hay puntero, así que cada llamada que actúa dentro de un espacio pasa workspace, por slug o UUID. El ejemplo de la documentación lee la página de inicio de la documentación:
{ "name": "pages.read", "arguments": { "workspace": "docs", "pathOrId": "home" } }Si omites workspace, la llamada te pide que lo indiques. Para leer otra instancia pública, añade instance con su slug.
Paso 5. Lee, busca y sigue enlaces
La documentación cuenta veintidós herramientas de solo lectura. Entre ellas: enumerar y resolver espacios públicos, enumerar y leer páginas y átomos, buscar por coincidencia híbrida y por subcadena exacta, recorrer y buscar en el catálogo de descubrimiento, seguir enlaces cruzados y vecinos semánticos, leer hilos de comentarios y metadatos de medios, y files.list y trees.get para el código. Dos de ellas se comportan distinto del resto: las dos herramientas de búsqueda "search across every public instance whatever you pass" (buscan en todas las instancias públicas pases lo que pases), y el sobre del resultado lo indica. Para quedarte dentro de un espacio, lee y enumera en lugar de buscar.
Paso 6. Lee el historial de una página
El historial de revisiones y los diffs están entre las lecturas anónimas. Un agente que cita una página pública puede, por tanto, nombrar la revisión que leyó y comprobar más tarde qué cambió desde entonces, sin cuenta. Es el mismo registro que ve un editor con sesión iniciada, limitado al contenido público.
Paso 7. Frena al llegar al límite
Las peticiones anónimas tienen un límite por dirección IP. Al llegar a él, la respuesta es un 429 con una cabecera Retry-After y un mensaje que dice cuántos segundos esperar, pide que vayas más despacio y apunta al registro. Respeta Retry-After en el cliente en lugar de reintentar al instante.
Paso 8. Sabe cuándo necesitas un token
"Everything else answers as though it did not exist." (Todo lo demás responde como si no existiera). Una página privada, un espacio privado y una página que no existe responden igual, "not found", como en el navegador, así que un cliente anónimo no puede saber lo que no se le muestra. Un token es lo que necesitas "to write, to read private content, or to lift the anonymous limit" (para escribir, para leer contenido privado o para superar el límite anónimo); tiene su propio límite, aparte. Toda cuenta incluye un espacio de trabajo privado gratis y los espacios públicos son gratis (consulta los precios). La página MCP tokens recorre el formulario del token: espacio de trabajo, rol máximo, alcance de herramientas, un nombre y un secreto que se muestra una vez.
Para dar a Claude Code un token de alcance estrecho y escribir memoria en tu propio espacio, lee nuestra guía Conecta Claude Code a Carbon Forge por MCP.
Lo que la documentación deja sin responder
- El límite en sí. La documentación dice que las peticiones se limitan por dirección IP y describe el 429, pero no da cifra ni ventana de tiempo.
- La lista de las veintidós herramientas por nombre. La página las describe por grupos y solo nombra
cortex.ground,files.listytrees.get. - Cómo se configura un cliente que no sea Claude Code. Solo se da el comando de Claude Code.
- Si las lecturas anónimas pueden ver una lane, un corte o un changeset. La página enumera árboles de código y archivos, pero no menciona lanes, cortes ni changesets.