ateam-mcp

ateam-mcp

让任何 AI 都能构建、验证并部署用于生产环境的多 Agent 系统。

这是一个 MCP 服务，可将 AI 助手——ChatGPT、Claude、Gemini、Copilot、Cursor、Windsurf，以及任何兼容 MCP 的环境——直接连接到 ADAS 平台。

AI 开发者说 “为我构建一个带订单跟踪和升级处理的客户支持系统”，他们的 AI 助手就会处理整个生命周期：读取规格说明、构建技能定义、进行验证、部署到生产环境并确认运行状态。无需手动编写 JSON、查阅文档或复制粘贴工作流。

为什么这很重要

如今，构建多 Agent 系统需要深入了解平台、手动配置，并在文档、编辑器和仪表板之间来回切换。ateam-mcp 消除了这一切，让开发者日常使用的 AI 工具原生具备 ADAS 平台的能力。

AI 助手将成为开发者的操作界面：

Developer: "Create an identity verification agent that checks documents,
            validates faces, and escalates fraud cases"

AI Assistant:
  → reads ADAS spec (adas_get_spec)
  → studies working examples (adas_get_examples)
  → builds skill + solution definitions
  → validates iteratively (adas_validate_skill, adas_validate_solution)
  → deploys to production (adas_deploy_solution)
  → verifies everything is running (adas_get_solution → health)

Developer: "Add a new skill that handles address verification"

AI Assistant:
  → deploys into the existing solution (adas_deploy_skill)
  → redeploys (adas_redeploy)
  → confirms health

无需切换上下文，无需手动操作。完整的 ADAS 平台——规格说明、验证、部署、监控——都能通过自然语言使用。

它如何触达 AI 社区

ChatGPT 用户

ChatGPT 在开发者模式下支持 MCP 连接器。用户只需粘贴一个 URL 即可连接：

Settings → Connectors → Developer Mode → 粘贴 https://mcp.ateam-ai.com

就这么简单。ChatGPT 中会显示全部 12 个 ADAS 工具。任何 ChatGPT Pro、Plus、Business 或 Enterprise 用户都可以通过对话构建并部署多 Agent 解决方案。

Claude 用户

claude.ai 和 Claude Desktop——添加托管连接器：打开 Customize > Connectors（Claude Desktop：在侧边栏中选择 Customize，然后选择 Connectors），点击 Add custom connector，输入 https://mcp.ateam-ai.com，然后点击 Connect。浏览器会打开 A-Team 登录页面，并要求提供工作区密钥：从 app.ateam-ai.com/connect 复制密钥（需由工作区所有者或管理员提供），然后粘贴到该页面。密钥决定所使用的工作区；如需切换，请先断开连接，再使用另一个工作区的密钥重新连接。

Claude Code——托管连接器，登录方式相同：

claude mcp add --transport http ateam https://mcp.ateam-ai.com

然后运行 /mcp，并在浏览器中完成身份验证。

切勿在聊天中粘贴密钥。ateam_bootstrap 的 session 字段会说明会话所属的工作区，以及如何切换工作区。

Cursor / Windsurf / VS Code（Copilot）

将托管服务添加到 .cursor/mcp.json、mcp_config.json 或 .vscode/mcp.json：

{
  "mcpServers": {
    "ateam": { "url": "https://mcp.ateam-ai.com/mcp" }
  }
}

支持 OAuth 的客户端会打开 A-Team 登录页面；不支持 OAuth 的客户端则会从自身配置中通过 Authorization: Bearer <key> 发送密钥（见下文）。本地进程（npx -y @ateam-ai/mcp）只能通过 ateam_auth 登录：其环境中的 ADAS_API_KEY 不会使其登录。

Gemini 和其他平台

随着 MCP 的普及（现由 Agentic AI Foundation 管辖，该基金会隶属 Linux Foundation，由 Anthropic、OpenAI 和 Block 共同创立），每个实现 MCP 的 AI 平台都会自动获得对 ateam-mcp 的访问权限。远程 HTTP 端点（https://mcp.ateam-ai.com，也可通过 /mcp 访问）适用于任何支持 Streamable HTTP 传输的客户端。

