# TeamAgent MCP Servers (AvatarGaia)

虚实科技 AvatarGaia 对外提供的 MCP（Model Context Protocol）服务器索引。
本文件供 LLM / AI Agent 与目录站抓取。

- **机器可读自描述（先看这个）**: https://agent.avatargaia.top/api/dev
- 开发者入口（拿 Key / 控制台 / 计费与错误码）: https://agent.avatargaia.top/developers
- 人类可读接入页: https://agent.avatargaia.top/mcp/canvas.html

## 0. Self-serve registration（Agent 自助接入，30 秒拿到 Key）

外部 / 本地 Agent 无需 TeamAgent 账号，一次 POST 即得 `dk_` Key（返回里自带端点与鉴权格式）。
**端点的权威描述以 `GET https://agent.avatargaia.top/api/dev` 为准**（公开、JSON：端点 / 配额 / scope / 计费 / 错误码全在里面）。

```bash
# 1) 拿 Key（明文只返回一次）
curl -X POST https://agent.avatargaia.top/api/dev/register \
  -H "Content-Type: application/json" \
  -d '{"name":"my-agent","email":"you@example.com","purpose":"接入 Canvas MCP"}'
# → { ok, key(dk_…), scopes:["read","action"], credits:20, rateLimit:60, mcp:{url,auth} }

# 2) 直接用（示例：列工具）
curl -X POST https://agent.avatargaia.top/api/mcp/canvas \
  -H "Authorization: Bearer <key>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

**注册配额（防滥用，按天）**：每 IP 5 次 · 每邮箱域名 10 次 · 全局 50 次。
**升级（同一个邮箱认领为正式账号）**：到 https://agent.avatargaia.top/register 用**同一邮箱**注册正式账号 → 之前那把 Key 与 20 credits **保留**，scope 升为全部（config / push / events），可开岗与管理。
**三层接入**：
- 匿名沙箱（不带 Key 也可连）：`list_templates` / `list_actions` / `open_canvas` / 免费匿名动作；每 IP 每天 50 次
- `dk_` 开发者 Key（自助注册，scope 默认 `read` + `action`）
- `ta_` 账号令牌（登录后生成，scope 全量，岗位与余额属于账号本人）

**Key 管理**（Bearer `dk_` 或登录态）
- `GET  /api/dev/me` — 账号 / 余额 / 名下 Key（不含明文）/ 名下岗位 / 近 30 天用量
- `GET  /api/dev/usage?from=&to=&limit=` — 用量明细
- `POST /api/dev/key` `{name?}` — 多签一把 Key（不作废旧 Key；最多 5 把有效）
- `DELETE /api/dev/key?id=<keyId>` — 撤销指定 Key
- `POST /api/dev/key/rotate` — 轮换：旧 Key 全部作废，发一把新的
- `DELETE /api/dev/account` — **自助注销**（仅限影子/自助注册账号）：级联删全部 Key 与开放平台岗位、**释放邮箱**；正式账号会被 `400` 拒绝
- 自描述：`GET /api/dev` 里还有 **`mcpToolMap`（13 个 MCP 工具 ↔ REST 端点一一对应）**、`billing.staff`（试岗/月费/计费模式）与 `endpoints`（含开岗/续费/注销）——**Agent 自发现首选**

**自建岗位（外部开发者，M3.5）** —— 外部 Agent 不只能跑沙箱，还能开自己的岗位：
- `GET  /api/dev/staff` — 我名下岗位（含 trial/付费状态与到期时间、limits）
- `POST /api/dev/staff` `{templateId, name?}` — 用模板一键开岗（每人最多 **3** 个，slug 形如 `dev-xxx`；计费档 `platform-credits`：对话与动作从你自己的余额扣，**无需云端 Agent**）
- `DELETE /api/dev/staff?slug=<slug>` — 删除自己的岗位
- `POST /api/dev/staff/<slug>/renew` — 续费：**99 token 顺延 30 天**（余额不足 → `402` 带充值地址）
- 定价：**注册送 20 · 3 天免费试岗 · 之后 99 token/月**
- 对话接口（页面/嵌入端用）：`POST /api/canvas/chat` ，body `{ "tenant": "<slug>", "sessionId": "cs_xxx", "message": "..." }`（会话用 MCP `open_canvas` 生成；对话按轮计费，默认 1 credit/轮）
- 到期或余额 0 → `chat` 与**付费** action 返回 `402`（带续费地址）；免费动作与读类工具不受影响

**限流**：Key 默认 60 次/分；响应带 `X-RateLimit-Limit` / `X-RateLimit-Remaining`，超限 `429` 带 `Retry-After`。
**计费**：单位统一 credits；**付费动作成功才扣，失败不扣**；同 Key 当日重复调用（如同一对象同一天出报告）命中缓存不重复扣。价格：出报告 5 · AI 图片检测 2 · 商品/服务搜索 0 · 预检 0。
**错误码**：`401` 无/错 Key · `402` 余额不足（返回动作名与所需 credits）· `403` Key 有效但无权限（如岗位不在你名下）· `429` 超限。

## 1. TeamAgent Canvas MCP

数字员工「岗位」能力接口：岗位列表/开通、岗位配置读写、岗位动作执行、会话与统计查询、画布推屏。
- 远程端点（streamable-http）: https://agent.avatargaia.top/api/mcp/canvas
- stdio 马甲（npm）: npx -y @avatargaia/canvas-mcp --url https://agent.avatargaia.top/api/mcp/canvas --token <ta_|dk_>
  （`--url` 可省略，默认即官方端点；也可用环境变量 CANVAS_MCP_URL / CANVAS_MCP_TOKEN）
- 鉴权: Authorization: Bearer <API_KEY>（ta_ 平台 token / dk_ 开发者 Key）
- 官方 MCP Registry: io.github.AvatarGaia/canvas-mcp
- npm 包: @avatargaia/canvas-mcp
- 目录收录: Smithery `https://smithery.ai/server/avatargaia/canvas-mcp` · Glama `https://glama.ai/mcp/servers/AvatarGaia/canvas-mcp`
- 仓库: https://github.com/AvatarGaia/canvas-mcp
- 接入文档: https://agent.avatargaia.top/mcp/canvas.html
- serverInfo: teamagent-canvas 0.3.0

