> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# 让其他程序通过 Agent MCP 调用 Octop 专家

其他程序可以通过 **Agent MCP 网关**调用你已安装的 Octop 专家。鉴权方式与 REST API 相同：带上 JWT。网关没有单独的管理页——在 MCP 客户端里填下面的地址，专家仍在页面中管理。


![专家页面](/images/ui-agents.png "专家")

Streamable HTTP 端点：

```text
POST /api/mcp/agents
GET  /api/mcp/agents
DELETE /api/mcp/agents
```

若地址会暴露到本机以外，请使用 HTTPS。访问令牌默认有效期为 **24 小时**。

## 提供的工具

| 工具                    | 作用                         |
| --------------------- | -------------------------- |
| `list_octop_experts`  | 列出当前账号可见的专家                |
| `call_octop_expert`   | 开一轮独立对话；传入 `thread_id` 可续聊 |
| `resume_octop_expert` | 在需要工具审批或向用户提问后继续           |

`call_octop_expert` 会返回 `thread_id`。请保存在外部程序的状态里。只有下一任务必须沿用同一段 Octop 对话时再传入；新任务请省略。

MCP 对话与页面、CLI、即时通讯会话互相隔离，不能挂到已有的网页对话上。

## 审批

若工具需要审批，会返回 `status: "approval_required"` 和 `approval` 对象。阅读 `approval.request.action_requests` 与 `approval.request.review_configs`，再对每个动作向 `resume_octop_expert` 提交一个允许的决定。续跑后可能再次要求审批。

## 客户端配置示例

```json
{
  "mcpServers": {
    "octop-agents": {
      "type": "streamable_http",
      "url": "http://127.0.0.1:8088/api/mcp/agents",
      "headers": {
        "Authorization": "Bearer <octop-access-token>"
      }
    }
  }
}
```

有的 MCP 客户端用 `http` 而不是 `streamable_http`。令牌获取见[认证](/api/authentication.md)。

## 相关

- [专家 API](/api/agents.md) — 用 REST 管理专家
- [连接器](/api/connectors.md) — 把外部 MCP 工具接到 Octop 里（方向相反）

***
