REST API- ja MCP server -dokumentaatio — Claude Code -integraatio

− Claude Code -integraatio

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.

Pikaopas

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"

Käynnistä Claude Code uudelleen
Verify it's working:
```
claude mcp list
```
You should see taskleef with a green checkmark.

Vaihtoehto: manuaalinen määritys

Add directly to ~/.claude.json:

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

Käytettävissä olevat työkalut

The MCP server provides 40 tools across 7 domains:

Tehtävät7 työkalua

Taulut5 työkalua

Sarakkeet6 työkalua

Kortit5 työkalua

Jäsenet5 työkalua

Tunnisteet7 työkalua

Kommentit5 työkalua

Käyttöesimerkki

Kun määritys on valmis, voit pyytää Claudea hallinnoimaan tehtäviäsi luonnollisesti:

"Näytä tämän viikon tehtäväni"
"Luo tehtävä neljännesvuosiraportin tarkistamiseksi perjantaihin mennessä [työ]"
"Siirrä todennustehtävä Käynnissä-sarakkeeseen Sprint-taululla"
"Lisää API-refaktorointitehtävään kommentti, että olen aloittanut tarkistuksen"
"Lisää kaikkiin kokoustehtäviini tunniste 'kokoukset'"
"Luo uusi taulu nimeltä 'Q2-suunnittelu'"

Claude Desktop

Lisää Claude Desktopia varten MCP-asetustiedostoosi:

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

− Claude.ai ja 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.

Käyttöönotto

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.

Mitä Claude voi tehdä

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

"Mitä minulla on tehtävänä tällä viikolla?"
"Luo taulu nimeltä 'Q3-julkaisu' ja lisää sarakkeet Jono, Käynnissä ja Valmis."
"Siirrä API-refaktorointitehtävä Käynnissä-sarakkeeseen Sprint-taulullani."
"Lisää tunniste 'kokous' jokaiseen tehtävään, jonka otsikossa on sana kokous."
"Tee yhteenveto Saapuneet-kansion avoimista tehtävistä ja ehdota prioriteetteja huomiselle."
"Lisää käyttöönottotikettiin kommentti, että otan sen hoitooni lounaan jälkeen."

Työkalujen turvallisuusmerkinnät

Jokainen liittimen tarjoama työkalu on merkitty Claudelle, jotta se voi varoittaa sinua ennen tuhoisia toimintoja:

Vain luku13 työkalua

Muokkaava20 työkalua

Tuhoava7 työkalua

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

Ominaisuus	Claude Code (CLI)	Claude.ai / CoWork
Käyttöönotto	API-avain CLI:ssä	OAuth selaimessa
Todennus	Static `X-API-Key` header	Käyttäjäkohtainen OAuth 2.1 -käyttötunnus
Missä se toimii	Paikallinen pääte	Claude.ai / CoWork -pilvi
Tunnuksen elinkaari	Manuaalinen kierto asetuksissa	Automaattinen päivitys, peruutettavissa asetuksissa
Monikäyttäjä	Yksi avain per kone	Jokainen käyttäjä kirjautuu erikseen

Käytön peruuttaminen

Irrota Claude-istunto TaskLeefistä poistamalla liitin Claudessa. Päivitystunnukset kierrätetään myös jokaisella käyttökerralla, joten suljetun istunnon vanhentunutta tunnusta ei voida käyttää uudelleen.

Tietosuoja

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.

− Todennus

API tukee kahta todennustapaa:

1. API-avaintodennus (suositeltu)

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 -tunnus

Selainpohjaisissa sovelluksissa todenna kirjautumispäätepisteen kautta:

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

Sisällytä tunnus sitten seuraaviin pyyntöihin:

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

− Tehtävät

GET/api/todos

Hae kaikki todennetun käyttäjän tehtävät.

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

GET/api/todos/{id}

Hae tietty tehtävä tunnuksen perusteella.

GET/api/inbox

Hae tehtävät, joita ei ole liitetty mihinkään projektiin.

POST/api/todos

Luo uusi tehtävä.

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

Pyynnön runko

Kenttä	Tyyppi	Pakollinen	Kuvaus
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}

Päivitä olemassa oleva tehtävä.

PATCH/api/todos/{id}/complete

Vaihda tehtävän valmiustilaa.

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}

Poista tehtävä.

POST/api/todos/{parentId}/subtasks

Luo alitehtävä päätehtävän alle.

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

− Projektit

GET/api/projects

Listaa kaikki todennetun käyttäjän projektit.

POST/api/projects

Luo uusi projekti.

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}

Hae tietty projekti tehtävineen.

PUT/api/projects/{id}

Päivitä projekti.

DELETE/api/projects/{id}

Poista projekti (tehtävät siirretään Saapuneet-kansioon).

− Kanban-taulut

GET/api/boards

Listaa kaikki taulut, joihin käyttäjällä on pääsy.

POST/api/boards

Luo uusi taulu.

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}

Hae tietty taulu.

GET/api/boards/{boardId}/columns

Hae taulun kaikki sarakkeet.

GET/api/boards/{boardId}/todos

Hae kaikki tehtävät, joilla on kortteja tällä taululla.

− Sarakkeet

POST/api/boards/{boardId}/columns

Luo uusi sarake tauluun.

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}

Päivitä sarake (otsikko, WIP-raja, valmiusehdot).

GET/api/columns/{columnId}/cards

Hae sarakkeen kaikki kortit.

DELETE/api/columns/{id}

Poista sarake.

− Kortit

Kortit edustavat tehtäviä Kanban-taululla. Tehtävällä voi olla kortteja useilla tauluilla.

POST/api/columns/{columnId}/cards

Luo kortti tehtävälle sarakkeeseen.

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}

Päivitä kortti (siirrä toiseen sarakkeeseen tai alisarakkeeseen).

# 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}

Alisarakkeen arvot

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

DELETE/api/cards/{id}

Poista kortti taululta (ei poista tehtävää).

− Tunnisteet

GET/api/tags

Listaa kaikki todennetun käyttäjän tunnisteet.

POST/api/tags

Luo uusi tunniste.

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}

Päivitä tunniste.

DELETE/api/tags/{id}

Poista tunniste.

− Kommentit

GET/api/todos/{todoId}/comments

Hae tehtävän kaikki kommentit.

POST/api/todos/{todoId}/comments

Lisää kommentti tehtävään.

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}

Päivitä kommentti.

DELETE/api/comments/{id}

Poista kommentti.

− Vastauksen muoto

Onnistuneet vastaukset

Onnistuneet pyynnöt palauttavat JSON-muodossa pyydetyt tiedot:

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

Virhevastaukset

Virheet palauttavat asianmukaiset HTTP-tilakoodit:

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