다른 언어: English, Español, Português, 日本語, Deutsch, Français, 简体中文, Italiano, हिन्दी · 한국어 가이드 전체
공개: 저희는 100monkeys.ai에서 Carbon Forge를 만들고 있으므로 이 글은 만든 쪽의 설명으로 읽어 주세요. 이 가이드는 저희 AI 에이전트 하나가 공개 문서(영어), 주로 Reading a public cortex without an account (R#64944)와 MCP tokens (R#61824)를 바탕으로 초안을 쓰고 회사가 검토했으며, 이 한국어판은 영어 원문 가이드의 번역입니다. 명령, 예시 호출, 인용한 문장은 문서 그대로이며 이 가이드를 위해 실행한 것은 없습니다. 인용은 영어로 두고 옆에 번역을 붙였습니다. 문서가 답하지 않는 질문은 마지막 절에서 밝힙니다.
왜 계정 없이 읽는가
Carbon Forge의 공개 워크스페이스는 브라우저의 사람과 MCP를 쓰는 에이전트가 같은 서버를 통해 읽습니다. 익명 접근 면은 누군가 가입하거나 키를 발급받기 전에도 에이전트가 Carbon Forge 문서 같은 공개 지식 베이스를 쓰게 해 줍니다. 문서는 규칙을 한 줄로 말합니다. 토큰이 없는 클라이언트는 "can read what a browser visitor can read."(브라우저 방문자가 읽을 수 있는 것을 읽을 수 있습니다.)
1단계. 엔드포인트 찾기
공개 인스턴스는 각각 Streamable HTTP로 MCP를 제공합니다. carbonforge.dev의 엔드포인트는 https://carbonforge.dev/api/mcp입니다. 익명 읽기는 공개 스위치가 켜진 인스턴스에서만 됩니다. 스위치가 꺼진 인스턴스는 "asks you to sign in, exactly as it always has."(늘 그랬듯 로그인을 요청합니다.)
2단계. Authorization 헤더 없이 연결하기
클라이언트에 엔드포인트를 추가하고 Authorization 헤더는 보내지 마세요. 문서의 Claude Code용 명령입니다.
claude mcp add --transport http cortex-public https://carbonforge.dev/api/mcpStreamable HTTP를 쓰는 클라이언트라면 같은 URL을 씁니다. 빈 헤더나 예전 헤더 대신 헤더를 아예 보내지 마세요. "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."(잘못되었거나 만료되었거나 취소된 토큰은 조용히 익명으로 처리되지 않고 곧바로 거부되므로, 클라이언트가 생각보다 적게 읽는 일은 없습니다.)
3단계. 먼저 그라운딩하기
initialize 핸드셰이크는 인스턴스의 그라운딩 문서, 공개 워크스페이스, 호출할 수 있는 도구로 답합니다. "No session id is issued; you do not need one."(세션 ID는 발급되지 않으며 필요하지도 않습니다.) 방향을 잡으려면 cortex.ground를 호출하세요. 여러분에게 열려 있는 도구 중 하나이며, 이것이 나열하는 워크스페이스를 다음 단계에서 지정할 수 있습니다.
4단계. 호출마다 워크스페이스 지정하기
토큰에는 현재 워크스페이스 포인터가 있습니다. 토큰이 없으면 포인터도 없으므로, 워크스페이스 안에서 동작하는 모든 호출은 슬러그나 UUID로 workspace를 넘깁니다. 문서의 예시는 문서의 홈 페이지를 읽습니다.
{ "name": "pages.read", "arguments": { "workspace": "docs", "pathOrId": "home" } }workspace를 빼면 호출이 그것을 넣으라고 알려 줍니다. 다른 공개 인스턴스를 읽으려면 그 슬러그로 instance를 더하세요.
5단계. 읽고, 검색하고, 링크 따라가기
문서는 읽기 전용 도구를 스물두 개로 셉니다. 공개 워크스페이스를 나열하고 확인하기, 페이지와 아톰을 나열하고 읽기, 하이브리드 검색과 정확한 부분 문자열 검색, 디스커버리 카탈로그 둘러보기와 검색, 교차 링크와 의미상 이웃 따라가기, 댓글 스레드와 미디어 메타데이터 읽기, 그리고 코드를 위한 files.list와 trees.get이 그 예입니다. 이 중 둘은 나머지와 다르게 동작합니다. 두 검색 도구는 "search across every public instance whatever you pass"(무엇을 넘기든 모든 공개 인스턴스를 검색하며), 결과 봉투에 그렇다고 적혀 있습니다. 워크스페이스 하나 안에 머물려면 검색 대신 읽기와 나열을 쓰세요.
6단계. 페이지의 이력 읽기
리비전 이력과 diff도 익명으로 읽을 수 있습니다. 그래서 공개 페이지를 인용하는 에이전트는 계정 없이도 읽은 리비전을 밝히고, 나중에 그 뒤로 무엇이 바뀌었는지 확인할 수 있습니다. 로그인한 편집자가 보는 것과 같은 기록이며, 공개 콘텐츠로 한정될 뿐입니다.
7단계. 한도에 이르면 속도 늦추기
익명 요청은 IP 주소별로 속도가 제한됩니다. 한도에 이르면 Retry-After 헤더가 붙은 429와 함께, 몇 초를 기다려야 하는지 알려 주고 속도를 늦춰 달라고 하며 가입을 안내하는 메시지가 옵니다. 곧바로 재시도하지 말고 클라이언트에서 Retry-After를 지키세요.
8단계. 토큰이 필요한 때 알기
"Everything else answers as though it did not exist."(그 밖의 모든 것은 존재하지 않는 것처럼 답합니다.) 비공개 페이지, 비공개 워크스페이스, 존재하지 않는 페이지는 브라우저에서처럼 모두 "not found"(찾을 수 없음)로 답하므로, 익명 클라이언트는 자신에게 보이지 않는 것을 알아낼 수 없습니다. 토큰은 "to write, to read private content, or to lift the anonymous limit"(쓰거나, 비공개 콘텐츠를 읽거나, 익명 한도를 넘기 위해) 필요하며, 토큰에는 따로 정해진 속도 제한이 있습니다. 모든 계정에는 무료 비공개 워크스페이스가 하나 포함되며 공개 워크스페이스는 무료입니다(요금 참고). MCP tokens 페이지는 토큰 양식을 따라갑니다. 워크스페이스, 역할 상한, 도구 범위, 이름, 그리고 한 번만 보여 주는 비밀 값입니다.
Claude Code에 범위가 좁은 토큰을 주고 여러분의 워크스페이스에 기억을 쓰게 하려면 가이드 MCP로 Claude Code를 Carbon Forge에 연결하기를 읽으세요.
문서가 답하지 않는 것
- 속도 제한 자체. 문서는 요청이 IP 주소별로 제한된다고 하고 429를 설명하지만, 숫자도 시간 창도 밝히지 않습니다.
- 스물두 도구의 이름 목록. 페이지는 도구를 묶음으로 설명하며
cortex.ground,files.list,trees.get만 이름을 듭니다. - Claude Code가 아닌 클라이언트의 설정 방법. Claude Code용 명령만 나와 있습니다.
- 익명 읽기로 레인, cut, changeset을 볼 수 있는지. 페이지는 코드 트리와 파일은 나열하지만 레인, cut, changeset은 언급하지 않습니다.