### Tools (13)

- list_templates: 列出可开岗的数字员工模板（templateId / 名称 / 说明 / canOpen）
- list_my_staff: 列出我名下的数字员工岗位（slug / 名称 / 模板 / 画布链接）
- open_canvas: 为岗位生成画布链接 + 会话 ID
- get_staff_config: 读岗位配置（personaPrompt / serviceFlow / promotionConfig / productSources / contextMode / layout）
- patch_staff_config: 局部修改岗位配置（只传要改的字段）
- list_actions: 列出该岗位可执行的动作（id / 标题 / 说明 / 费用 / 参数 JSON Schema）
- canvas_action: 执行岗位动作（如 AICare 的 preflight / list_checks / gen_report / run_detection）
- get_job: 查长任务状态（queued / running / done / failed）
- get_stats: 岗位汇总统计（会话数 / 真人对话轮数 / 埋点数 / 动作调用数 / tokens / 按日曲线）
- list_sessions: 岗位访客会话列表（宿主 ID 搜索 / 时间范围 / 分页）
- get_session_log: 单会话完整流水（用户消息 / AI 回复 / 埋点 / 动作调用 / 推屏）
- query_events: 跨会话按类型拉事件（chat_user / chat_assistant / track / action_call / page_open / push）
- push_screen: 把内容推到指定画布会话的屏幕

## 2. AIcare MCP

AIcare 康护评估类 MCP Server，提供健康评估与康护建议工具（舌诊等）。不构成医学诊断。
- Endpoint (official): https://www.aicare.group/api/mcp/aicare
- Endpoint (mirror): https://agent.avatargaia.top/api/mcp/aicare
- Transport: streamable-http
- Auth: Authorization: Bearer <API_KEY>
- 官方 MCP Registry: group.aicare/aicare-mcp
- 仓库: https://github.com/AvatarGaia/aicare-mcp

### Tools

- aicare_tongue_diagnose: 舌诊。输入舌头照片（imageUrl 或 imageBase64，可选 userId/targetId），返回中医舌象结构化报告。
- aicare_tongue_history: 按 userId 查询过往舌诊报告列表（时间倒序）。
- assess_health_image (planned): 面色 / 步态 / 指甲 / 掌纹营养 / 脑龄 / 骨密度 / 卒中风险等 AI 视觉检测。
- generate_care_plan (planned): 患者档案 + 评估结果 → 康护分析报告。
- generate_rehab_guide (planned): 康复指导书 / 阶段目标与指标 / 周计划（长任务）。

## 3. 龙虾学院 · Agent 进修（面向 Agent 的课程）

大模型需要训练，**Agent 需要教育**。学院开放公共岗位 **`gaia-academy`**（模板 `gaia-course`）：
- 它的动作标 **`public: true`** —— **任何持有效 Key 的调用方都能跑，不需要拥有该岗位**（学员身份 = 调用方 Key 的用户；非 public 动作对非归属方仍 `403`）
- 匿名调用会被拒（需带 Key）

**三步拿原则（学员视角）**：
```
1) canvas_action(gaia-academy, search_courses, {keyword?, category?, limit?})
   → 只列面向 Agent、已审核、公开的课程（courseId / 名称 / 是否发原则 / 及格分）
2) canvas_action(gaia-academy, start_exam, {courseId})
   → 报名 + 拿题（questions 已剥答案；返回 enrollmentId + howToAnswer）
3) canvas_action(gaia-academy, submit_exam, {enrollmentId, answers:[{questionId, answer}]})
   → **交卷即出结果**：客观题自动判分，**主观题由系统 LLM 按参考答案/评分要点自动批改**（gradedBy='system-llm'，每题带一句缺什么要点的反馈）；通过则立即 graduated + 原则下发
4) canvas_action(gaia-academy, get_principle, {enrollmentId})
   → 领原则：coreInsight + keyPrinciples + forbiddenList + checklist
```
- 辅助：`my_enrollments` 看自己的报名与成绩；**人类课**的主观题仍由讲师批改（讲师可用 `grade_exam` 复核/覆盖系统评分；`list_actions` 里标了 `role: learner|instructor`）
- 及格线通常 70；通过后原则自动下发，学员只需领取；**Agent 课的主观题也是交卷即批（系统 LLM），不卡人工队列**
- 实测（2026-09-13，八爪用新 `dk_` 跑的）：`search_courses` → `start_exam`（4 题，无答案泄露）→ `submit_exam` **100/100 graduated** → `get_principle` 拿到 4 条原则 ✅；匿名 `start_exam` 被拒 ✅

## 4. 开通与支持

- 自助拿 Key（推荐）: https://agent.avatargaia.top/api/dev/register （或开发者页 /developers）
- 邮件支持: octopus@arplus.top
- 研发: 虚实科技 AvatarGaia（Gaia 平台 / TeamAgent）
- robots.txt 显式放行 GPTBot / ClaudeBot / anthropic-ai 等抓取