一、什么是 MCP？

MCP（Model Context Protocol）是一种开放协议，允许你为 OpenCode 添加外部工具和能力。通过 MCP，你可以将各种服务集成到 AI 助手中。

配置 MCP 服务器

在 opencode.json 的 mcp 字段中配置：

jsonc { "mcp": { "my-local-mcp": { "type": "local", "command": ["npx", "-y", "my-mcp-command"], "enabled": true } } }

远程 MCP 服务器

jsonc { "mcp": { "my-remote-mcp": { "type": "remote", "url": "https://my-mcp-server.com", "enabled": true, "headers": { "Authorization": "Bearer {env:MY_API_KEY}" } } } }

常用 MCP 示例

Sentry：查询 Sentry 项目和问题

jsonc { "mcp": { "sentry": { "type": "remote", "url": "https://mcp.sentry.dev/mcp", "oauth": {} } } }

Context7：搜索文档

jsonc { "mcp": { "context7": { "type": "remote", "url": "https://mcp.context7.com/mcp" } } }

工具权限控制

MCP 工具会占用上下文空间，建议谨慎使用。可以用 tools 字段控制：

jsonc { "tools": { "my-mcp*": false // 禁用所有 my-mcp 工具 } }

也可以在 Agent 级别控制：

jsonc { "agent": { "my-agent": { "tools": { "my-mcp*": true } } } }

MCP 工具名以服务器名作为前缀，例如 sentry_* 匹配 Sentry 的所有工具。