For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /api/agent-mcp.md.
  • 简体中文
  • 让其他程序通过 Agent MCP 调用 Octop 专家

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

    专家页面

    专家

    Streamable HTTP 端点:

    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 提交一个允许的决定。续跑后可能再次要求审批。

    客户端配置示例

    {
      "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 — 用 REST 管理专家
    • 连接器 — 把外部 MCP 工具接到 Octop 里(方向相反)