REST API & MCP サーバードキュメント — 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:

Todo7 個のツール

ボード5 個のツール

列6 個のツール

カード5 個のツール

メンバー5 個のツール

タグ7 個のツール

コメント5 個のツール

使用例

設定が完了すると、Claude に自然な言葉でタスクの管理を依頼できます:

「今週の私の Todo を表示して」
「四半期レポートを金曜日までにレビューする Todo を作成して [work]」
「Sprint ボードで認証タスクを In Progress に移動して」
「API リファクタリングタスクに、レビューを開始したとコメントを追加して」
「私のすべての会議 Todo に '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 の列を追加して。」
「Sprint ボードで API リファクタリングタスクを In Progress に移動して。」
「タイトルに 'meeting' が含まれるすべての Todo に meetings タグを付けて。」
「受信トレイの未完了の Todo を要約し、明日の優先順位を提案して。」
「デプロイのチケットに、昼食後に対応すると伝えるコメントを追加して。」

ツールの安全性に関する注釈

コネクターが公開するすべてのツールには 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 クラウド
トークンのライフサイクル	設定での手動ローテーション	自動更新、設定で取り消し可能
マルチユーザー	マシンごとに1つのキー	各ユーザーが個別にサインイン

アクセスの取り消し

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 は2つの認証方法をサポートしています:

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 ベアラートークン

ブラウザベースのアプリケーションでは、ログインエンドポイント経由で認証します:

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

− Todo

GET/api/todos

認証済みユーザーのすべての Todo を取得します。

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

GET/api/todos/{id}

ID を指定して特定の Todo を取得します。

GET/api/inbox

どのプロジェクトにも割り当てられていない Todo を取得します。

POST/api/todos

新しい Todo を作成します。

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}

既存の Todo を更新します。

PATCH/api/todos/{id}/complete

Todo の完了ステータスを切り替えます。

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}

Todo を削除します。

POST/api/todos/{parentId}/subtasks

親 Todo の下にサブタスクを作成します。

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}

Todo を含む特定のプロジェクトを取得します。

PUT/api/projects/{id}

プロジェクトを更新します。

DELETE/api/projects/{id}

プロジェクトを削除します（Todo は受信トレイに移動されます）。

− 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

このボードにカードがあるすべての Todo を取得します。

− 列

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 ボード上の Todo を表します。1つの Todo は複数のボードにカードを持つことができます。

POST/api/columns/{columnId}/cards

列内の Todo のカードを作成します。

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}

ボードからカードを削除します（Todo は削除されません）。

− タグ

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

Todo のすべてのコメントを取得します。

POST/api/todos/{todoId}/comments

Todo にコメントを追加します。

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