다른 언어: English, Español, Português, 日本語, Deutsch, Français, 简体中文, Italiano, हिन्दी · 한국어 가이드 전체

공개: 저희는 100monkeys.ai에서 Carbon Forge를 만들고 있으므로 이 글은 만든 쪽의 설명으로 읽어 주세요. 이 가이드는 저희 AI 에이전트 하나가 carbonforge.dev/docs의 공개 문서(영어)를 바탕으로 초안을 쓰고 회사가 검토했으며, 이 한국어판은 영어 원문 가이드의 번역입니다. Carbon Forge 단계는 문서를 인용하고, Claude Code 명령은 Claude Code 자체의 claude mcp add --help에서 가져왔습니다. 문서가 답하지 않은 질문은 마지막 절에서 밝힙니다.

왜 연결하는가

코딩 에이전트는 메모를 다시 읽을 수 있는 곳에 두지 않으면 세션 사이에 잊어버립니다. Carbon Forge가 그곳이고, 프로젝트의 사람들과 함께 씁니다. 문서는 MCP를 "a primary product surface, co-equal with the human editor, against the same atoms, pages, links, and embeddings"(사람의 편집기와 동등한 기본 제품 표면으로, 같은 atom, 페이지, 링크, 임베딩을 다룹니다)라고 부릅니다(A shared cortex for LLMs). 에이전트의 페이지는 사람이 열고, 고치고, 링크할 수 있는 페이지입니다.

1단계. 토큰 없이 읽기 전용 엔드포인트 사용해 보기

가입하기 전에 공개 콘텐츠에 연결해 보세요. 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:"(Authorization 헤더 없이 인스턴스의 MCP 엔드포인트를 클라이언트에 추가하세요. 이 인스턴스에서는 Streamable HTTP로 연결하는 그 주소입니다. Claude Code에서는:)

claude mcp add --transport http cortex-public https://carbonforge.dev/api/mcp

IP 주소별 요청 제한이 걸린 읽기 전용 도구 스물두 개를 얻습니다. Claude Code에 워크스페이스 docs의 페이지 home을 읽어 달라고 해 보세요. 토큰이 없으면 현재 워크스페이스가 없으므로 모든 호출이 workspace를 지정합니다. 인증된 항목을 추가하기 전에 claude mcp remove cortex-public으로 이 항목을 지워서 에이전트가 두 표면을 읽지 않게 하세요.

2단계. 로그인하고 워크스페이스 고르기

carbonforge.dev/login에서 이메일 링크나 100monkeys 버튼으로 로그인하세요. 비밀번호는 없습니다. 공개 워크스페이스는 무료이고, 모든 계정에는 무료 비공개 워크스페이스가 하나 포함됩니다(요금). 에이전트가 기억으로 쓸 워크스페이스를 정하세요. 비공개 워크스페이스라면 메모가 멤버에게만 보입니다.

3단계. 맞는 범위 중 가장 좁은 토큰 만들기

MCP tokens에 따르면: 설정을 열고 API tokens를 고릅니다. 워크스페이스와 역할 상한(viewer, editor 또는 admin)을 고르고, 도구 범위를 고르고, 토큰 이름을 에이전트 이름으로 짓고, 비밀 값을 복사합니다. 이 값은 "is shown once, then only the prefix."(한 번만 보이고, 그 뒤에는 접두사만 보입니다.)

공유 기억에는 Basic LLM memory가 에이전트에게 "read and write pages, atoms and tags, and run search, with basic graph reads"(페이지, atom, 태그를 읽고 쓰고, 기본적인 그래프 읽기와 함께 검색을 실행)할 수 있게 하며, 문서는 이것을 "the minimum for an LLM that uses Carbon Forge as its memory."(Carbon Forge를 기억으로 쓰는 LLM에 필요한 최소한)라고 부릅니다. 기억을 떠올리기만 하는 에이전트라면 Read-only memory는 아무것도 쓰지 않습니다. 코드 작업에는 SCM agent가 레인, 트리, 랜딩을 더합니다(MCP token scopes). 범위 밖의 도구는 "answers exactly as a tool that does not exist."(존재하지 않는 도구와 똑같이 응답합니다.)

4단계. 토큰과 함께 Claude Code에 서버 추가하기

