服务

服务页的目标很简单：把外部能力接进来，让 Agent 在任务中自动调用。

页面地图

进入左侧 服务 页面后，你会看到以下关键区域：

1. 右上操作区：刷新、搜索服务、新建服务。
2. 已连接区：按类型分组展示，通常包含 MCP、API、LOCAL。
3. 推荐区：可直接点击 + 快速接入。
4. 服务卡片状态：绿色圆点通常表示在线可用。

快速连接推荐服务

适合：GitHub、Notion、Jira、Slack、Google Drive 这类常见工具。

1. 在服务页下半区找到目标服务卡片。
2. 点击右侧 +。
3. 完成授权后，服务会进入上方已连接分组。
4. 用右上 搜索服务 快速确认是否已出现。

新建服务

适合：推荐区没有、或你要接自定义能力。

1. 点击右上 新建服务。
2. 在对话中直接描述目标服务，例如：
   • Add MCP Server 添加一个 Linear MCP 服务。
   • 连接一个本地 Obsidian 服务，用于读取知识库。
   • 新增 Jira API 服务，读取指定项目任务。
3. 等待 Agent 自动生成配置并执行。
4. 执行成功后，回到服务页确认卡片和状态点。

自动执行模式建议

• 日常新增：开 自动执行，速度最快。
• 涉及敏感权限：先关闭自动执行，逐步确认每个动作。
• 多步配置任务：保持 Todo 视图，方便你追踪子步骤。

已连接服务管理

1. 用 搜索服务 快速定位具体服务。
2. 服务异常时先点 刷新 同步状态。
3. 按分组管理职责：
   • MCP：外部系统协议接入，如 Linear MCP。
   • API：标准 HTTP API 能力，如 GitHub/Jira。
   • LOCAL：本机应用或本地资源，如 Obsidian。

连接后验收

每接完一个服务，都做一次最小验证：

1. 在会话中下发真实任务，例如：
   • 读取 GitHub 最近提交并总结风险点
   • 从 Notion 拉取本周项目计划
   • 从 Linear 获取我负责的待办
2. 检查执行日志中是否出现对应服务调用。
3. 结果可复现后，再进入下一服务接入。

常见问题

1) 点了 + 但没出现在已连接列表

• 先点 刷新。
• 用 搜索服务 精确查找。
• 重新授权一次，确认授权账号和当前工作区一致。

2) 显示已连接但调用失败

• 多数是权限范围不足：补齐读权限后重试。
• MCP 类服务优先检查目标服务端是否在线。
• 本地服务优先检查本地应用是否启动、路径是否可访问。

3) 新建服务时对话卡住

• 先改短指令，只保留单目标描述，一次只做一件事。
• 关闭自动执行，分步确认生成动作。
• 先创建最小可用版本，再增量加权限和能力。