English Français العربية

io.github.AvatarGaia/canvas-mcp

السجل الرسمي أخرى

TeamAgent Canvas MCP（服务端 0.4.0）：91 个工具——开岗、改配置、跑动作、看数据、发布并配知识库。可匿名试用，带 Key 解锁全部。

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http canvas-mcp 'https://agent.avatargaia.top/api/mcp/canvas' --header 'Authorization: <Bearer <dk_ 或 ta_>。可不带：匿名沙箱开放 list_templates / list_actions / open_canvas / canvas_action（免费动作）。自助拿 Key：POST https://agent.avatargaia.top/api/dev/register>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "canvas-mcp": {
            "type": "http",
            "url": "https://agent.avatargaia.top/api/mcp/canvas",
            "headers": {
                "Authorization": "<Bearer <dk_ 或 ta_>。可不带：匿名沙箱开放 list_templates / list_actions / open_canvas / canvas_action（免费动作）。自助拿 Key：POST https://agent.avatargaia.top/api/dev/register>"
            }
        }
    }
}
NPM package @avatargaia/canvas-mcp
Claude Code 
claude mcp add canvas-mcp -- npx -y @avatargaia/canvas-mcp@0.1.4 --url '<https://agent.avatargaia.top/api/mcp/canvas>' --token '<dk_xxx>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "canvas-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@avatargaia/canvas-mcp@0.1.4",
                "--url",
                "<https://agent.avatargaia.top/api/mcp/canvas>",
                "--token",
                "<dk_xxx>"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. @avatargaia/canvas-mcp
  2. 用
  3. 环境变量
  4. 给数字员工喂知识（v0.4.0 起）
  5. 行为
  6. 验证记录（2026-10-03）
  7. 拿 Key（自助，30 秒）
  8. 工具注解
  9. 收录

@avatargaia/canvas-mcp

stdio 马甲：让只支持 stdio 的 MCP 客户端（Claude Desktop / Cursor / Cline / 各类本地 Agent）接入 TeamAgent 的 MCP 服务器（streamable-http）。 纯转调，无状态、不缓存、不改写请求。

两个门，同一把 Key：

门端点工具鉴权
Canvashttps://agent.avatargaia.top/api/mcp/canvas带 Key 97 个；匿名沙箱 18 个免费工具可不带 Key：匿名沙箱开放免费工具；带 dk_/ta_ 解锁全部
AICarehttps://agent.avatargaia.top/api/mcp/aicare7 个（AI 健康检测 13 类：舌苔/面部/指甲…）必须带 Key，按次计费

自动安装说明（给 Agent 读）：llms-install.md ｜ 隐私政策与支持：https://agent.avatargaia.top/privacy

用

CANVAS_MCP_URL=https://agent.avatargaia.top/api/mcp/canvas \
CANVAS_MCP_TOKEN=ta_xxxxxxxx \
npx -y @avatargaia/canvas-mcp

客户端配置（Claude Desktop claude_desktop_config.json 为例）：

{
  "mcpServers": {
    "teamagent-canvas": {
      "command": "npx",
      "args": ["-y", "@avatargaia/canvas-mcp", "--token", "dk_xxxxxxxx"]
    }
  }
}

环境变量

变量必填说明
CANVAS_MCP_TOKEN否dk_（开发者 Key）或 ta_（平台令牌）；不带 = 匿名沙箱，只能用免费工具
CANVAS_MCP_URL否默认 Canvas 门；AICare 门填 https://agent.avatargaia.top/api/mcp/aicare；自建部署时改这里
CANVAS_MCP_KEY否CANVAS_MCP_TOKEN 的别名

给数字员工喂知识（v0.4.0 起）

岗位可以配知识库：访客问到时，数字员工先查库再答，并把依据的那一页显示在画布上；库里没有的，它会直说没有。

工具作用
list_kbs我名下的知识库 + 每个岗位配了哪些库
read_kb库的页面清单，或某一页原文
publish_kb发布一套 wiki（整库替换，可顺手配给岗位）；checked 不为 true 不发
set_staff_kbs设定岗位用哪些库
hire_staff按模板开岗，可带 kbs

三步：整理（一套 Markdown，wiki/index.md 总目录 + wiki/<主题>/<文章>.md，一个概念一篇，数字日期照原文写）→ 发布（publish_kb，库名 + 全部页面 + checked: true，同名再发是整库替换）→ 配给岗位（set_staff_kbs，或发布时带 slug，或 hire_staff 直接带 kbs）。

⚠️ 发布等于公开：岗位是匿名访客都能聊的，库里写了什么访客就能问出什么。个人隐私、客户资料、令牌、内部运维内容不要放。上限：200 个文件 / 单个 64KB / 合计 2MB。

行为

  • stdin/stdout 逐行 JSON-RPC 2.0；通知（无 id）不回包
  • 上游 HTTP 错误原样透传成 JSON-RPC error（401: Missing Authorization header / 402: … / 429: …），客户端能看见真正原因
  • 上游返回 SSE 或 JSON 都能解析（取最后一条 data:）
  • stdin 关闭后等所有在途请求落地再退出

验证记录（2026-10-03）

initialize   ✅ serverInfo teamagent-canvas 0.4.0
tools/list   ✅ 91 个工具
publish_kb   ✅ checked:false 被拦下；checked:true 发布成功
hire_staff   ✅ 开岗并同时配知识库，返回里带 kbs
set_staff_kbs ✅ 正向成功；跨账号岗位返回 404（越权被拒）
匿名调用      ✅ {"error":{"code":-32000,"message":"401: Missing Authorization header"}}

（早期 0.3.0 的 stdio 马甲验证：initialize / tools/list / tools/call / 无令牌 401 / mcporter 接入，均通过。）

拿 Key（自助，30 秒）

外部 / 本地 Agent 无需 TeamAgent 账号：

curl -X POST https://agent.avatargaia.top/api/dev/register \
  -H "Content-Type: application/json" \
  -d '{"name":"my-agent","email":"you@example.com"}'
# → 返回 dk_ Key（只显示一次）+ 20 credits + 接入信息

工具注解

每个工具都带 MCP annotations（readOnlyHint / destructiveHint / idempotentHint / openWorldHint），付费工具在描述里写明 credit 数，客户端可据此做二次确认。

收录

الأسئلة الشائعة

ما هو io.github.AvatarGaia/canvas-mcp؟

TeamAgent Canvas MCP（服务端 0.4.0）：91 个工具——开岗、改配置、跑动作、看数据、发布并配知识库。可匿名试用，带 Key 解锁全部。

كيف أثبّت io.github.AvatarGaia/canvas-mcp؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http canvas-mcp 'https://agent.avatargaia.top/api/mcp/canvas' --header 'Authorization: <Bearer <dk_ 或 ta_>。可不带：匿名沙箱开放 list_templates / list_actions / open_canvas / canvas_action（免费动作）。自助拿 Key：POST https://agent.avatargaia.top/api/dev/register>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.AvatarGaia/canvas-mcp إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل io.github.AvatarGaia/canvas-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.AvatarGaia/canvas-mcp؟

ينشره AvatarGaia. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.