Asana-Plugin für Claude Code einrichten

Diese Anleitung richtet das Asana-Plugin aus Anthropics offiziellem Plugin-Repository für Claude Code ein. Prüfe vor produktivem Einsatz die vollständige [README](https://github.com/anthropics/claude-plugins-official/blob/main/external_plugins/asana/README.md) im Repository. Weil Asanas V2-MCP-Server keine Dynamic Client Registration unterstützt, braucht jeder Nutzer eine eigene OAuth-App – das lässt sich nicht überspringen.

Voraussetzungen prüfen

Du brauchst eine aktuelle Version von Claude Code (prüfbar mit claude --version) sowie ein Asana-Konto mit Zugriff auf den Asana-Entwicklerkonsole unter app.asana.com/0/my-apps. Ein bereits vorhandener Zugang zum alten V1-Beta-Server hilft nicht weiter, da dieser im August 2026 abgeschaltet wurde.

Asana-OAuth-App anlegen

Öffne die [Asana-Entwicklerkonsole](https://app.asana.com/0/my-apps) und lege eine neue App an. Trage unter OAuth als Redirect-URL exakt http://localhost:8080/callback ein – das ist Claude Codes lokaler OAuth-Callback und muss exakt zum später verwendeten --callback-port passen. Notiere dir anschließend Client-ID und Client-Secret.

Plugin installieren und verbinden

Installiere das Plugin über den in Claude Code integrierten Marketplace mit /plugin install asana@claude-plugins-official und starte danach den mitgelieferten Assistenten mit /asana-setup. Er führt durch dieselben Schritte, die sich auch manuell im Terminal ausführen lassen:

claude mcp add --transport http \
  --client-id DEINE_CLIENT_ID --client-secret \
  --callback-port 8080 \
  asana https://mcp.asana.com/v2/mcp

Ersetze DEINE_CLIENT_ID durch die Client-ID aus der Asana-Entwicklerkonsole. Weil --client-secret ohne Wert übergeben wird, fragt Claude Code das Secret an einem versteckten Prompt ab und legt es verschlüsselt im Schlüsselbund des Betriebssystems ab, statt es auf der Festplatte zu speichern.

Verbindung testen

Beim nächsten Zugriff auf den asana-Server öffnet Claude Code den Browser für die Asana-Zustimmung. Nach der Bestätigung zeigt der Befehl /mcp den Server asana als verbunden an. Ein einfacher erster Test ist eine Anfrage wie „Zeig mir meine Asana-Workspaces" oder „Welche Asana-Aufgaben sind mir zugewiesen?".

Bei Fehlern weiterhelfen

Erscheint invalid_redirect_uri, stimmt die in der Asana-App hinterlegte Redirect-URL nicht exakt mit http://localhost:8080/callback überein oder der verwendete --callback-port weicht von 8080 ab. Bei invalid_client stimmen Client-ID oder Client-Secret nicht; entferne die Verbindung mit claude mcp remove asana und richte sie erneut ein. Fehlermeldungen zu Dynamic Client Registration sind kein Bug, sondern bestätigen nur, dass V2 dafür keinen automatischen Weg mehr anbietet.