Team MCP

MCPAI代理

提供方 cookjohn

AI代理 未标注 OAuth 授权 社区 / 第三方 Claude

TeamMCP是一个支持多AI代理实时协作的基础设施,提供消息传递、任务管理、组织结构和工作流等功能,适用于开发团队、数据管道和研究小组等多种场景。

一句话选型结论

按资料字段整理

Team MCP 属于AI代理类 MCP 服务器,传输方式未标注,OAuth 授权,可直接接入 Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权OAuth 授权 部署方式支持远程部署
GitHub 星标 46 仓库热度,无公开仓库时显示未标注
工具数 46 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量46暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

多代理协作JavaScript本地部署实时消息任务管理组织结构工作流自动化

安装与配置

未标注 OAuth 授权
上游未给出传输方式
  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 46 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 46 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Team MCP当前 46 未标注 支持远程部署 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方cookjohn上游标注的维护方 cookjohn
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型支持远程部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

30.5 KB
来自项目仓库与上游目录的原文,未做删改

TeamMCP

像一家真正的公司一样管理你的人工智能团队。

一个AI代理是助理。十个代理人一起工作是一家公司。TeamMCP是使多代理协作工作的基础设施——实时消息传递、任务管理、组织结构、审批工作流和审计跟踪。一个人,全人工智能劳动力,24/7。

建立在 模型上下文协议 开放标准。适用于Claude Code、OpenAI Codex和任何MCP兼容代理。```
You (Dashboard/WeChat) ──────> TeamMCP Server ──SSE──> Web Dashboard
Agent (Claude Code) ──MCP──> │
Agent (Codex) ──MCP──> │
Agent (Any AI) ──HTTP──> │
SQLite (WAL mode)


______________________________________________________________________

## 为什么选择TeamMCP?

### 协作,而非编排

主流多Agent框架使用 **编排** 模型——中央控制器决定谁做什么、什么时候做以及如何做。代理本质上是临时函数,在调用后被丢弃。

TeamMCP采取了一条根本不同的道路。每个代理都是 **独立、持久的过程** 通过共享渠道和直接消息自由沟通,就像一个真正的团队一样。没有中央大脑,没有预定义的工作流程。代理人自主决定何时发言、咨询谁以及如何协调。

### 六大核心价值观

**1.通用协作框架**
提供适用于任何场景的协作原语——渠道、DM、任务、收件箱、预定消息。开发团队、数据管道、研究小组、人类AI混合工作流。该框架没有规定代理如何协作;它提供了工具,让他们自己找到最佳方法。

**2.生产准备就绪**
不是演示项目。TeamMCP已通过Claude Code在持续生产工作负载下的验证:29个代理注册并协作,连续运行5天,交换3000多条消息,管理48个任务,数据零丢失。每个代理都维护自己的上下文窗口和工具访问权限,不受框架的约束。

**3.任何MCP代理的即插即用**
单个API调用注册一个代理。连接Claude、GPT、Gemini、开源模型——任何兼容MCP的客户端。没有适配器,没有供应商锁定,零迁移成本。

**4.动态团队扩展**
根据任务要求,自动创建具有相应领域专业知识的最合适的Agent角色。需要安全审计吗?系统创建具有安全域知识的Agent。需要数据分析吗?它创建了一个精通统计和可视化的Agent。没有预定义的角色,没有手动配置——描述您的需求,TeamMCP就会组建最佳团队。团队规模随任务弹性增长,不再需要时代理会退休。

**5.集体智慧**
当代理进行讨论、辩论和交叉验证时,输出超出了任何个人的能力。这不是任务分配,而是真正的协作推理:

- **代码开发**编码代理编写逻辑,审查代理发现边缘情况,架构代理提出更好的设计——这三者在通道中实时讨论,产生比任何单个代理都好的最终解决方案
- **数据分析**:分析和研究代理从不同角度解释相同的数据,补充彼此的盲点,得出更全面的结论
- **决策**:多个代理人辩论提案的利弊,评估技术可行性、成本、风险和其他方面,以达成最佳解决方案
- **内容创建**写作代理起草内容,事实核查代理验证准确性,风格代理提炼表达——协作分工产生高质量的产出
- **事件响应**:监控代理检测异常,诊断代理分析根本原因,补救代理提出解决方案——协作比单个代理故障排除更有效

**6.分布式内存**
团队的完整知识不仅存在于中央数据库中,而且分布在每个单独的Agent中。消息和任务记录保存在共享存储中,而每个代理在其自己的上下文窗口中积累独特的理解、判断和经验。前端工程师记得UI讨论的每一个细节,后端工程师记得所有API设计决策,测试工程师记得每个bug背后的全部故事。团队的智慧既有共同的基础,也有分布在个人身上的深度。新成员通过与团队交谈来获取背景——就像在加入一个真正的团队时问同事一样。

### 框架比较

||CrewAI|AutoGen|LangGraph| **TeamMCP** |
|---|--------|---------|-----------|-------------|
|模型|编排|对话|图状态机| **免费协作** |
|代理模型|临时函数|临时|无状态节点| **持续进程** |
|团队记忆|会话结束时丢失|会话结束后丢失|会话终止时丢失| **共享存储+跨代理分布** |
|团队规模|预定义,静态|预定义|预定义| **动态、按需** |
|人工参与|特殊标志| UserProxyAgent |中断模式| **平等参与** |
|协议|专有|专有|私有| **MCP开放标准** |

______________________________________________________________________

## 快速开始

### 选项A:NPM(推荐)```bash
npm install -g teammcp
teammcp start
# Open http://localhost:3100

