SuperAPI AI 工具集

mcp-arch

智能体与模型

查看项目

更新于 10-15 21:10

技能介绍

用途:解释 MCP 在 OpenWork、OpenCode 与 OpenWork 服务器之间的接线方式,并指导配置或认证排障。当用户提到 MCP 相关问题时触发。

主要能力:给出接线概览;排查认证错误;提示常见陷阱;说明首次配置步骤。

接线要点:OpenWork UI 通过 OpenCode SDK 进行运行时 MCP 调用与事件;MCP 配置位于 opencode.json 的 mcp 下,OpenWork 服务器仅为远程客户端读写配置;MCP 认证令牌由 OpenCode 管理并存储在仓库之外;远程 UI 流量访问 OpenWork 服务器的 /opencode/*,由其代理到 OpenCode;OpenWork 服务器必须包含工作区目录(通过 x-opencode-directory 或 directory 查询参数),以便 OpenCode 加载正确配置。

认证排障:确认 MCP 条目类型与必填字段(local 需要 command[],remote 需要 url);若刷新令牌无效,通过 OpenCode 重新认证,并在修改配置后重载引擎;避免直接编辑令牌文件,应使用 OpenCode 命令或端点;若 UI 提示“does not support OAuth”,检查目录是否与磁盘上的 opencode.json 路径一致;远程模式下,除非显式启用自动批准,mcp.add 与 engine.reload 受 OpenWork 审批门控。

常见陷阱:引擎重载只重新读取配置,不会刷新 OAuth 令牌;远程客户端需要 OpenWork 服务器写入配置,但 MCP 运行时仍经由 OpenCode;macOS 可能将临时路径解析为 /private/tmp/...,而配置位于 /tmp/...,调用 MCP 端点前需规范化。

首次配置:将 MCP 条目添加到 opencode.json;重启或重载 OpenCode 引擎;通过 OpenCode 认证 MCP 提供方。

限制:资料未提供具体命令、价格、平台支持范围或效果数据。