문서는 클라이언트가 엔드포인트를 "with the token in the Authorization header"(Authorization 헤더에 토큰을 넣어) 가리키게 하라고 합니다. Claude Code는 --header로 헤더를 설정합니다.

claude mcp add --transport http carbon-forge https://carbonforge.dev/api/mcp \
  --header "Authorization: Bearer ‹your token›"

토큰을 환경 변수에 넣고 대신 $CARBON_FORGE_TOKEN을 쓰더라도, 셸이 Claude Code가 보기 전에 그것을 펼치므로 비밀 값은 여전히 Claude Code의 구성에 저장됩니다. 어느 쪽이든 그 구성을 비밀로 다루고, 서버는 커밋하는 파일이 아니라 기본 local 범위나 user 범위에 두세요.

5단계. 에이전트가 스스로 방향을 잡게 하기

세션을 시작하고 Claude Code에 cortex.ground를 호출하라고 하세요. 문서는 이것을 첫 호출로 정합니다. 이 호출은 "Returns the per-instance README, the calling identity, what the bearer can do, what is reachable, and helper-service health"(인스턴스별 README, 호출하는 신원, 토큰 보유자가 할 수 있는 일, 접근할 수 있는 곳, 보조 서비스의 상태를 돌려줍니다)(cortex.ground). 원시 호출은 다음과 같습니다.

{ "jsonrpc": "2.0", "id": 1,
  "method": "tools/call",
  "params": { "name": "cortex.ground" } }

서버는 같은 내용을 initialize 핸드셰이크와 세션의 첫 도구 호출에서도 전달하므로, 이 단계를 건너뛴 에이전트도 방향을 잡습니다. capabilities 블록을 읽어 토큰이 쓰기를 할 수 있는지 확인하세요.

6단계. 기억을 쓰고 인용하기

에이전트에게 배운 것을 페이지로 기록하게 하세요. 예를 들어 결정과 그 이유를 적고, 다음 세션을 시작할 때 그 페이지를 읽게 합니다. 두 가지 성질이 이것을 캐시가 아닌 기억으로 만듭니다. 저장할 때마다 새 버전이 쓰이고 어떤 것도 이전 버전을 덮어쓰지 않으므로, 에이전트가 지난주에 쓴 내용을 읽을 수 있습니다. 그리고 "every entity-returning tool decorates the result with a clickable permalink so an LLM can hand a working URL back to its human"(엔티티를 돌려주는 모든 도구는 결과에 클릭할 수 있는 퍼머링크를 붙여, LLM이 사람에게 작동하는 URL을 건넬 수 있게 합니다)(How MCP works). 에이전트가 근거로 삼은 모든 페이지의 퍼머링크를 인용하게 하고, 그것을 확인하세요.

코드도 같은 기록이 담습니다. 에이전트는 클론하는 대신 레인을 열고, 랜딩은 하나의 체인지셋으로 한 트랜잭션 안에서 모두 쓰이거나 아무것도 쓰이지 않습니다(Working in lanes).

7단계. 감사 로그를 지켜보고 끝나면 폐기하기

"Every tool call lands in the audit log under the token identity."(모든 도구 호출은 토큰의 신원으로 감사 로그에 남습니다.) 에이전트에게 더 이상 접근이 필요 없거나 토큰이 유출되면 설정에서 폐기하세요. "in-flight calls fail on the next request"(진행 중인 호출은 다음 요청에서 실패합니다)(MCP tokens).

문서가 답하지 않는 것

자체 호스트에 있는 인스턴스의 엔드포인트. 익명 접근 페이지는 https://carbonforge.dev/api/mcp를 "for this instance"(이 인스턴스용)라고 하지만, 자체 서브도메인이나 별도 도메인의 인스턴스에는 어떤 URL을 쓰는지 말하지 않습니다.
두 개의 경로. 같은 페이지는 /api/mcp를 쓰고, How MCP works의 curl 예제는 /mcp로 보냅니다. 저희는 /api/mcp를 씁니다.
토큰 수명. 문서는 토큰 폐기는 설명하지만 토큰이 스스로 만료되는지는 말하지 않습니다.
클라이언트별 구성. 문서에는 Claude Code 명령이 없습니다. 위의 명령은 헤더를 위한 Claude Code의 문서화된 문법입니다.

MCP로 Claude Code를 Carbon Forge에 연결하기: 에이전트가 읽고, 쓰고, 인용하는 공유 기억