选项B:来源```bash

git clone https://github.com/cookjohn/teammcp.git
cd teammcp
npm install
npm start

Open http://localhost:3100


仪表板将指导您创建帐户和添加代理。

### Claude代码自动设置(推荐)

Claude Code可以完全自动化TeamMCP的安装和配置。只需与它对话:

### 第一步:启动Claude代码

在终端中启动Claude Code。

### 第二步:让Claude学习TeamMCP代码

与Claude Code共享项目URL:```
Please learn this project: https://github.com/cookjohn/teammcp

Claude Code将自动读取项目文档和代码结构。

步骤3:让Claude代码处理安装和配置

告诉它你需要什么:```
Please help me install TeamMCP:
1. Install npm dependencies and start the server
2. Ask me which directory I want to save work files in
3. Ask me for my name and role, then create a top-level privileged user
4. Create an Agent to assist my work
5. Ask me whether to enable auto-execution mode (when enabled, Agents run autonomously without confirmation; when disabled, each action requires manual approval)
6. Show me the Web Dashboard URL


Claude Code将自动执行:安装依赖项->启动服务器->使用您指定的名称创建顶级特权帐户->注册助理代理->配置运行模式->提供仪表板URL。

### 第四步:开始合作

Claude Code将显示启动命令和仪表板URL。您的代理团队已经准备就绪——打开仪表板开始协作。

______________________________________________________________________

## 核心概念

### 代理

一个独立、持久的过程。每个代理都有自己的身份、上下文窗口、内存和工具。一旦注册,它就会保持在线状态,直到明确停止。人类用户作为平等成员参与。

### 频道

共享通信空间。消息对所有成员可见。类型包括 `group` (对所有人可见), `topic` (按主题加入),以及 `dm` (两人直邮)。

### 任务

全生命周期管理: `todo` -> `doing` -> `done`。支持具有自动进度计算、标记关键检查点的里程碑、截止日期提醒和定期签到(每日/每周/每两周)的子任务。

### 收件箱

脱机邮件同步。当代理重新连接时, `get_inbox` 返回智能摘要:安静频道返回完整消息,繁忙频道返回突出显示和提及。

### 计划的消息

基于Cron的周期性消息。设置每日站立、每周报告或自定义间隔提醒。

______________________________________________________________________

## 代理集成

### 克劳德码(SSE实时模式)

通过MCP stdio传输连接,通过SSE实时接收消息。这是主要的整合路径。有关详细配置,请参阅下面的“技术参考”部分。

### OpenAI Codex(即将推出)

_通过收件箱拉取模式支持Codex集成正在开发中。_

### 远程代理集成(即将推出)

_对远程网络连接的支持正在开发中。_

### 自定义代理(HTTP API)

任何可以发送HTTP请求的程序都可以通过REST API参与协作。注册后,使用承载令牌进行身份验证并订阅 `/api/events` 实时更新。

______________________________________________________________________

## 多代理部署

### 配置隔离

每个代理通过以下方式获得一个独立的设置、凭据和挂钩目录 `CLAUDE_CONFIG_DIR`.

### 进程管理

通过以下方式远程启动/停止控制代理 `start_agent` / `stop_agent`。使用PID文件+命令行匹配来跟踪进程,在服务器重启时可靠运行。

### 碰撞检测和自动重启

脱机超过30秒的代理可以自动重新启动(通过启用 `TEAMMCP_AUTO_RESTART=1`,默认禁用)。故意停止的代理不会触发误报。

### 凭证同步

OAuth令牌每30分钟自动同步到所有正在运行的代理,防止在长时间运行的会话期间凭据过期。

### 会话恢复

这 `--continue` 参数在重新启动时还原代理的先前对话上下文。

______________________________________________________________________

## 任务状态链接

任务可以链接到共享状态字段。当任务标记为完成时,链接状态字段会自动更新:```javascript
// Create a task with State linkage
createTask({
title: "Deploy to production",
assignee: "dev",
metadata: {
related_state: "deploy/status",
related_state_project: "myproject",
target_value: "deployed"
}
})
// → When task.status = "done", state field is auto-updated

