跳到主要内容

在不同客户端中连接 AgentDock

AgentDock 通过 Streamable HTTP MCP 接入 Claude Desktop、ChatGPT、Claude Code、Cursor、VS Code、Codex、TRAE 和 WorkBuddy。本页示例统一使用：

https://agentdock.example.com/mcp

请把它替换为你自己的 AgentDock MCP 地址。

备注

不同客户端的菜单名称、套餐限制和管理员策略可能调整。本文使用当前常见界面名称；找不到对应入口时，可在设置中搜索 MCP、插件 或 Connectors。

连接前准备​

使用公网客户端或云端服务时，应先确认：

  • AgentDock 已通过公网 HTTPS 域名提供服务。
  • MCP 地址以 /mcp 结尾（例如 https://agentdock.example.com/mcp）。
  • 认证方式已就绪：远程客户端通常需要 OAuth 浏览器授权或通过 HTTP Header 传入 Bearer Token。具体环境变量配置见 OAuth 配置。
  • 反向代理会转发 /mcp、/register、/oauth/* 和 /.well-known/*。

对于与 AgentDock 运行在同一台电脑上的本地客户端，也可以连接：

http://127.0.0.1:8765/mcp

云端客户端无法访问你电脑或服务器的 127.0.0.1。

警告

不要把真实 Bearer Token 或 OAuth 凭据留在 Shell 历史或会进入版本控制的工作区文件中。优先使用客户端的秘密管理能力或受限环境变量。

Claude Desktop​

Claude Desktop 是否支持自定义 MCP，以及可添加的服务器数量，取决于当前套餐和工作区策略。

  1. 打开 Claude Desktop，进入 Customize > Connectors。

  2. 点击 +，选择 Add Connector。

  3. 名称填写 AgentDock。

  4. MCP Server URL 填写：

    https://agentdock.example.com/mcp

  5. 保存后点击 Connect。

  6. 浏览器打开 AgentDock 授权页后，输入 AGENTDOCK_OAUTH_PASSWORD 完成授权。

ChatGPT​

ChatGPT 通过流式 HTTP MCP 连接 AgentDock，要求使用公网 HTTPS 地址并通过浏览器完成 OAuth 授权。自定义 MCP 插件需要在 ChatGPT 设置中开启开发人员模式。

完整图文教程、连接模式与排障说明见 使用 ChatGPT 连接 AgentDock。

Claude Code​

OAuth​

在终端运行：

claude mcp add --transport http agentdock https://agentdock.example.com/mcp

然后在 Claude Code 会话中运行：

/mcp

选择 AgentDock，并按提示在浏览器中完成 OAuth 授权。

Bearer Token​

claude mcp add --transport http agentdock https://agentdock.example.com/mcp \
  --header "Authorization: Bearer YOUR_TOKEN_HERE"

Cursor​

  1. 打开 Cursor，进入 Cursor Settings。
  2. 在左侧选择 Tools & MCP。
  3. 点击 Add Custom MCP。
  4. 编辑项目中的 .cursor/mcp.json：
{
  "mcpServers": {
    "agentdock": {
      "url": "https://agentdock.example.com/mcp"
    }
  }
}

保存后回到 Tools & MCP，找到 AgentDock，点击 Connect，并在浏览器中完成 OAuth 授权。

使用 Bearer Token 时：

{
  "mcpServers": {
    "agentdock": {
      "url": "https://agentdock.example.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

VS Code​

在工作区创建或编辑 .vscode/mcp.json：

{
  "servers": {
    "agentdock": {
      "type": "http",
      "url": "https://agentdock.example.com/mcp"
    }
  }
}

也可以打开命令面板：

Ctrl+Shift+P / Cmd+Shift+P

运行 Add Server，选择 HTTP (HTTP or Server-Sent Events)，输入 AgentDock MCP 地址和服务器 ID，再选择保存到工作区或全局配置。保存后按提示在浏览器中完成 OAuth 授权。

使用 Bearer Token 时：

{
  "servers": {
    "agentdock": {
      "type": "http",
      "url": "https://agentdock.example.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Codex​

Codex App​

  1. 打开 Codex，进入 设置 > 插件 > MCP。

  2. 点击 添加服务器。

  3. 名称填写 AgentDock。

  4. 传输方式选择 流式 HTTP。

  5. MCP Server URL 填写：

    https://agentdock.example.com/mcp

  6. 保存后点击右侧的 进行身份验证，在浏览器中完成 OAuth 授权。

命令行​

codex mcp add agentdock --url https://agentdock.example.com/mcp

命令执行后，按终端提示完成 OAuth 登录和授权。

TRAE​

  1. 打开 TRAE，进入设置。
  2. 在左侧选择 MCP。
  3. 点击 添加 > 手动添加。
  4. 添加以下配置：
{
  "mcpServers": {
    "agentdock": {
      "url": "https://agentdock.example.com/mcp"
    }
  }
}

保存后，在已安装的 MCP Servers 中找到 AgentDock，点击右侧 前往验证，并在浏览器中完成 OAuth 授权。

使用 Bearer Token 时：

{
  "mcpServers": {
    "agentdock": {
      "url": "https://agentdock.example.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

WorkBuddy​

  1. 打开 WorkBuddy，在左侧选择 技能。
  2. 在右侧选择 MCP 服务器。
  3. 点击 配置 MCP。
  4. 添加以下配置：
{
  "mcpServers": {
    "agentdock": {
      "type": "http",
      "url": "https://agentdock.example.com/mcp",
      "disabled": false
    }
  }
}

保存后返回 MCP 列表，找到 AgentDock，点击右侧 连接，并在浏览器中完成 OAuth 授权。

使用 Bearer Token 时：

{
  "mcpServers": {
    "agentdock": {
      "type": "http",
      "url": "https://agentdock.example.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      },
      "disabled": false
    }
  }
}

验证连接​

连接完成后，不要只看客户端显示“已连接”。应完成一次真实只读调用，例如：

调用 AgentDock 的 agentdock_context，告诉我 AgentDock 版本、操作系统、路径模型，以及当前可用的 Skill 和动态 MCP 能力索引。

如果 OAuth 页面没有打开，先验证：

curl -fsS https://agentdock.example.com/.well-known/oauth-authorization-server
curl -fsS https://agentdock.example.com/.well-known/oauth-protected-resource/mcp

如果授权页面返回 302，通常表示 AgentDock 正在跳转回客户端，这是 OAuth 正常流程。页面没有继续跳转时，再检查反向代理是否保留 Location Header，以及客户端回调地址是否被浏览器或网络策略拦截。

完整认证配置见 配置，公网部署见 Linux 手动部署。