canvas-mcp

@avatargaia/canvas-mcp

stdio ブリッジ：stdio のみをサポートする MCP クライアント（Claude Desktop / Cursor / Cline / 各種ローカルエージェント）から TeamAgent の MCP サーバー（streamable-http）に接続できます。 単純な転送のみで、ステートレスです。キャッシュもリクエストの書き換えも行いません。

2 つのゲート、同じ Key：

ゲート	エンドポイント	ツール	認証
Canvas	https://agent.avatargaia.top/api/mcp/canvas	Key ありで 97 個；匿名サンドボックスでは無料ツール 18 個	Key なしでも利用可能：匿名サンドボックスで無料ツールを利用できます；dk_/ta_ を付けるとすべて利用できます
AICare	https://agent.avatargaia.top/api/mcp/aicare	7 個（AI 健康チェック 13 種：舌苔／顔／爪…）	Key 必須、従量課金

自動インストール手順（エージェント向け）：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 を指定可能

3 ステップ：整理（Markdown 一式を用意します。wiki/index.md を総目次にし、wiki/<テーマ>/<記事>.md に記事を置きます。1 つの概念につき 1 記事とし、数字の日付は原文どおりに記載します）→ 公開（publish_kb にナレッジベース名とすべてのページを指定し、checked: true を設定します。同じ名前で再度公開するとナレッジベース全体が置き換わります）→ 職務に割り当て（set_staff_kbs を使用するか、公開時に slug を指定するか、hire_staff に kbs を直接指定します）。

⚠️ 公開すると誰でも閲覧できます：職務には匿名の訪問者も話しかけられるため、ナレッジベースに書かれたことは訪問者が質問できます。個人情報、顧客情報、トークン、内部運用情報は登録しないでください。上限：ファイル 200 個／1 ファイルあたり 64KB／合計 2MB。

動作

• stdin/stdout を使った 1 行ごとの JSON-RPC 2.0；通知（id なし）には応答しません
• 上流の HTTP エラーを JSON-RPC エラーとしてそのまま転送します（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 秒）

外部／ローカルエージェントは TeamAgent アカウントなしで利用できます：

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

• 開発者向けページ（コンソール／課金／エラーコード）：https://agent.avatargaia.top/developers
• 機械可読な自己記述（エージェントによる自動検出に推奨）：GET https://agent.avatargaia.top/api/dev

ツールのアノテーション

各ツールには MCP annotations（readOnlyHint / destructiveHint / idempotentHint / openWorldHint）が付いています。有料ツールは説明に credit 数が記載されているため、クライアントはそれに基づいて追加確認を行えます。

掲載情報

• 公式 MCP Registry：io.github.AvatarGaia/canvas-mcp
• 接続ドキュメント：https://agent.avatargaia.top/mcp/canvas.html ｜ LLM インデックス：/llms.txt