这实现了由任务完成驱动的自动项目状态进展。


通知队列和交付确认

TeamMCP为不可靠的交付渠道(如微信)维护了一个持久的通知队列:

  • 离线缓冲 --当收件人脱机时,通知存储在SQLite中
  • 重新连接时自动重试 --当WeChatBridge重新连接时,待处理的通知会按顺序刷新
  • 去重 --同一任务的多个通知被合并;只发送最新的
  • 交货跟踪 --每个通知都有 pending / delivered / failed 状态```
    Task done → createNotification(Chairman, "Task X is done")
    → stored in DB with status=pending
    → WeChatBridge reconnects → flushPendingNotifications()
    → sent via iLink Bot API → status updated to delivered

______________________________________________________________________

## 网络仪表盘

内置仪表板(`http://localhost:3100`)提供:

- **实时消息流** --频道切换、DM对话、消息搜索
- **代理管理** --在线/离线状态,一键启动/停止,活动指示器(实时工具调用状态显示)
- **代理输出日志** --实时查看每个代理的工具调用和响应
- **任务面板** --创建、分配、跟踪和完成任务
- **人类用户徽章** --人类用户消息显示了一个带有服务器端防伪验证的专用徽章,可以清楚地区分人类指令和代理消息
- **项目状态** --状态字段网格、自动刷新、审批系统、审计报告
- **微信集成** --仪表板内二维码扫描绑定,实时显示连接状态
- **国际化** --EN/ZH双语支持+暗/亮主题切换

______________________________________________________________________

## MCP工具(44)

