概览支持的工具 Claude Code Cursor 终端 curl API Token 权限与边界

MCP 连接

Tovaki 托管了一个 MCP 服务器。生成 token，一行接入 Claude Code 或 Cursor，agent 就能看画布、发指令。

服务器地址（任何 MCP 客户端都用这一个）： Streamable HTTP · Authorization: Bearer

https://tovaki.com/agent/v1/mcp

先去 Token 页生成一个 token（下面「API Token」一节有入口），再按你用的客户端接入。

支持的工具

canvas_snapshot — 读画布快照，拿到节点清单（id、类型、状态、标题）。
canvas_ops — 发画布操作指令，进队列，画布打开时 10 秒内执行。
ops_status — 查最近 20 条指令的执行状态。

指令进队列，画布打开时 10 秒内执行；1 小时没执行自动过期，状态随时可查。

Claude Code

一行命令（把 token 换成上面生成的）：

claude mcp add --transport http tovaki https://tovaki.com/agent/v1/mcp \
  --header "Authorization: Bearer tvk_你的token"

Cursor

把这段加进 Cursor 的 mcp.json（Settings → MCP）：

{
  "mcpServers": {
    "tovaki": {
      "url": "https://tovaki.com/agent/v1/mcp",
      "headers": { "Authorization": "Bearer tvk_你的token" }
    }
  }
}

终端 curl

不用 MCP 客户端也能直接调 REST：

1 · 验证连接：

curl https://tovaki.com/agent/v1/verify \
  -H "Authorization: Bearer tvk_你的token"

2 · 读画布快照：

curl "https://tovaki.com/agent/v1/canvas?projectId=..." \
  -H "Authorization: Bearer tvk_你的token"

3 · 发画布操作（token 权限要选「画布读写」，打开画布 10 秒内执行）：

curl -X POST https://tovaki.com/agent/v1/ops \
  -H "Authorization: Bearer tvk_你的token" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"...","ops":[{"tool":"arrange_row","args":{"selector":{"all":true}}}]}'

4 · 查最近指令的执行状态：

curl "https://tovaki.com/agent/v1/ops?projectId=..." \
  -H "Authorization: Bearer tvk_你的token"

API Token

生成、吊销和管理连接用的 token，都在独立的 Token 页。管理 API Token →

权限与边界

token 分「画布只读」和「画布读写」两档：只读能读快照、查状态；发指令要选画布读写。支付和账户设置在任何一档都没有。
花钱的动作（生成、高清这类）MCP 发不了——只能在站内由你亲手确认。