Asana
Von Asana selbst geliefertes Claude-Code-Plugin: Einrichtungsassistent für die OAuth-Verbindung zu Asanas V2-MCP-Server.
- Skill Road
- Asana
Kategorien
Asana ist ein Claude-Code-Plugin für die Anbindung an Asanas eigenen V2-MCP-Server (https://mcp.asana.com/v2/mcp) und liegt, wie das Telegram-, Discord- und iMessage-Plugin, im offiziellen, von Anthropic kuratierten Repository anthropics/claude-plugins-official. Anders als diese drei Messaging-Bridges kommt es jedoch nicht von Anthropic selbst: In der plugin.json des Plugins steht als Autor "Asana" – das Unternehmen hinter der gleichnamigen Work-Management-Plattform liefert die Integration hier direkt selbst mit. Auf der Marketplace-Seite claude.com/plugins/asana zählt Anthropic nach eigener Angabe rund 10.800 Installationen, ohne dass das Plugin dabei das "Anthropic verified"-Abzeichen trägt, das etwa das Telegram- oder das Code-Review-Plugin im selben Verzeichnis zeigen.
Kein eigener MCP-Server, sondern ein Einrichtungsassistent
Im Unterschied zu den Messaging-Plugins fügt Asana selbst keinen neuen MCP-Server hinzu und startet auch keinen dauerhaften Hintergrundprozess. Der Ordner external_plugins/asana im Repository enthält lediglich eine README und einen einzigen Slash-Befehl, /asana-setup, der Schritt für Schritt durch die Verbindung mit Asanas V2-MCP-Server führt – der als eigenständiger Katalogeintrag "Asana MCP Server" mit seinen Werkzeugen zum Anlegen, Suchen und Aktualisieren von Aufgaben bereits separat dokumentiert ist. Dieses Plugin ergänzt jenen Eintrag um eine speziell für Claude Code zugeschnittene, geführte Einrichtung, ersetzt ihn aber nicht.
Warum die Einrichtung einen eigenen Assistenten braucht
Laut README hat Asana im August 2026 seinen ursprünglichen V1-Beta-Server (https://mcp.asana.com/sse) abgeschaltet; die Nachfolgeversion V2 unterstützt bewusst keine Dynamic Client Registration mehr, wodurch eine Zero-Config-Verbindung wie früher nicht mehr möglich ist. Jeder Nutzer muss stattdessen eine eigene OAuth-App im Asana-Entwicklerportal (app.asana.com/0/my-apps) anlegen, dort als Redirect-URL exakt http://localhost:8080/callback hinterlegen und die resultierende Client-ID sowie das Client-Secret an Claude Code übergeben. Genau diesen mehrstufigen Prozess automatisiert der Befehl /asana-setup; alternativ lässt er sich auch manuell über claude mcp add --transport http --client-id YOUR_CLIENT_ID --client-secret --callback-port 8080 asana https://mcp.asana.com/v2/mcp nachvollziehen. Das Client-Secret wird laut Dokumentation nicht als Klartext übergeben, sondern an einem versteckten Prompt abgefragt und verschlüsselt im Schlüsselbund des Betriebssystems abgelegt.
Funktionsumfang nach der Einrichtung
Ist die Verbindung einmal hergestellt, beschreibt Anthropic auf der Marketplace-Seite den resultierenden Funktionsumfang mit: Aufgaben anlegen und verwalten, Projektstatus verfolgen, Zuständigkeiten aktualisieren, per Freitextsuche durch Workspaces suchen sowie Ziele und Abschnitte pflegen – jeweils per natürlichsprachlicher Anweisung an Claude Code statt über die Asana-Weboberfläche. Die README nennt als Beispielbefehle etwa das Anlegen einer Aufgabe in einem bestimmten Projekt samt Zuweisung oder das Abfragen aller in der laufenden Woche fälligen eigenen Aufgaben.
Fehlerbehebung
Die README widmet der Fehlersuche einen eigenen Abschnitt: Der Fehler invalid_redirect_uri deutet auf eine falsch hinterlegte oder nicht zum --callback-port passende Redirect-URL hin, invalid_client auf eine falsche Client-ID oder ein falsches Secret (behebbar durch claude mcp remove asana und erneutes Einrichten), und Fehlermeldungen rund um Dynamic Client Registration bestätigen lediglich, dass V2 dafür grundsätzlich kein automatisches Verfahren mehr anbietet.
Für wen sich das Plugin lohnt
Sinnvoll ist der Assistent für alle, die Asana bereits als Work-Management-Plattform im Unternehmen einsetzen und Claude Code direkt mit dem eigenen Workspace verbinden möchten, ohne die OAuth-Einrichtung von Hand aus der Asana- und Claude-Code-Dokumentation zusammenzusuchen. Sowohl das Plugin als auch der zugrundeliegende Server sind kostenlos nutzbar – lediglich der verbundene Asana-Account mit seinem jeweiligen Tarif bestimmt, welche Daten und Funktionen überhaupt erreichbar sind. Damit eignet sich der Weg über /asana-setup besonders für Teams, die erstmals eine KI-Anbindung an ihren bestehenden Workspace einrichten und dabei nicht versehentlich einen falschen Redirect-Port oder eine falsche Client-ID konfigurieren wollen. Wer den zugrundeliegenden Server bereits manuell eingerichtet hat, braucht dieses Plugin nicht zusätzlich – technisch handelt es sich um denselben V2-Server, nur mit geführter statt manueller Einrichtung.
Installationsanleitung
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.
Schritt 1: 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.
claude --version
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.
Schritt 2: 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.
Schritt 3: 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?".
Schritt 4: 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.
claude mcp remove asana
Installation
/plugin install asana@claude-plugins-official
- Anbieter
- Asana
- Lizenz
- Apache-2.0
- Zuletzt geprüft
- 30.09.2026
- GitHub-Sterne
- 37,213