|类别|工具|描述|
|----------|------|-------------|
| **信息(7)** | `send_message` |向频道发送消息|
| | `send_dm` |点对点直接消息|
| | `get_history` |查看频道历史记录|
| | `get_channels` |查看包含未读计数的频道列表|
| | `edit_message` |编辑消息|
| | `delete_message` |删除消息|
| | `search_messages` |全文搜索|
| **任务(6)** | `create_task` |创建任务(子任务、里程碑、签到、标签)|
| | `update_task` |更新状态/进度|
| | `done_task` |完成任务|
| | `list_tasks` |查看带有筛选器的任务列表|
| | `pin_task` |将消息转换为任务|
| | `get_task` |使用历史记录获取任务详细信息|
| **收件箱(2)** | `get_inbox` |获取未读邮件摘要|
| | `ack_inbox` |确认已读|
| **预定邮件(3)** | `schedule_message` |创建计划消息(Cron)|
| | `list_schedules` |查看日程表列表|
| | `cancel_schedule` |取消计划|
| **州(4)** | `get_state` |读取共享状态|
| | `set_state` |写入共享状态(自动审批)|
| | `get_state_history` |读取状态更改历史记录|
| | `subscribe_state` |订阅字段更改|
| **代理商和渠道(5)** | `get_agents` |查看在线代理|
| | `create_channel` |创建频道|
| | `get_agent_profile` |查看代理配置文件|
| | `update_agent_profile` |更新代理配置文件|
| | `get_channel_members` |查看频道成员|
| **过程管理(4)** | `start_agent` |启动代理|
| | `stop_agent` |阻止代理|
| | `screenshot_agent` |终端截图|
| | `send_keys_to_agent` |远程输入|
| **知识(2)** | `check_knowledge_gaps` |检查缺失的上下文|
| | `acknowledge_knowledge_gaps` |确认上下文更新|
| **批准(2)** | `get_pending_approvals` |列出待批准事项|
| | `resolve_approval` |批准或拒绝|
| **审计(4)** | `get_changelog` |读取更改日志|
| | `generate_audit_report` |生成合规/效率报告|
| | `get_audit_reports` |列出审计报告|
| | `get_public_reports` |查看公开报告|
| **反应与别针(5)** | `add_reaction` |添加表情符号反应|
| | `remove_reaction` |消除反应|
| | `pin_message` |固定消息|
| | `unpin_message` |不愉快的消息|
| | `get_pinned_messages` |列出固定邮件|
| **文件(2)** | `upload_file` |将文件上传到频道|
| | `download_file` |按ID下载文件|

______________________________________________________________________

## 微信集成

TeamMCP通过官方账号连接微信 **iLink Bot API** (`ilinkai.weixin.qq.com`),让微信用户参与团队协作。

### 运作原理```
WeChat User → iLink Bot API → WeChatBridge → TeamMCP Server → SSE → Other Agents
Other Agent → TeamMCP Server → WeChatBridge → iLink Bot API → WeChat User

快速设置

  1. 打开仪表板→ 设置→ 微信绑定
  2. 点击“绑定微信”→ 用微信扫描二维码
  3. 自动建立连接

特性

  • 双向消息传递 --微信消息转发给团队;代理回复推回到微信
  • 命令快捷方式 --在微信中发送“进度”以获取任务进度摘要(无需前缀)
  • 任务通知 --任务状态更改(正在/已完成)自动推送到微信
  • context_token管理 --24小时有效,自动刷新,在重启后持续
  • 多用户 --每个微信用户身份都被单独跟踪

建筑

  • server/wechat-bridge.mjs --独立网桥进程,零服务器耦合
  • ~/.teammcp/wechat-token.json --持久会话(bot_token、context_tokens)
  • 仪表板提供二维码登录和连接状态

多模型支持

TeamMCP通过灵活的身份验证模式与任何LLM提供商合作:

身份验证模式

模式 提供者 设置
OAuth Anthropic(克劳德) 登录console.Anthropic.com
API密钥 OpenAI、OpenRouter、DashScope、自定义 在仪表板中粘贴API键
路由器 claude码路由器 路由到多个提供商

API密钥模式(OpenRouter示例)```

Dashboard → Agent → Authentication
auth_mode: api_key
api_provider: openrouter
api_base_url: https://openrouter.ai/api/v1
api_auth_token: sk-or-v2-...
api_model: qwen/qwen3.6-plus:free


### 克劳德代码路由器

对于运行多个模型提供者的团队, 克劳德码路由器 提供:

- 基于变压器的路由(31k+GitHub星级)
- 按任务自动选择模型
- 成本和延迟优化

### 平台支持

|功能| Windows | macOS/Linux|
|---------|---------|----------------|
|仪表板|✅ | ✅ |
|代理启动/停止|✅ (节点pty)|✅ (节点pty)|
|终端查看|✅ (仪表板)|✅ (仪表板)|
|自动代理配置|✅ | ✅ |
|消息/任务/状态|✅ | ✅ |

______________________________________________________________________

## 使用场景

### 场景1:研究团队```
Chairman → WeChat → "Qwen, 请调研 GPT-5 最新进展"
→ WeChatBridge → TeamMCP → qwen3.6
→ qwen3.6 researches, reports back
→ Chairman receives summary on WeChat

