MCP 与 Agent 令牌:让 AI 工具操作看板

更新于 2026-10-16 · 阅读约 4 分钟

看板内置了一个 MCP Server,让 Claude Code、Cursor、Kimi Code 这类支持 MCP 的 AI 工具可以直接读写你的看板:查卡片、建任务、移动卡片、写评论。这篇讲它是什么、怎么生成令牌、怎么接到你的 AI 客户端。

MCP Server 是什么

MCP(Model Context Protocol)是让 AI 工具调用外部服务的通用协议。看板的 MCP Server 地址是:

https://dadaji.fun/mcp

它提供 11 个工具,覆盖看板卡片的常见操作:读取整块看板、按条件查卡、新建/更新/移动卡片、指派负责人、写评论、归档与恢复、删除,以及面向写周报的板概览(逾期清单、按成员统计)。

注:Agent 只能操作你自己有权访问的看板,权限和你的账号一致;每一次工具调用(包括读取)都会记录在「摘要报告」的操作流水里,标注为哪个令牌执行的。

生成 Agent 令牌

AI 工具用令牌(Personal Access Token)而不是你的密码来鉴权。

  1. 打开左侧导航栏底部的「设置」,进入「AI 智能」组的「MCP 与令牌」;
  2. 页面顶部就是 MCP Server 地址,点「复制」备用;
  3. 在「访问令牌」区输入一个备注名(如「我的 Cursor」),点「创建令牌」;
  4. 令牌明文(以 djk_ 开头)只显示这一次,立即点「复制」保存,然后点「我已保存」。

MCP 与令牌设置页:复制 Server 地址,创建访问令牌
MCP 与令牌设置页:复制 Server 地址,创建访问令牌

令牌列表会显示每个令牌的前缀、创建时间和最近使用时间,方便你分辨哪个令牌在被使用。

配置到 MCP 客户端

以通用的 MCP 配置格式为例(各客户端的配置文件位置不同,以客户端文档为准):

{
  "mcpServers": {
    "dadaji-kanban": {
      "url": "https://dadaji.fun/mcp",
      "headers": {
        "Authorization": "Bearer djk_替换成你的令牌"
      }
    }
  }
}
  • Claude Code:用 claude mcp add 命令添加一个 HTTP 类型的 server,URL 同上,header 带上 Authorization: Bearer djk_…;
  • Cursor:在 MCP 设置里添加 server,类型选 HTTP/streamable HTTP,填入同样的 URL 和 header。

配置好后,直接对 AI 说「看看我看板上逾期的卡片」「把复习计划拆成卡片加到待办列」,它就会调用看板工具执行。

安全注意事项

  • 令牌等同账号权限:拿到令牌的人能以你的身份读写看板卡片,请像保管密码一样保管,不要提交到代码仓库或发给他人;
  • 泄露立即吊销:回到「设置 → AI 智能 → MCP 与令牌」,点对应令牌的「吊销」并确认,吊销后立即失效,然后重新创建一个新令牌;
  • 删除不可恢复:工具里有物理删除(kanban_delete_card),建议在 prompt 里约束 AI 优先用「归档」而不是「删除」;
  • 一人一令牌:给每个 AI 工具单独建令牌并写好备注名,出问题时可以只吊销其中一个,不影响其他工具。

令牌列表:可查看前缀、最近使用时间,随时吊销
令牌列表:可查看前缀、最近使用时间,随时吊销

相关阅读