사전 빌드된 공개 GHCR 이미지에서 격리된 opencode 인스턴스를 생성하여 Claude Code에 MCP 서버로 전달합니다. 빌드 단계가 없고 opencode 포크를 체크아웃할 필요도 없습니다. 각 인스턴스는 고유한 명명된 볼륨을 가진 독자적인 Docker Compose 프로젝트이며, 작업 공간은 호스트 바인드가 아닌 명명된 볼륨이므로 사용자의 파일 시스템을 볼 수 없습니다. 이미지는 공개되어 익명으로 가져올 수 있습니다. 백엔드는 opencode 1.18.4를 보고하며 MCP 브리지는 80개의 도구를 노출합니다.
소스에서 빌드하여 PATH에 바이너리를 배치하세요:
bun run build
cp dist/opencode-sandbox ~/.local/bin/(bun run install-local은 두 작업을 한 번에 수행합니다.) 또는 이 저장소의 GitHub Releases에서 사전 빌드된 바이너리를 받으세요.
Related MCP server: Sandbox Agent
인스턴스를 생성하세요. 셸에 이미 있는 모든 공급자 API 키(ANTHROPIC_API_KEY, OPENAI_API_KEY, GOOGLE_GENERATIVE_AI_API_KEY, OPENROUTER_API_KEY)는 생성 시 해당 인스턴스로 전달됩니다. UI 로그인 단계나 관리할 auth.json이 없습니다.
opencode-sandbox create scratch --seed ./my-project --config ./opencode.jsonc--seed는 인스턴스가 처음 시작되기 전에 디렉터리를 새 작업 공간에 복사합니다. --config는 해당 인스턴스에만 적용되는 opencode.jsonc를 배치합니다. 둘 다 선택 사항입니다.
Claude Code에 등록하세요. create는 이 줄을 출력하며, url은 나중에 다시 출력합니다:
opencode-sandbox url scratch
claude mcp add --transport http scratch http://127.0.0.1:4784/mcp이제 사용하세요. 해당 인스턴스의 80개 도구(읽기, 쓰기, 셸 명령 실행, 모두 자체 /workspace로 범위가 제한됨)가 해당 Claude Code 세션에서 사용 가능합니다. 작업이 끝나면:
opencode-sandbox destroy scratch --yesdestroy는 작업 공간을 포함하여 컨테이너와 해당 볼륨을 제거합니다.
웹 UI도 사용할 수 있으며, 생성 시 --web 옵션으로 활성화할 수 있습니다. 이 옵션이 없으면 MCP 브리지가 유일한 인터페이스입니다.
MCP 브리지에는 자체적인 인바운드 인증이 없습니다. 해당 포트에 도달할 수 있는 사람은 누구나 인스턴스의 /workspace 내에서 파일을 읽고 쓰고 셸 명령을 실행하는 전체 opencode 도구 표면을 사용할 수 있습니다. 공개된 포트는 기본적으로 127.0.0.1에 바인딩됩니다. 그 상태로 유지하세요. 실제 인증 레이어를 앞에 두지 않고 0.0.0.0으로 확장하거나 공개 리버스 프록시 뒤에 두지 마세요.
This server cannot be deployed
Hosted MCP catalog with 30 tenant-isolated browser, RAG, AI, mail and media tools.
327 dev tools via REST API and MCP. Generate Dockerfiles, schemas, K8s, APIs, and more.
Create, deploy, and operate MCP servers directly from your GitHub repositories.
A MCP server built for developers enabling Git based project management with project and personal…