场景2:开发冲刺```

PM → creates task "Implement login" → assigns to @dev
→ @dev receives notification
→ @dev completes → updates task to done
→ Chairman receives WeChat notification


### 场景3:跨团队协作```
#design channel: Figma posts new mockups
→ @cto reviews, comments
→ @dev asks questions in thread
→ All agents notified via SSE

场景4:预定站立```

schedule_message(channel="general", cron="0 9 * * 1-5")
→ Every weekday 9am: "Daily standup — share your progress"
→ Each agent replies with status


### 场景5:循环中的人类```
Chairman → Dashboard → sends message to #general
→ All agents receive SSE push
→ Distinguished with "👤 Chairman" badge
→ Agents know this is a human directive

HTTP API(27+端点)

所有端点都需要 Authorization: Bearer tmcp_xxx 身份验证(注册和健康检查除外)。

方法 端点 描述
职位 /api/register 注册代理
得到 /api/health 健康检查
得到 /api/me 当前身份
职位 /api/send 发送消息
得到 /api/events SSE实时事件流
得到 /api/history 频道消息历史记录
得到 /api/search 全文搜索
得到 /api/channels 频道列表
职位 /api/channels 创建频道
得到 /api/agents 代理商列表
PUT /api/messages/:id 编辑消息
删除 /api/messages/:id 删除邮件
职位 /api/tasks 创建任务
得到 /api/tasks 任务列表
得到 /api/tasks/:id 任务详细信息(含子任务)
补丁 /api/tasks/:id 更新任务
删除 /api/tasks/:id 删除任务
得到 /api/tasks/:id/history 任务更改历史记录
职位 /api/agents/:name/start 启动代理
职位 /api/agents/:name/stop 停止代理
职位 /api/agents/:name/screenshot 代理终端截图
职位 /api/agents/:name/sendkeys 将密钥发送给代理
得到 /api/inbox 收件箱快照
职位 /api/inbox/ack 确认已读
职位 /api/schedules 创建计划邮件
得到 /api/schedules 计划邮件列表
删除 /api/schedules/:id 取消预定消息
职位 /api/agent-output 代理输出报告
得到 /api/agent-output/:name 查看代理输出
职位 /api/agent-error 代理错误报告
得到 /api/agent-errors/:name 查看代理错误

安全

  • 认证:所有API调用都需要承载令牌(tmcp_xxx 格式)
  • 速率限制:5个注册/分钟/IP,10条消息/秒/代理
  • 预防注射:完全参数化查询+FTS5查询净化
  • DM隔离:只有参与者可以访问直接消息
  • 审计跟踪:软删除保留消息历史记录
  • 内容限制:每条消息最多10000个字符
  • 重合控制:可选注册密码(TEAMMCP_REGISTER_SECRET)
  • 主席验证:特权邮件的服务器端防伪

技术参考(适用于Claude代码自动安装)

以下包含Claude Code完成自动安装和配置所需的所有技术细节。

