MCP mit Claude Code, Desktop und Cursor einrichten

tasks hat einen eigenen MCP-Server unter https://app.tasks.squibble.ch/mcp. Claude Code, Claude Desktop, Cursor und andere MCP-Clients lesen damit Deine Aufgaben und legen neue an, mitten im Gespräch. Du brauchst dafür ein API-Token und etwa fünf Minuten.

1. Token erstellen

1. Öffne tasks und geh zu Einstellungen → API-Tokens.
2. Wähle Neues Token und gib ihm einen Namen, zum Beispiel Claude Code Laptop.
3. Wähle die Berechtigungen:
   • Aufgaben lesen (tasks:read): Die KI sieht Arbeitsbereiche und Aufgaben.
   • Aufgaben schreiben (tasks:write): Die KI darf zusätzlich Aufgaben anlegen, ändern, abhaken und kommentieren.
4. Schränke das Token auf einzelne Arbeitsbereiche ein, wenn die KI nur diese sehen soll, zum Beispiel nur den Arbeitsbereich Deiner Firma.
5. Wähle Token anlegen und kopiere das Token. Es beginnt mit tsk_ und wird nur jetzt angezeigt.

Ein Token läuft nach 90 Tagen ab, wenn Du nichts anderes einstellst, spätestens nach einem Jahr. Widerrufen kannst Du es jederzeit auf derselben Seite, das wirkt sofort.

2. Claude Code

Ersetze tsk_… durch Dein Token und führe im Terminal aus:

claude mcp add --transport http tasks https://app.tasks.squibble.ch/mcp --header "Authorization: Bearer tsk_…"

Mit -s project landet der Eintrag in der .mcp.json des Projekts statt in Deiner persönlichen Konfiguration. Committe diese Datei dann nicht mit dem Token. claude mcp list zeigt, ob der Server verbunden ist. Ein Projekt-Server muss beim nächsten Start von claude einmal freigegeben werden.

3. Claude Desktop

Claude Desktop spricht mit Servern, die ein Token im Header brauchen, über das kleine Programm mcp-remote. Dafür muss Node.js installiert sein. Öffne in Claude Desktop Einstellungen → Entwickler → Konfiguration bearbeiten und trage in claude_desktop_config.json ein:

{
  "mcpServers": {
    "tasks": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.tasks.squibble.ch/mcp", "--header", "Authorization:${TASKS_AUTH}"],
      "env": { "TASKS_AUTH": "Bearer tsk_…" }
    }
  }
}

Das Token steht in der Umgebungsvariable, weil Leerzeichen in den Argumenten unter Windows verloren gehen. Starte Claude Desktop danach neu. Unter dem Werkzeug-Symbol im Eingabefeld erscheinen die Werkzeuge von tasks.

4. Cursor

Lege in ~/.cursor/mcp.json (für alle Projekte) oder in .cursor/mcp.json (nur für ein Projekt) diesen Eintrag an:

{
  "mcpServers": {
    "tasks": {
      "url": "https://app.tasks.squibble.ch/mcp",
      "headers": { "Authorization": "Bearer tsk_…" }
    }
  }
}

In Cursor Settings → MCP erscheint tasks danach mit seinen Werkzeugen.

5. Ausprobieren

Frag zum Beispiel:

• «Was ist heute fällig?»
• «Zeig mir den Eingang.»
• «Leg eine Aufgabe an: Offerte nachfassen am Freitag um 14:00.»

Jede Antwort nennt die Aufgabennummer, etwa #8, und den Link zur Aufgabe. quick_add versteht dieselbe Schnelleingabe wie die Web-App und legt mit parent_id eine Unteraufgabe an. set_parent macht eine Aufgabe zur Unteraufgabe oder wieder zur Aufgabe oberster Ebene, innerhalb ihres Arbeitsbereichs.

Was die KI darf

Token	Werkzeuge
Aufgaben lesen	list_workspaces, list_tasks, get_task, list_taxonomy
Aufgaben lesen und schreiben	zusätzlich quick_add, create_task, update_task, set_status, set_parent, add_comment, create_tag, create_category

Fehlt das Schreibrecht, zeigt der Server die Schreibwerkzeuge gar nicht erst an. Ein Werkzeug zum Löschen gibt es nicht.

Wenn es nicht klappt

• 401 oder «Unauthorized»: Das Token ist falsch kopiert, abgelaufen oder widerrufen. Erstelle ein neues und ersetze es in der Konfiguration.
• Die KI kann nichts anlegen: Dem Token fehlt «Aufgaben schreiben».
• Ein Arbeitsbereich fehlt: Das Token ist auf andere Arbeitsbereiche eingeschränkt.