코딩 업무는 MCP 클라이언트에서 OpenCode에 위임하세요.

opencode-mcp는 Claude, Cursor, VS Code 및 기타 MCP 클라이언트를 OpenCode의 헤드리스 API와 연결합니다. 질문을 하고, 기능을 구현하며, 백그라운드 작업을 모니터링하고, 질문과 권한에 응답하며, 프로젝트 간 변경 사항을 검토할 수 있습니다.

버전 3.0.0은 Node.js 22 이상이 필요합니다. 2.x에서 업그레이드하는 건가요? 마이그레이션 노트를 참고하세요.

퀵 스타트

OpenCode를 설치하고 프로젝트에서 서버를 시작하세요:

TUI를 사용한다면 opencode --port 4096로 시작하고 그 서버를 공유하세요. OPENCODE_BASE_URL를 다른 엔드포인트로 설정하세요.

클로드 코드에 대해:

mcpServers 구성을 사용하는 클라이언트의 경우:

클라이언트를 재시작하고 opencode_setup를 호출합니다. 설정된 공급자 중에서 공급자를 선택한 후 opencode_provider_models로 모델을 선택합니다. OPENCODE_DEFAULT_PROVIDER와 OPENCODE_DEFAULT_MODEL를 함께 설정하거나 각 프롬프트 호출에서 선택한 ID를 전달하세요.

클라이언트별 구성에는 VS Code, Windsurf, Continue, Zed, Amazon Q가 포함됩니다. 미공개 변경 사항을 테스트하려면 소스에서 빌드하고 클라이언트가 node에서 dist/index.js로 절대 경로로 실행되도록 설정하세요.

워크플로우 선택

opencode-mcp

Delegate coding work to OpenCode from your MCP client.

opencode-mcp connects Claude, Cursor, VS Code, and other MCP clients to OpenCode’s headless API. Ask questions, implement features, monitor background work, respond to questions and permissions, and review changes across projects.

Version 3.x requires Node.js 22 or newer and works with OpenCode 1.x (tested with 1.18.31 and 1.19.3). Support for OpenCode 2.x is planned for 4.0. Upgrading from 2.x? See the migration notes.

Quick Start

Install OpenCode and start its server from your project:

opencode serve --hostname 127.0.0.1 --port 4096

If you use the TUI, start it with opencode --port 4096 and share that server. Set OPENCODE_BASE_URL for another endpoint.

For Claude Code:

claude mcp add opencode -- npx -y opencode-mcp

For clients using an mcpServers configuration:

{
  "mcpServers": {
    "opencode": {
      "command": "npx",
      "args": ["-y", "opencode-mcp"]
    }
  }
}

Restart the client and call opencode_setup. Choose a provider from its configured providers, then use opencode_provider_models to select a model. Set OPENCODE_DEFAULT_PROVIDER and OPENCODE_DEFAULT_MODEL together or pass the selected IDs in each prompt call.

Client-specific configuration includes VS Code, Windsurf, Continue, Zed, and Amazon Q. To test unreleased changes, build from source and configure your client to run node with the absolute path to dist/index.js.

Choose a Workflow

opencode_fire({
  directory: "/absolute/path/to/project",
  prompt: "Add input validation to POST /api/users and run the relevant tests",
  providerID: "",
  modelID: ""
})
// Save the returned job and session IDs; use them to monitor or resume observation.