每次请求都必须携带凭据：使用 OAuth（支持 OAuth 的客户端会自行响应 401 挑战），或通过 Authorization: Bearer <key> 发送 A-Team API 密钥。匿名请求会被拒绝并返回 401；自 0.4.93 起，不再提供可用于调用 ateam_auth 的匿名会话。请参阅 CHANGELOG.md。

发现方式

开发者可以通过以下渠道发现 ateam-mcp：

• npm — npm search mcp ai-agents → @ateam-ai/mcp
• 官方 MCP Registry — registry.modelcontextprotocol.io
• Claude Desktop 扩展 — 内置扩展浏览器
• Claude Code 插件市场 — /plugin → Discover 标签页
• Windsurf MCP 市场 — 内置市场
• VS Code MCP Gallery — 扩展视图
• 社区目录 — Smithery、mcp.so、PulseMCP（合计超过 30,000 个收录）

可用工具

工具	功能
adas_get_spec	阅读 ADAS 规范——技能架构、解决方案架构、枚举、Agent 指南
adas_get_examples	获取完整的可运行示例——技能、连接器、解决方案
adas_validate_skill	通过 5 阶段管道验证技能定义
adas_validate_solution	验证解决方案——跨技能契约 + 质量评分
adas_deploy_solution	将完整解决方案部署到生产环境
adas_deploy_skill	将技能添加到现有解决方案
adas_deploy_connector	将连接器部署到 ADAS Core
adas_list_solutions	列出所有已部署的解决方案
adas_get_solution	检查解决方案——定义、技能、运行状况、状态、导出
adas_update	增量更新解决方案或技能（PATCH）
adas_redeploy	推送更改使其生效——重新生成 MCP 服务并部署到 ADAS Core
adas_solution_chat	与 Solution Bot 对话，获取修改指导
ateam_workspace_open	对于没有 Shell 的聊天 Agent：为对话打开一个私有工作区（文件位于 /workspace）
ateam_workspace_exec	在工作区中运行一条命令（前台运行 100 s；长时间构建使用 run_in_background）
ateam_workspace_status	检查工作区：未保存的更改、长时间保存操作或后台命令
ateam_workspace_save	使工作区中的更改生效（其他工具只能通过此方式查看更改）
ateam_workspace_close	完成操作；可选择先保存。重新启用工作区打开期间不可用的单文件写入工具

登录后会列出 ateam_workspace_* 工具。如果平台无法为你提供工作区（例如试用工作区，或未关联任何用户的密钥），调用本身会拒绝请求，此时请改用单文件工具。

设置

# Clone
git clone https://github.com/ariekogan/ateam-mcp.git
cd ateam-mcp

# Install
npm install

# Run (a local stdio process)
npm start

本地进程通过 ateam_auth 登录，所用工作区密钥由 Agent 从聊天之外的文件中读取；环境中的 ADAS_API_KEY 不会使其登录，也不会被发送。其环境中的 ADAS_API_URL 指向可自托管的 API。大多数人会改用托管连接器（见上文）。

架构

┌─────────────────────────────────────────────┐
│  AI Environment                             │
│  (ChatGPT / Claude / Cursor / Windsurf)     │
│                                             │
│  Developer: "build me a support system"     │
└──────────────────┬──────────────────────────┘
                   │ MCP protocol
                   │ (stdio or HTTP)
┌──────────────────▼──────────────────────────┐
│  ateam-mcp                                  │
│  12 tools — spec, validate, deploy, manage  │
└──────────────────┬──────────────────────────┘
                   │ HTTPS
                   │ X-ADAS-TENANT / X-API-KEY
┌──────────────────▼──────────────────────────┐
│  ADAS External Agent API                    │
│  api.ateam-ai.com                           │
└──────────────────┬──────────────────────────┘
                   │
┌──────────────────▼──────────────────────────┐
│  ADAS Core                                  │
│  Multi-agent runtime                        │
└─────────────────────────────────────────────┘

许可证

MIT