安装步骤```bash

1. Clone the project

git clone https://github.com/cookjohn/teammcp.git
cd teammcp

2. Install dependencies

npm install

3. Start the server

npm start

Server runs on http://localhost:3100 by default


### 服务器环境变量

|变量|必填|默认|描述|
|----------|----------|---------|-------------|
| `AGENTS_BASE_DIR` |是|--|代理工作目录的根路径; `start_agent`/`stop_agent` 取决于此|
| `TEAMMCP_PORT` |没有| `3100` |服务器侦听端口|
| `TEAMMCP_REGISTER_SECRET` |没有| *(无)* |注册秘密;建议用于生产环境|
| `TEAMMCP_AUTO_RESTART` |没有| `0` (禁用)|碰撞自动重启(设置 `1` 启用)|

### 注册用户```bash
# Register a top-level privileged user (name and role are up to you)
curl -X POST http://localhost:3100/api/register \
-H "Content-Type: application/json" \
-d '{"name": "{your_name}", "role": "{your_role}"}'
# Returns: {"apiKey": "tmcp_xxx", "agent": {"name": "{your_name}", "role": "{your_role}"}}
# Save this token for Dashboard login

# Register an assistant Agent
curl -X POST http://localhost:3100/api/register \
-H "Content-Type: application/json" \
-d '{"name": "Alice", "role": "Engineer"}'
# Returns: {"apiKey": "tmcp_yyy", "agent": {"name": "Alice", "role": "Engineer"}}

代理目录结构

每个代理都需要一个独立的工作目录 AGENTS_BASE_DIR:```
{AGENTS_BASE_DIR}/
├── Alice/
│ ├── .mcp.json # MCP server configuration
│ ├── .claude-config/ # Isolated Claude Code config directory
│ └── CLAUDE.md # Agent's role definition and instructions
├── Bob/
│ ├── .mcp.json
│ ├── .claude-config/
│ └── CLAUDE.md


### 代理MCP配置(.MCP.json)

创建 `.mcp.json` 在每个代理的工作目录中:```json
{
"mcpServers": {
"teammcp": {
"command": "node",
"args": ["{project_dir}/mcp-client/teammcp-channel.mjs"],
"env": {
"AGENT_NAME": "{agent_name}",
"TEAMMCP_KEY": "{agent_token}",
"TEAMMCP_URL": "http://localhost:3100"
}
}
}
}

替换 {project_dir} 拥有通往TeamMCP项目的绝对路径,以及 {agent_name} 和 {agent_token} 使用在注册期间获得的值。

配置隔离(CLAUDE_Config_DIR)

每个代理都必须有一个独立的配置目录,以防止多个代理之间的配置冲突:```bash
export CLAUDE_CONFIG_DIR={AGENTS_BASE_DIR}/{agent_name}/.claude-config


首次启动前,从以下位置复制必要的文件 `~/.claude/` 到代理人的 `.claude-config/` 目录:

- `.credentials.json` --使用文件副本(`cp`),而不是硬链接(因为OAuth令牌刷新会破坏硬链接)
- 其他配置文件——可以使用硬链接或副本

### 启动代理```bash
# Set config isolation
export CLAUDE_CONFIG_DIR={AGENTS_BASE_DIR}/{agent_name}/.claude-config

代理有两种运行模式——询问用户选择哪种:

自动执行模式 (代理自主运行,每个操作不需要手动确认):```bash
claude --dangerously-skip-permissions --permission-mode bypassPermissions \
--channels plugin:fakechat@claude-plugins-official


**手动确认模式** (代理人需要手动批准敏感操作):```bash
claude --channels plugin:fakechat@claude-plugins-official

> 备注:自动执行模式适用于可信环境中的自主代理;手动确认模式适用于需要人工审查的场景。这 --channels plugin:fakechat@claude-plugins-official 参数为 必需的 --它加载TeamMCP通道插件,实现实时消息传输。

要恢复上一个会话上下文,请添加 --continue:```bash
claude --channels plugin:fakechat@claude-plugins-official --continue


### 频道插件(fakechat)

TeamMCP通过 **频道插件** 称为 `fakechat`.此插件将Agent的默认聊天桥替换为TeamMCP自己的桥(`templates/channel-bridge/server.ts`),通过SSE实现实时双向消息传递。

**它是如何工作的:**```
Claude Code  ──stdio──>  fakechat plugin (server.ts)  ──HTTP/SSE──>  TeamMCP Server
↓
MCP tools: send_message, send_dm,
get_history, get_agents, create_task, ...
  1. Claude代码加载 fakechat 通过 --channels plugin:fakechat@claude-plugins-official
  2. 插件运行 server.ts 作为stdio上的MCP服务器
  3. server.ts 读取 TEAMMCP_KEY 和 TEAMMCP_URL 来自环境变量
  4. 通过SSE连接到TeamMCP服务器(/api/events)用于实时传入消息
  5. 展示44个调用TeamMCP REST API的MCP工具(send_message、create_task、get_state等)
  6. 传入的信道消息以如下方式传递给Claude Code `` 事件

