OpenOcta 的工作区里同时出现mcp.servers和SKILL.md时Agent 的同一轮对话既要按 Skill 组织步骤又要通过 MCP 拉真实数据。麻烦点不在写配置而在模型侧MCP 服务有 stdio 命令和 URLSkill 有工作区、托管、内置三档优先级模型调用却可能散在多个 Key 和 Base URL 上。TaoToken 把模型调用收成统一接入先打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册并创建 Key再回 OpenOcta 的模型供应商里填自定义 API这样同一会话里启停 Skill、增删 MCP 时不用再动模型通道。下面按 OpenOcta 实际配置路径走一遍。1. 先把 MCP 和 Agent Skills 的分工摆到 OpenOcta 桌面上1.1 MCP 是连接层负责把真实数据端上来MCP 在 OpenOcta 里的角色像后厨采购员它不决定今天做什么菜只负责把食材从仓库、日志目录、只读接口拿到窗口。mcp.servers声明的是服务器怎么启动、用 stdio 还是 URL、带哪些环境变量。工具调用返回的是数据或只读结果Agent 再解释。注意不要让 MCP 工具承担“执行生产变更”的角色诊断类 SQL 由读者在本地或受控客户端执行把报错贴回对话MCP 只做只读取数。1.2 Agent Skills 是方法论层SKILL.md 决定步骤顺序Skill 更像菜谱。SKILL.md里写清楚先查什么、后查什么、产物结构长什么样、失败时怎么收口。OpenOcta 按优先级加载 Skill工作区.openocta/skills/最高托管~/.openocta/skills/次之内置安装目录最低。同会话里 Agent 先按 Skill 组织步骤再通过 MCP 拉数据两者不是二选一。MCP 管“数据从哪来”Skill 管“拿到数据后按什么格式和顺序产出”混在一起排查会非常费劲。1.3 同会话同时挂 MCP 和 Skill 时Key 为什么容易乱当 MCP server 从一个变成三个Skill 从内置切到工作区版本模型供应商如果还留着多个 Base URL排错会非常痛苦你以为是 MCP 工具没返回实际是模型请求打到了另一个 Key。把模型通道固定到 TaoToken只保留一个 Base URL 和一个 KeyMCP 和 Skill 的变量就能分开看。先分清三层再动配置文件后面每一步都能独立验证。层面职责在 OpenOcta 里的落点排错先看MCP连接层mcp.servers工具列表、server 日志Agent Skills方法论层SKILL.md优先级、frontmatter模型通道推理入口自定义 APIKey、Base URL、模型 ID2. 在 OpenOcta 里配 mcp.servers 之前先固定模型通道2.1 去官网创建 YOUR_API_KEY别急着填 MCP 命令先打开 TaoToken 注册并创建 API Key复制出来的值在 OpenOcta 配置里统一写成占位符YOUR_API_KEY。模型 ID 不要猜去模型广场看当时列表把选中的 ID 填到YOUR_MODEL_ID。这一步先于mcp.servers因为模型通道不通时MCP 工具是否正常根本看不出来。很多同会话报错并不是 MCP 挂了而是模型请求根本没拿到响应。2.2 OpenOcta 自定义 API 配置Base URL 只填 https://taotoken.net/api在 OpenOcta 的模型供应商/自定义 API 里新增一条渠道Base URL 填https://taotoken.net/api末尾不要加/v1也不要加任何查询参数。API Key 用刚才从官网创建的YOUR_API_KEY。如果界面分“OpenAI 兼容”“Anthropic 兼容”按 OpenOcta 当前文档选对应兼容项拿不准就先在模型对话里用同一把 Key 发消息确认。这个 Base URL 是给工具调用的接口地址不要和官网注册页混用。2.3 一个 OpenOcta 工作区配置示例下面示例把模型通道和 MCP 声明放在.openocta/config.json字段按你本地 OpenOcta 版本调整重点是 Base URL 和 Key 的写法。{ model: { provider: custom, baseUrl: https://taotoken.net/api, apiKey: YOUR_API_KEY, modelId: YOUR_MODEL_ID }, mcp: { servers: {} } }保存后重启 OpenOcta 或重载工作区先不挂 MCP发一条“你好请回复当前模型名”的消息确认模型通道成功。成功后再继续加mcp.servers这样出错时只需要看 MCP 这一层不用同时怀疑 Key、Base URL、模型 ID 和 Skill 优先级。3. mcp.servers 声明服务器stdio 与 URL 两种写法3.1 stdio MCP server 在 OpenOcta 里的配置stdio 型 MCP server 由 OpenOcta 启动子进程配置里要写command、args和必要的env。路径建议用绝对路径或工作区相对路径不要依赖终端当前目录。下面这个ops-log只读本地导出的巡检日志返回时间戳、来源和摘要。{ mcp: { servers: { ops-log: { command: node, args: [./.openocta/mcp-servers/ops-log/index.js], env: { LOG_DIR: ./fixtures/logs, READ_ONLY: 1 } } } } }这里的ops-log只读本地导出的巡检日志返回时间戳、来源和摘要。变更动作、修复命令、数据库写入都不放在 MCP server 里需要诊断 SQL 时让 Agent 生成 SQL 或解释思路读者在本地执行再把结果贴回。OpenOcta 的 MCP 面板里应该能看到ops-log下的工具列表看不到就先查 server 启动日志。3.2 URL 型 MCP server 在 OpenOcta 里的配置如果 MCP server 已经以 HTTP 服务方式跑在本地可以用 URL 声明。注意这个 URL 是 MCP 服务自己的地址和模型 Base URL 是两回事不要混。{ mcp: { servers: { asset-api: { url: http://127.0.0.1:8787/mcp, transport: http } } } }配置后看 OpenOcta 的 MCP 面板是否出现工具列表。工具名通常带 server 前缀例如ops-log.query、asset-api.list。如果列表为空先看 server 进程有没有起来再看mcp.servers的键名和 transport 是否对。URL 型服务最容易踩的坑是端口写错或者把模型接口地址误填到这里。3.3 装完先单独测 MCP 工具不要和 Skill 一起排错点开单个 MCP 工具用一条只读请求试跑比如“列出最近 10 条日志摘要”。确认返回里有真实数据、时间戳和来源再继续写SKILL.md。MCP 和 Skill 同时报错时排查成本会翻倍先把连接层跑通再把方法论层叠上去。这样同会话里 Agent 调用工具时你能确认拿到的是 MCP 返回而不是模型自己编出来的内容。4. SKILL.md 按优先级加载工作区、托管、内置谁先谁后4.1 工作区 Skill 的 SKILL.md 示例在 OpenOcta 工作区建.openocta/skills/inspection-report/SKILL.md用 frontmatter 写名称、描述、优先级和允许调用的 MCP 工具。下面是一份可复制的巡检报告 Skill。--- name: inspection-report description: 按固定结构生成巡检报告数据必须来自 MCP 工具返回 priority: 100 allowed-tools: - mcp.ops-log.query - mcp.asset-api.list --- # 巡检报告 Skill ## 工作流 1. 调用 MCP 工具 ops-log.query 拉取最近 30 分钟日志摘要。 2. 调用 MCP 工具 asset-api.list 拉取目标资产列表。 3. 按“范围、异常、证据、建议”四段输出。 4. 每个异常必须带 MCP 返回的时间戳和来源缺失就标注“数据缺失”。 5. MCP 工具失败时停止推断只输出失败原因和已取到的字段。priority越高越先被选中。工作区 Skill 适合放当前项目特有的巡检格式不要把所有临时提示词都塞进来。allowed-tools写得越窄Agent 在同会话里越不容易把无关工具拉进来。4.2 托管 Skill 和内置 Skill 的覆盖关系托管 Skill 放在~/.openocta/skills/跨项目可用优先级低于工作区。内置 Skill 随 OpenOcta 发行优先级最低。同一名称的 Skill 出现时工作区版本覆盖托管版本托管版本覆盖内置版本。调试时可以在 OpenOcta 面板看实际加载路径不要只看文件名。工作区里改了SKILL.md但没生效先检查有没有同名的托管版本在旁边抢优先级。4.3 同会话里 Agent 如何按 Skill 组织步骤再调 MCP当用户提问“按 inspection-report 输出报告”Agent 先命中工作区 Skill读取工作流然后按allowed-tools调用 MCP 工具最后按 Skill 规定的四段结构生成产物。此时模型调用的仍是固定渠道Base URL没有被 MCP 或 Skill 改写。把这三层分开看排错路径就清晰模型不通查 Key工具不返回查 MCP server产物结构不对查 SKILL.md。同会话里既挂 MCP 又启 Skill最怕的就是把这三个问题混成一个“AI 又抽风了”。5. 用“巡检报告”跑一次同会话验证5.1 提问模板要同时点名 Skill 和 MCP在 OpenOcta 同会话里发一条明确点名两者的提问“按 inspection-report Skill 输出一份巡检报告数据来自 MCP 工具 ops-log 和 asset-api不要编造缺失字段直接标注。” 这条提问同时触发 Skill 加载、MCP 工具调用和模型推理适合做端到端检查。提问里写清楚工具名和 Skill 名能避免 Agent 自己猜加载了哪个版本。5.2 检查三类成功信号MCP 取数、Skill 结构、模型调用第一看 OpenOcta 的工具调用记录里是否有ops-log.query和asset-api.list的真实返回第二看最终产物是否按“范围、异常、证据、建议”四段输出第三去 TaoToken 控制台看这次调用有没有记上账、用的模型 ID 是否一致入口还是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 。三个信号都对说明同会话挂 MCP 和 Agent Skills 已经跑通。只要有一个信号不对就按层排查不要先改提示词。5.3 同会话里换 Skill 时不要动模型通道启停工作区 Skill、切到托管 Skill或者在mcp.servers里临时加一个只读工具都不需要改Base URL和 Key。模型通道保持https://taotoken.net/apiKey 保持YOUR_API_KEY对应的那一把。这样 Skill 和 MCP 的变更不会把模型调用一起带乱。验证通过后再把临时加的 MCP 工具固化到工作区配置里方便团队复用。6. OpenOcta 挂 MCP Skills 常见报错与排查6.1 MCP server 启动失败或工具列表为空stdio 型先看command是否在 PATH 里、args路径是否相对工作区、env是否漏了 Node 或 Python 运行时。URL 型先看端口是否被占用、transport是否写对、服务是否真的返回 MCP 协议。工具列表为空时把 OpenOcta 的 MCP 日志级别调高看它有没有连上 server。工具名带没带前缀也决定 Agent 在 Skill 里能不能按allowed-tools找到它。6.2 Skill 没被加载优先级和 frontmatter 踩空SKILL.md路径大小写、目录层级、frontmatter 的name与调用名不一致都会导致 Skill 不命中。工作区、托管、内置三档优先级不要凭感觉猜直接在 OpenOcta 面板看加载来源。如果工作区 Skill 没生效检查它是否被同名的托管或内置版本覆盖。priority写错成字符串、allowed-tools缩进错误也会让 Skill 半加载。6.3 模型侧 Key 或 Base URL 填错时的表现Key 没替换成YOUR_API_KEY对应值通常直接 401Base URL 写成https://taotoken.net/api/v1可能 404 或提示路径不存在。正确写法只有https://taotoken.net/api末尾不要加/v1也不要把官网注册链接填进baseUrl。模型 ID 不要猜以模型广场当时列表为准。OpenOcta 里如果同时存在多个自定义供应商确认当前工作区到底选了哪一条。6.4 同会话 Context 太乱把只读数据和执行动作分开巡检报告里混入变更命令、生产连接串或完整大日志会让模型注意力分散。MCP 只返回摘要和证据字段执行动作交给读者本地完成需要 SQL 时让 Agent 生成 SQL 或解释 SQL读者在本地或受控客户端执行再把结果贴回对话。这样同会话既保留 Skill 的结构又不会把 MCP 变成“什么都干”的黑盒。Skill 负责收口MCP 负责取数模型只负责推理和整理。7. 配通之后Key、套餐和文档各自去哪里7.1 模型对话先验同一把 Key配完 OpenOcta 的巡检报告后先去 TaoToken 模型对话 用同一把 Key 发一条测试消息确认模型 ID 和 Base URL 没填错。对话里能出结果OpenOcta 里再报模型错误就优先查 OpenOcta 工作区配置是否覆盖了渠道。模型对话能快速排除 Key 和模型 ID 的问题。7.2 长期跑巡检再看 Coding Plan 和 API Keys如果每天都要让 Agent 按 Skill 出巡检报告可以打开 Coding Plan 看套餐是否够用Key 的统一入口在 控制台 API Keys。模型广场的列表会变动模型 ID 以当时页面为准不要拿旧截图里的 ID 硬填。需要多把 Key 时建议按项目或环境拆不要混进同一个 OpenOcta 工作区。7.3 需要命令行执行时再对照 Claude Code 文档OpenOcta 主要负责把 MCP 和 Skill 挂进同一会话。若你还要用 Claude Code 跑命令行任务环境变量对照见 Claude Code 接入文档Base URL 同样填https://taotoken.net/apiKey 仍从官网创建。把模型通道收成一处之后MCP 管连接、Skill 管步骤、OpenOcta 管会话三者各司其职后面加工具或换 Skill 都只是局部调整。