REST API 與 MCP Server 文件 — Claude Code 整合

− Claude Code 整合

TaskLeef includes a Model Context Protocol (MCP) server that allows AI assistants like Claude Code to manage your todos, boards, and Kanban workflows directly from the command line.

快速開始

Get your API key from Settings → API Keys

Add the MCP server to Claude Code:

claude mcp add --transport http taskleef https://taskleef.com/mcp/messages -H "X-API-Key: YOUR_API_KEY"

重新啟動 Claude Code
Verify it's working:
```
claude mcp list
```
You should see taskleef with a green checkmark.

替代方案：手動設定

Add directly to ~/.claude.json:

{
  "mcpServers": {
    "taskleef": {
      "type": "http",
      "url": "https://taskleef.com/mcp/messages",
      "headers": {
        "X-API-Key": "your-api-key-here"
      }
    }
  }
}

可用工具

The MCP server provides 40 tools across 7 domains:

待辦事項7 個工具

看板5 個工具

欄位6 個工具

卡片5 個工具

成員5 個工具

標籤7 個工具

留言5 個工具

使用範例

設定完成後，您可以用自然語言請 Claude 管理您的工作：

「顯示我本週的待辦事項」
「建立一個待辦事項，於週五前審閱季度報告 [work]」
「將驗證任務移至 Sprint 看板的『進行中』」
「在 API 重構任務中新增一則留言，說明我已開始審閱」
「為我所有的會議待辦事項加上『meetings』標籤」
「建立一個名為『Q2 Planning』的新看板」

Claude Desktop

若使用 Claude Desktop，請加入您的 MCP 設定檔：

{
  "mcpServers": {
    "taskleef": {
      "transport": {
        "type": "sse",
        "url": "https://taskleef.com/mcp/sse",
        "headers": {
          "X-API-Key": "your-api-key-here"
        }
      }
    }
  }
}

− Claude.ai 與 Claude CoWork

You can also use TaskLeef as a custom connector in Claude.ai (web), Claude Desktop, and Claude CoWork. The connector uses standard OAuth 2.1, so each user signs in with their own TaskLeef account — no shared API keys.

設定

In Claude, open Settings → Connectors → Add custom connector (Claude.ai web) or Settings → Connectors (Claude Desktop / CoWork).
Enter the server URL:
```
https://taskleef.com/mcp/messages
```
Leave the optional OAuth Client ID and Client Secret fields blank — TaskLeef supports Dynamic Client Registration (RFC 7591), so Claude provisions a client automatically.
Click Add. Claude opens a browser tab to taskleef.com and asks you to sign in.
Sign in (email/password or SSO via GitHub, Google, Microsoft, or Apple), click Authorize, and you're done. Claude redirects back automatically.

Claude 能做什麼

Once connected, Claude has access to all 40 MCP tools across todos, boards, columns, cards, members, tags, and comments. Try asking:

「我這週有哪些待辦事項？」
「建立一個名為『Q3 launch』的看板，並新增 Backlog、Doing 和 Done 三個欄位。」
「將 API 重構任務移至我 Sprint 看板的『進行中』。」
「為標題含『meeting』的每個待辦事項加上 meetings 標籤。」
「摘要我收件匣中尚未完成的待辦事項，並建議明天的優先順序。」
「在部署工單中新增一則留言，說明我午餐後會接手。」

工具安全性註記

連接器公開的每個工具都會為 Claude 加上註記，讓它能在執行破壞性操作前提醒您：

唯讀13 個工具

變更20 個工具

破壞性7 個工具

Destructive tools (delete todo, delete board, delete column, delete card, remove member, delete tag, delete comment) are flagged with destructiveHint: true, so Claude will ask for confirmation before running them.

Claude Code 與 Claude.ai / CoWork 比較

功能	Claude Code（CLI）	Claude.ai / CoWork
設定	在 CLI 中使用 API 金鑰	在瀏覽器中使用 OAuth
驗證	Static `X-API-Key` header	每位使用者的 OAuth 2.1 存取權杖
執行位置	本機終端機	Claude.ai / CoWork 雲端
權杖生命週期	在「設定」中手動輪替	自動更新，可在「設定」中撤銷
多使用者	每台機器一組金鑰	每位使用者分別登入

撤銷存取權

若要中斷 Claude 工作階段與 TaskLeef 的連線，請在 Claude 中移除該連接器。重新整理權杖也會在每次使用時輪替，因此已關閉工作階段的過期權杖無法被重放。

隱私權

The OAuth flow happens entirely between your browser, taskleef.com, and Claude. Your password is never sent to Claude. The access token Claude receives is scoped to MCP only and bound to the audience https://taskleef.com/mcp — it can't be replayed against any other API.

− 身分驗證

此 API 支援兩種身分驗證方式：

1. API 金鑰驗證（建議）

Generate an API key from your Settings page and include it in the X-API-Key header:

curl -H "X-API-Key: your-api-key" \
  https://taskleef.com/api/todos

2. JWT Bearer 權杖

若為瀏覽器應用程式，請透過登入端點進行驗證：

