# 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)」中删除。