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 en carbonforge.dev/docs (en inglés) y la revisó la empresa; esta versión en español es una traducción de la guía original en inglés. Los pasos de Carbon Forge citan la documentación; el comando de Claude Code sale de la ayuda del propio Claude Code, claude mcp add --help. Donde la documentación deja una pregunta abierta, la última sección lo dice.
Por qué conectarlos
Un agente de programación olvida entre sesiones a menos que sus notas vivan en un sitio que pueda volver a leer. Carbon Forge es ese sitio, compartido con las personas del proyecto. La documentación llama a MCP "a primary product surface, co-equal with the human editor, against the same atoms, pages, links, and embeddings" (una superficie principal del producto, al mismo nivel que el editor humano; A shared cortex for LLMs). La página de un agente es una página que una persona puede abrir, corregir y enlazar.
Paso 1. Prueba el endpoint de solo lectura sin token
Antes de registrarte, conéctate al contenido público. Según 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:" (añade el endpoint MCP de la instancia a tu cliente sin cabecera Authorization; con Claude Code:)
claude mcp add --transport http cortex-public https://carbonforge.dev/api/mcpObtienes veintidós herramientas de solo lectura, con límite de peticiones por dirección IP. Pide a Claude Code que lea la página home del espacio de trabajo docs; sin token no hay espacio de trabajo actual, así que cada llamada indica workspace. Quita esta entrada con claude mcp remove cortex-public antes de añadir la autenticada, para que el agente no lea dos superficies.
Paso 2. Inicia sesión y elige el espacio de trabajo
Inicia sesión en carbonforge.dev/login con un enlace por correo o con el botón de 100monkeys; no hay contraseñas. Los espacios de trabajo públicos son gratuitos y cada cuenta incluye un espacio de trabajo privado gratuito (precios). Decide qué espacio de trabajo usará el agente como memoria. Uno privado deja las notas solo para los miembros.
Paso 3. Crea un token con el alcance más estrecho que sirva
Según MCP tokens: abre la configuración y elige API tokens; escoge el espacio de trabajo y un rol máximo (viewer, editor o admin); elige un alcance de herramientas; ponle al token el nombre del agente; copia el secreto, que "is shown once, then only the prefix" (se muestra una vez y después solo el prefijo).
Para memoria compartida, Basic LLM memory permite al agente "read and write pages, atoms and tags, and run search, with basic graph reads" (leer y escribir páginas, átomos y etiquetas, y buscar), lo que la documentación llama "the minimum for an LLM that uses Carbon Forge as its memory" (el mínimo para un LLM que usa Carbon Forge como memoria). Para un agente que solo recuerda, Read-only memory no escribe nada. Para trabajo con código, SCM agent añade lanes, árboles e integración (MCP token scopes). Una herramienta fuera del alcance "answers exactly as a tool that does not exist" (responde exactamente como una herramienta que no existe).
Paso 4. Añade el servidor a Claude Code con el token
La documentación dice que apuntes el cliente al endpoint "with the token in the Authorization header" (con el token en la cabecera Authorization). Claude Code define cabeceras con --header:
claude mcp add --transport http carbon-forge https://carbonforge.dev/api/mcp \
--header "Authorization: Bearer ‹your token›"Si guardas el token en una variable de entorno y escribes $CARBON_FORGE_TOKEN en su lugar, tu shell la expande antes de que Claude Code la vea, así que el secreto queda igualmente guardado en la configuración de Claude Code. Trata esa configuración como un secreto en ambos casos y deja el servidor en el alcance local por defecto o en user, no en un archivo que subas al repositorio.
Paso 5. Deja que el agente se oriente
Inicia una sesión y pide a Claude Code que llame a cortex.ground. La documentación la pone como primera llamada: "Returns the per-instance README, the calling identity, what the bearer can do, what is reachable, and helper-service health" (devuelve el README de la instancia, la identidad que llama, lo que puede hacer el portador, lo que es accesible y el estado de los servicios auxiliares; cortex.ground). La llamada en bruto es:
{ "jsonrpc": "2.0", "id": 1,
"method": "tools/call",
"params": { "name": "cortex.ground" } }El servidor también entrega esa misma información en el handshake initialize y en la primera llamada a herramienta de una sesión, así que un agente que se salta este paso queda orientado igualmente. Lee el bloque capabilities para confirmar que el token puede escribir.
Paso 6. Escribe memoria y después cítala
Pide al agente que registre lo que aprendió como una página, por ejemplo una decisión y su motivo, y que lea esa página al empezar la siguiente sesión. Dos propiedades hacen de esto una memoria y no una caché. Cada guardado escribe una versión nueva y nada reescribe una anterior, así que puedes leer lo que el agente escribió la semana pasada. Y "every entity-returning tool decorates the result with a clickable permalink so an LLM can hand a working URL back to its human" (cada herramienta que devuelve una entidad añade un enlace permanente; How MCP works): pide al agente que cite el enlace permanente de cada página en la que se apoyó, y compruébalos.
El código también vive en el mismo registro. Un agente abre una lane en lugar de clonar, y una integración es un solo changeset, escrito en una transacción o no escrito en absoluto (Working in lanes).
Paso 7. Vigila el registro de auditoría y revoca al terminar
"Every tool call lands in the audit log under the token identity." (Cada llamada a herramienta queda en el registro de auditoría con la identidad del token). Cuando el agente ya no necesite acceso, o si el token se filtra, revócalo desde la configuración; "in-flight calls fail on the next request" (las llamadas en curso fallan en la siguiente petición; MCP tokens).
Lo que la documentación deja sin responder
- El endpoint para una instancia en su propio host. La página de acceso anónimo nombra
https://carbonforge.dev/api/mcp"for this instance"; no dice qué URL usar para una instancia en su propio subdominio o en un dominio propio. - Dos rutas. La misma página usa
/api/mcp; el ejemplo con curl de How MCP works envía a/mcp. Nosotros usamos/api/mcp. - La vida útil del token. La documentación describe cómo revocar un token, pero no dice si caduca por sí solo.
- Configuración por cliente. La documentación no da un comando para Claude Code; el de arriba es la sintaxis documentada de Claude Code para una cabecera.