curl -X POST https://taskleef.com/api/login \
  -H "Content-Type: application/json" \
  -d '{"username": "your-username", "password": "your-password"}'

接著在後續請求中夾帶權杖：

curl -H "Authorization: Bearer your-jwt-token" \
  https://taskleef.com/api/todos

− 待辦事項

GET/api/todos

取得已驗證使用者的所有待辦事項。

curl -H "X-API-Key: your-api-key" \
  https://taskleef.com/api/todos

GET/api/todos/{id}

依 ID 取得特定待辦事項。

GET/api/inbox

取得未指派至任何專案的待辦事項。

POST/api/todos

建立新的待辦事項。

curl -X POST -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"title": "Buy groceries", "description": "Milk, eggs, bread"}' \
  https://taskleef.com/api/todos

請求主體

欄位	類型	必填	說明
title	string	Yes	Todo title
description	string	No	Detailed description
dueDate	ISO 8601	No	Due date/time
priority	string	No	Low, Medium, High, or Urgent
projectId	UUID	No	Assign to a project

PUT/api/todos/{id}

更新現有的待辦事項。

PATCH/api/todos/{id}/complete

切換待辦事項的完成狀態。

curl -X PATCH -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"isCompleted": true}' \
  https://taskleef.com/api/todos/{id}/complete

DELETE/api/todos/{id}

刪除待辦事項。

POST/api/todos/{parentId}/subtasks

在父待辦事項下建立子任務。

curl -X POST -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"title": "Subtask title"}' \
  https://taskleef.com/api/todos/{parentId}/subtasks

− 專案

GET/api/projects

列出已驗證使用者的所有專案。

POST/api/projects

建立新的專案。

curl -X POST -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"title": "Work Tasks", "description": "Tasks for work"}' \
  https://taskleef.com/api/projects

GET/api/projects/{id}

取得特定專案及其待辦事項。

PUT/api/projects/{id}

更新專案。

DELETE/api/projects/{id}

刪除專案（待辦事項會移至收件匣）。

− Kanban 看板

GET/api/boards

列出使用者有權存取的所有看板。

POST/api/boards

建立新的看板。

curl -X POST -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"title": "Sprint Board", "projectId": "project-uuid"}' \
  https://taskleef.com/api/boards

GET/api/boards/{id}

取得特定看板。

GET/api/boards/{boardId}/columns

取得看板的所有欄位。

GET/api/boards/{boardId}/todos

取得在此看板上有卡片的所有待辦事項。

− 欄位

POST/api/boards/{boardId}/columns

在看板上建立新的欄位。

curl -X POST -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"title": "In Progress", "wipLimit": 3}' \
  https://taskleef.com/api/boards/{boardId}/columns

PUT/api/columns/{id}

更新欄位（標題、WIP 限制、完成標準）。

GET/api/columns/{columnId}/cards

取得欄位中的所有卡片。

DELETE/api/columns/{id}

刪除欄位。

− 卡片

卡片代表 Kanban 看板上的待辦事項。一個待辦事項可在多個看板上擁有卡片。

POST/api/columns/{columnId}/cards

在欄位中為待辦事項建立卡片。

curl -X POST -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"todoId": "todo-uuid"}' \
  https://taskleef.com/api/columns/{columnId}/cards

PUT/api/cards/{id}

更新卡片（移至不同欄位或子欄位）。

# Move card to a different column
curl -X PUT -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"columnId": "new-column-uuid", "subColumn": "Inbox"}' \
  https://taskleef.com/api/cards/{id}

# Move card to Done subColumn
curl -X PUT -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"subColumn": "Done"}' \
  https://taskleef.com/api/cards/{id}

子欄位值

Inbox - Active items in the column
Done - Completed items within the column
Blocked - Items waiting on external dependencies

DELETE/api/cards/{id}

從看板移除卡片（不會刪除待辦事項）。

− 標籤

GET/api/tags

列出已驗證使用者的所有標籤。

POST/api/tags

建立新的標籤。

curl -X POST -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"name": "urgent"}' \
  https://taskleef.com/api/tags

PUT/api/tags/{id}

更新標籤。

DELETE/api/tags/{id}

刪除標籤。

− 留言

GET/api/todos/{todoId}/comments

取得待辦事項的所有留言。

POST/api/todos/{todoId}/comments

為待辦事項新增留言。

curl -X POST -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"text": "This is my comment"}' \
  https://taskleef.com/api/todos/{todoId}/comments

PUT/api/comments/{id}

更新留言。

DELETE/api/comments/{id}

刪除留言。

− 回應格式

成功回應

成功的請求會回傳含有所需資料的 JSON：

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "title": "Buy groceries",
  "description": "Milk, eggs, bread",
  "isCompleted": false,
  "createdAt": "2024-01-15T10:30:00Z"
}

錯誤回應

錯誤會回傳對應的 HTTP 狀態碼：

400 - Bad Request (invalid input)
401 - Unauthorized (missing or invalid authentication)
403 - Forbidden (insufficient permissions)
404 - Not Found
500 - Internal Server Error