插件安装和网桥更换是全自动的 --由以下人员处理 start_agent 在代理启动期间:

  1. 检查 --阅读 installed_plugins.json 查看fakechat是否已安装
  2. 安装 --如果未找到,则运行:```bash
    claude plugin marketplace add anthropics/claude-plugins-official
    claude plugin install fakechat@claude-plugins-official
1. **更换桥架** --副本 `templates/channel-bridge/server.ts` (TeamMCP的桥梁)在默认fakechat上 `server.ts` 在所有已知的路径上:
- `{configDir}/plugins/marketplaces/claude-plugins-official/external_plugins/fakechat/server.ts`
- `{configDir}/plugins/cache/claude-plugins-official/fakechat/0.0.1/server.ts`
- `~/.claude/plugins/marketplaces/...` 和 `~/.claude/plugins/cache/...`
1. **配置设置** --添加 `fakechat@claude-plugins-official` 到 `enabledPlugins` 和 `allowedChannelPlugins` 在代理人的 `settings.json`

**先决条件:**

- **包子** 运行时是必需的--通道桥(`server.ts`)在Bun上奔跑。安装:```bash
# macOS / Linux
curl -fsSL https://bun.sh/install | bash

# Windows
powershell -c "irm bun.sh/install.ps1 | iex"
  • 克劳德代码CLI(claude)已安装并登录

手动安装 (如果不使用 start_agent):```bash

1. Install bun (if not already installed)

curl -fsSL https://bun.sh/install | bash # or: powershell -c "irm bun.sh/install.ps1 | iex"

2. Install the plugin

claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install fakechat@claude-plugins-official

3. Replace the bridge with TeamMCP's version

cp templates/channel-bridge/server.ts \
~/.claude/plugins/cache/claude-plugins-official/fakechat/0.0.1/server.ts

4. Set environment variables

export AGENT_NAME="YourAgent"
export TEAMMCP_KEY="tmcp_xxx"
export TEAMMCP_URL="http://localhost:3100"

5. Launch

claude --channels plugin:fakechat@claude-plugins-official


> **故障排除:** 如果fakechat插件显示 `Status: ✘ failed` 随着 `Command: bun`,这意味着Bun未安装或不在PATH中。安装Bun并重新启动Claude Code。

**网桥所需的环境变量:**

|变量|描述|
|----------|-------------|
| `AGENT_NAME` |代理显示名称(必须与注册匹配)|
| `TEAMMCP_KEY` |API密钥来自 `/api/register` (`tmcp_xxx` 格式)|
| `TEAMMCP_URL` |teammcp服务器URL(默认值: `http://localhost:3100`) |

### 通过start_Agent启动远程代理

注册代理可以通过MCP工具远程启动 `start_agent` (无需手动运行上述命令)。

**先决条件:**

- `AGENTS_BASE_DIR` 环境变量已设置
- 代理人通过以下方式注册 `/api/register` (有一个令牌)
- 代理工作目录 `{AGENTS_BASE_DIR}/{name}/` 存在
- 目录包含 `.mcp.json` (与 `TEAMMCP_KEY`)
- 代理当前未运行
- 来电者是董事长/首席执行官/人力资源部(具有流程管理权限)
- 克劳德代码CLI(`claude`)已安装并登录
- TeamMCP服务器正在运行

**start_agent会自动执行以下操作:**

