Files

T

Docker Build and Push / build-image (push) Successful in 4m34s

Details

- 新增 /api/mcp (Streamable HTTP) 与 41 个工具: 项目/看板列/任务/清单/打卡; - 新增 McpToken 模型与迁移, DB 仅存 SHA-256 哈希, token 绑定用户; - 新增 /api/mcp-tokens 增删改查, 支持独立命名 (如 R1); - 「我的」页新增 AI 接入 (MCP) 区块: 地址复制/新建/一次性展示/删除; - 补充 docs/MCP.md 与样式

2026-11-09 10:41:08 +08:00

1.9 KiB

Raw Permalink Blame History

AI 接入 (MCP)

iBoard 内置一个 MCP (Model Context Protocol) 服务，AI 客户端可以通过个人授权 Token 直接查询、新增、修改、删除和排序当前用户的数据。

1. 创建 Token

登录 iBoard，进入「我的」。
找到「AI 接入 (MCP)」。
输入 Token 名称（例如 R1、家里电脑），点击「新建 Token」。
复制弹窗中的 Token。明文只显示一次，关闭后无法再次查看。

每个 Token 独立命名，并与创建它的用户绑定。使用该 Token 的 AI 拥有该用户的全部业务权限；删除 Token 后立即失效。

2. 连接方式

端点：https://<你的 iBoard 域名>/api/mcp（页面上的「MCP 服务地址」可直接复制）
协议：Streamable HTTP（无状态）
鉴权头：

Authorization: Bearer <Token>

通用 MCP 客户端配置示例（以支持 HTTP transport 的客户端为例）：

{
  "mcpServers": {
    "iboard": {
      "type": "http",
      "url": "https://<你的 iBoard 域名>/api/mcp",
      "headers": {
        "Authorization": "Bearer ibm_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

3. 可用能力

项目：查询 / 新建 / 修改 / 删除；成员添加与移除
看板列：查询 / 新建 / 修改 / 删除；列排序
任务：查询 / 新建 / 修改 / 删除 / 归档 / 恢复 / 排序 / 跨项目拷贝
检查清单：查询 / 新建 / 修改 / 删除 / 复制；检查项增删改、排序、一键勾选；模板查询
打卡：查询 / 新建 / 修改 / 删除 / 排序；打卡与撤销打卡

工具名与参数以 MCP tools/list 返回为准，所有描述均为中文，便于 AI 选择。

4. 安全建议

Token 等同于账号密码，请勿提交到 Git 或发送到公开群聊。
给不同设备 / 不同 AI 客户端分别创建具名 Token，便于单独吊销。
不再使用时在「我的 → AI 接入 (MCP)」中删除。

1.9 KiB Raw Permalink Blame History