怎么说呢，

opencode MCP配置手册

什么是 MCP

MCP是一种开放协议。允许外部服务以标准化方式向 LLM 暴露工具、提示词和资源。opencode 作为 MCP 客户端，可连接任意 MCP 服务器。将其提供的工具直接注入到 LLM 上下文中。

配置位置

MCP 服务器在 opencode 配置文件的 mcp 字段中配置：

{
"$schema": ""。"mcp": {
"<服务器名称>": { /* McpLocalConfig 或 McpRemoteConfig */ }
}
}

配置文件查找顺序：

优先级	方法
1	/opencode.json
2	/opencode.jsonc
3	/.opencode/opencode.json
4	/.opencode/opencode.jsonc
5	~/.config/opencode/opencode.json

服务器类型

opencode 支持两种 MCP 服务器类型：

local — 本地进程

通过子进程 stdin/stdout 通信，适合本地命令行工具。 说起来，

{
"mcp"这方面，{
"filesystem": {
从"type"来看，"local","command":,"environment": {
"NODE_ENV": "production"
},"enabled": true,"timeout": 0
}
}
}

字段说明：

environment — 注入到子进程的额外环境变量 enabled — true 为启用。false 则跳过启动 timeout — 单次请求超时时间，0 表示无限

字段	类型	必填	默认值	说明
type	"local"	✓	-固定值-
command	string	✓	-

remote — 远程服务器

通过 HTTP 协议连接，优先尝试 StreamableHTTP，回退到 SSE。

{
从"mcp"来看，{
"my-api": {
"type"的观点是，"remote","url": "","headers": {
"Authorization": "Bearer "
},"enabled": true。"timeout": 0
}
}
}

字段

OAuth 认证

The remote server automatically enables OAuth detection. When server returns a challenge response opencode will trigger OAuth flow.

OAuth 配置字段（oauth)：

clientIdstring预注册的 OAuth Client ID；不提供时尝试动态注册 clientSecretstringOAuth Client Secret scopestring请求的 OAuth scope，空格分隔 <

字段	类型	说明

禁用 OAuth 示例：

{
"mcp":{
“my-api”:{
说到“type”，“remote”,“url”:“",“oauth”: false
}
}
}

OAuth 完整示例：
{
"mcp":{
“my-oauth-server”:{
从“type”来看，“remote”,“url”:“",“oauth”:{
“clientId”:“my-client-id”,“clientSecret”:“my-client-secret”。“scope”:“read write”
}
}
}
}

禁用已配置的服务器 

You can disable a server in two ways:
// 方法一：在配置对象中设置 enabled: false
"filesystem":{
至于“type”，“local”,“command”:,“enabled”: false
}
// 方法二：简化写法
"filesystem":{
“enabled”: false
}

全局超时配置 

The experimental field allows setting a global MCP timeout which is overridden by individual server’s timeout values.
{
"experimental":{
“mcp_timeout”:30000
}
}



配置
优先级


单个服务器 timeout 字段高于实验性全局超时。

CLI 管理命令 

opencode mcp add
opencode mcp list
opename mcp auth
opename mcp auth list
opename mcp logout
opename mcp debug 

服务器连接状态 



状态
说明


connected
已成功连接

disabled
 跳过启动

failed


needs_auth


needs_client_registration


工具命名规则 

MCP 工具注册到 LLM 时名称为：
_

The sanitize rule replaces all non‑ characters with an underscore.

E.g.。server name ,tool name ,→ LLM sees .

传输协议优先级

The client tries following order when connecting a remote server:


StreamableHTTP 

SSE 

If server returns an auntication challenge,client enters OAuth flow and stops furr attempts.





/ H three>

认证或使用 openc ode m cp logout 清除。
/ H three



}}

---