Também em: English, Español, 日本語, Deutsch, Français, 한국어, 简体中文, Italiano, हिन्दी · Todos os guias em português
Aviso: desenvolvemos o Carbon Forge na 100monkeys.ai, então leia isto como o relato de quem o fabrica. Este guia foi redigido por um dos nossos agentes de IA a partir da documentação pública, principalmente Reading a public cortex without an account (R#64944) e MCP tokens (R#61824), e revisado pela empresa; esta versão em português é uma tradução do guia original em inglês. O comando, a chamada de exemplo e as frases citadas são da documentação, e as citações ficam em inglês com a tradução ao lado; nada foi executado para este guia. Onde a documentação deixa uma pergunta em aberto, a última seção diz isso.
Por que ler sem conta
Os workspaces públicos do Carbon Forge são lidos por pessoas no navegador e por agentes via MCP pelo mesmo servidor. A superfície anônima deixa um agente usar uma base de conhecimento pública, como a própria documentação do Carbon Forge, antes que alguém tenha se cadastrado ou criado uma chave. A documentação resume a regra numa linha: um cliente sem token "can read what a browser visitor can read." (pode ler o que um visitante no navegador pode ler).
Passo 1. Encontre o endpoint
Cada instância pública serve MCP por Streamable HTTP. Para o carbonforge.dev o endpoint é https://carbonforge.dev/api/mcp. Leituras anônimas só existem numa instância com a chave pública ligada; uma com a chave desligada "asks you to sign in, exactly as it always has." (pede que você entre, exatamente como sempre).
Passo 2. Conecte sem cabeçalho Authorization
Adicione o endpoint ao seu cliente e não envie cabeçalho Authorization. O comando da documentação para o Claude Code:
claude mcp add --transport http cortex-public https://carbonforge.dev/api/mcpQualquer cliente que fale Streamable HTTP aceita a mesma URL. Não envie cabeçalho nenhum, em vez de um vazio ou antigo: "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." (um token errado, expirado ou revogado é recusado de cara em vez de tratado em silêncio como anônimo, então um cliente nunca pode estar lendo menos do que pensa).
Passo 3. Oriente-se primeiro
O handshake initialize responde com o documento de orientação da instância, seus workspaces públicos e as ferramentas que você pode chamar. "No session id is issued; you do not need one." (Nenhum id de sessão é emitido; você não precisa de um). Chame cortex.ground para se orientar: é uma das ferramentas abertas a você, e os workspaces que ele lista são os que você pode nomear no próximo passo.
Passo 4. Nomeie o workspace em cada chamada
Um token carrega um ponteiro para o workspace atual. Sem token não há ponteiro, então toda chamada que age dentro de um workspace passa workspace, por slug ou UUID. O exemplo da documentação lê a página inicial da documentação:
{ "name": "pages.read", "arguments": { "workspace": "docs", "pathOrId": "home" } }Se você omitir workspace, a chamada pede que você o informe. Para ler outra instância pública, acrescente instance com o slug dela.
Passo 5. Leia, busque e siga links
A documentação conta vinte e duas ferramentas somente leitura. Entre elas: listar e resolver workspaces públicos, listar e ler páginas e átomos, buscar por correspondência híbrida e por substring exata, navegar e buscar no catálogo de descoberta, seguir links cruzados e vizinhos semânticos, ler threads de comentários e metadados de mídia, e files.list e trees.get para código. Duas delas se comportam diferente das demais: as duas ferramentas de busca "search across every public instance whatever you pass" (buscam em todas as instâncias públicas, seja o que for que você passe), e o envelope do resultado diz isso. Para ficar dentro de um workspace, leia e liste em vez de buscar.
Passo 6. Leia o histórico de uma página
O histórico de revisões e os diffs estão entre as leituras anônimas. Um agente que cita uma página pública pode, portanto, nomear a revisão que leu e conferir depois o que mudou desde então, sem conta. É o mesmo registro que um editor conectado vê, limitado ao conteúdo público.
Passo 7. Desacelere no limite
Requisições anônimas têm limite por endereço IP. No limite, a resposta é um 429 com um cabeçalho Retry-After e uma mensagem que diz quantos segundos esperar, pede que você desacelere e aponta para o cadastro. Respeite Retry-After no cliente em vez de tentar de novo na hora.
Passo 8. Saiba quando você precisa de um token
"Everything else answers as though it did not exist." (Todo o resto responde como se não existisse). Uma página privada, um workspace privado e uma página que não existe respondem todos "not found", como no navegador, então um cliente anônimo não descobre o que não lhe é mostrado. Um token é o que você precisa "to write, to read private content, or to lift the anonymous limit" (para escrever, para ler conteúdo privado ou para sair do limite anônimo); ele tem o seu próprio limite, separado. Toda conta inclui um workspace privado gratuito e os workspaces públicos são gratuitos (veja os preços). A página MCP tokens percorre o formulário do token: workspace, papel máximo, escopo de ferramentas, um nome e um segredo mostrado uma vez.
Para dar ao Claude Code um token de escopo estreito e gravar memória no seu próprio workspace, leia nosso guia Conecte o Claude Code ao Carbon Forge via MCP.
O que a documentação deixa sem resposta
- O limite em si. A documentação diz que as requisições são limitadas por endereço IP e descreve o 429, mas não dá número nem janela de tempo.
- A lista das vinte e duas ferramentas por nome. A página as descreve por grupo e só nomeia
cortex.ground,files.listetrees.get. - Como configurar um cliente que não seja o Claude Code. Só o comando do Claude Code é dado.
- Se leituras anônimas podem ver uma lane, um corte ou um changeset. A página lista árvores de código e arquivos, mas não menciona lanes, cortes nem changesets.