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 열을 추가해줘."
"내 Sprint 보드에서 API 리팩터링 작업을 진행 중으로 옮겨줘."
"제목에 '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 vs. Claude.ai / CoWork

기능	Claude Code (CLI)	Claude.ai / CoWork
설정	CLI의 API 키	브라우저의 OAuth
인증	Static `X-API-Key` header	사용자별 OAuth 2.1 액세스 토큰
실행 위치	로컬 터미널	Claude.ai / CoWork 클라우드
토큰 수명 주기	설정에서 수동 교체	자동 갱신, 설정에서 취소 가능
다중 사용자	머신당 키 1개	각 사용자가 개별적으로 로그인

액세스 취소

TaskLeef에서 Claude 세션을 연결 해제하려면 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 베어러 토큰

브라우저 기반 애플리케이션의 경우 로그인 엔드포인트를 통해 인증합니다:

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