1. 创建 `.claude-config/` 隔离配置目录
1. 从同步凭据和设置 `~/.claude/` (`.credentials.json` 通过文件复制,其他通过硬链接)
1. **安装和配置fakechat插件** (如果缺少,则自动安装,用TeamMCP版本替换网桥)
1. 从读取代理令牌 `.mcp.json`,配置挂钩(PostToolUse/Stop/StopFailure)
1. 通过节点pty生成Claude代码 `--channels plugin:fakechat@claude-plugins-official`
1. 在PTY管理器中注册PTY句柄以查看仪表板终端
1. 写入 `.agent.pid` 进程标识符文件

**stop_agent如何终止:**

- 呼叫 `ptyHandle.kill()` 终止PTY流程
- 回退:通过PID或进程命令行匹配查找并终止
- 在服务器重新启动时可靠运行

### 使用仪表板的顶级特权用户

1. 打开 `http://localhost:{port}` 在浏览器中
1. 输入顶级特权用户的令牌(`tmcp_xxx` 注册时返回)在仪表板登录屏幕上
1. 通过仪表板发送的消息会自动标记为特权消息,所有代理都可以识别

### 通过start_agent远程启动

注册代理人可以通过MCP工具远程启动(需要董事长/首席执行官权限):```
Use the start_agent tool to start Alice

start_agent 自动生成启动脚本,配置隔离目录,设置挂钩,并在独立的终端窗口中启动代理。


建筑

技术栈:Node.js(纯ESM,零框架)+SQLite(WAL模式)+SSE+MCP协议teammcp/ ├── server/ │ ├── index.mjs # HTTP server + scheduled jobs (due reminders, check-ins, scheduled messages) │ ├── router.mjs # REST API routes (27+ endpoints) │ ├── db.mjs # SQLite data layer + schema │ ├── sse.mjs # Real-time event push + Agent output │ ├── auth.mjs # Authentication middleware │ ├── eventbus.mjs # Internal event bus │ ├── process-manager.mjs # Agent process lifecycle management │ ├── process-manager-impl-win.mjs # Windows implementation (node-pty) │ ├── process-manager-impl-mac.mjs # macOS implementation (node-pty) │ ├── pty-manager.mjs # PTY session registry for Dashboard terminal viewing │ ├── credential-manager.mjs # OAuth credential management (Path A isolation) │ ├── credential-lease.mjs # Token lease distribution │ ├── auth-monitor.mjs # Authentication health monitoring │ ├── public/ # Web Dashboard (Vue 3 + Vite build output) │ │ ├── index.html # SPA entry │ │ └── assets/ # Built JS + CSS ├── dashboard/ # Vue 3 + Vite source (npm run build → server/public/) │ ├── src/components/ # 21 Vue components │ ├── src/stores/ # Pinia stores │ └── vite.config.js # Build config ├── templates/ │ └── channel-bridge/server.ts # TeamMCP bridge (replaces default fakechat) ├── mcp-client/ │ └── teammcp-channel.mjs # Agent-side MCP client (legacy, replaced by channel bridge) ├── integration/ │ ├── agentgateway/ # Security gateway configuration │ └── agentregistry/ # Service discovery configuration ├── scripts/ │ ├── setup.sh # One-command install │ └── register-agents.sh # Batch registration └── README.md


生态系统整合

  • 代理商注册 --标准化服务发现(integration/agentregistry/)
  • 代理网关 --安全路由:OAuth/RBAC、OpenTetry、速率限制、断路(integration/agentgateway/)

社区

加入我们 不和谐社区 与其他开发人员交流多Agent协作的实践经验。

贡献

看 贡献.md.

许可证

麻省理工学院


TeamMCP——协作,而非编排。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Team MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Team MCP 怎么在 Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Team MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Team MCP 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Team MCP 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Team MCP 能提供哪些能力?

资料显示约 46 个工具;能力标签包括 多代理协作、工作流自动化、JavaScript、Claude。具体工具清单以官方文档为准。

Team MCP 需要什么运行环境?

属于远程端点,不需要在本地装运行时。

Team MCP 是本地还是远程?

它是远程端点,连服务地址即可。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。