jif2.zhang
ec6c9c7677
Docker Build and Push / build-image (push) Successful in 4m34s
- 新增 /api/mcp (Streamable HTTP) 与 41 个工具: 项目/看板列/任务/清单/打卡; - 新增 McpToken 模型与迁移, DB 仅存 SHA-256 哈希, token 绑定用户; - 新增 /api/mcp-tokens 增删改查, 支持独立命名 (如 R1); - 「我的」页新增 AI 接入 (MCP) 区块: 地址复制/新建/一次性展示/删除; - 补充 docs/MCP.md 与样式
55 lines
1.9 KiB
Markdown
55 lines
1.9 KiB
Markdown
# AI 接入 (MCP)
|
|
|
|
iBoard 内置一个 MCP (Model Context Protocol) 服务，AI 客户端可以通过个人授权 Token 直接查询、新增、修改、删除和排序当前用户的数据。
|
|
|
|
## 1. 创建 Token
|
|
|
|
1. 登录 iBoard，进入「我的」。
|
|
2. 找到「AI 接入 (MCP)」。
|
|
3. 输入 Token 名称（例如 `R1`、`家里电脑`），点击「新建 Token」。
|
|
4. 复制弹窗中的 Token。**明文只显示一次**，关闭后无法再次查看。
|
|
|
|
每个 Token 独立命名，并与创建它的用户绑定。使用该 Token 的 AI 拥有该用户的全部业务权限；删除 Token 后立即失效。
|
|
|
|
## 2. 连接方式
|
|
|
|
- 端点：`https://<你的 iBoard 域名>/api/mcp`（页面上的「MCP 服务地址」可直接复制）
|
|
- 协议：Streamable HTTP（无状态）
|
|
- 鉴权头：
|
|
|
|
```http
|
|
Authorization: Bearer <Token>
|
|
```
|
|
|
|
通用 MCP 客户端配置示例（以支持 HTTP transport 的客户端为例）：
|
|
|
|
```json
|
|
{
|
|
"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)」中删除。
|