Asana MCP Server einrichten

Was der Asana MCP Server ist

Der Asana MCP Server ist die offizielle Implementierung des Model-Context-Protocol-Standards durch den Projektmanagement-Anbieter Asana. Laut Anbieter erlaubt der Server KI-Assistenten und anderen Anwendungen Zugriff auf den sogenannten Asana Work Graph, also die vernetzte Struktur aus Aufgaben, Projekten, Portfolios, Zielen und Teams. Damit lassen sich Aufgaben und Projekte per natürlicher Sprache anlegen und verwalten, Berichte und Zusammenfassungen aus Asana-Daten generieren und Projektdaten mit KI-gestützten Einblicken analysieren. Der aktuelle V2-Server ist unter der Adresse mcp.asana.com/v2/mcp erreichbar; eine ältere Beta-Version unter mcp.asana.com/sse wird laut Dokumentation zu einem festen Stichtag abgeschaltet, weshalb Clients auf die V2-Adresse umgestellt werden sollten.

Voraussetzungen und Verbindungsaufbau

Für die Nutzung wird laut Anbieter ein MCP-Client benötigt, der das Streamable-HTTP-Transportprotokoll unterstützt; eine Liste kompatibler Clients wird in der Asana-Dokumentation gepflegt. Zusätzlich darf die verwendete Client-Anwendung nicht über das Asana-App-Management der eigenen Organisation blockiert sein, sonst erscheint bei der Autorisierung eine Aufforderung, die zuständige Administration um Freischaltung zu bitten. Der Verbindungsaufbau selbst läuft über OAuth: Der Client wird auf die V2-Server-Adresse konfiguriert, worauf der Nutzer aufgefordert wird, sich mit dem eigenen Asana-Konto zu authentifizieren und den Zugriff zu autorisieren. Für Clients, die diesen Prozess nicht automatisch abwickeln, kann laut Anbieter ein über den Integrationsleitfaden erzeugtes Client-ID/Client-Secret-Paar notwendig sein.

Verfügbare Werkzeuge

Der Server stellt laut Referenzdokumentation drei Kategorien von Werkzeugen bereit: Lesewerkzeuge liefern Daten aus dem Workspace, ohne etwas zu verändern, etwa search_objects für eine universelle Suche über Aufgaben, Projekte, Portfolios, Ziele, Teams, Nutzer, Tags und benutzerdefinierte Felder, oder get_task für die vollständigen Details einer einzelnen Aufgabe samt Unteraufgaben und Kommentaren. Schreibwerkzeuge erstellen, ändern oder löschen Daten im Workspace. Interaktive Werkzeuge zeigen vor einer Änderung zusätzlich eine Bestätigungsoberfläche an; diese Variante ist laut Anbieter aktuell in Claude und ChatGPT verfügbar. Da sich die genaue Werkzeugliste laut Anbieter fortlaufend weiterentwickelt, wird empfohlen, den Befehl tools/list im jeweiligen Client zu nutzen, um stets den aktuellen Stand zu sehen.

Zugriffsrechte und Sicherheit

Besonders zu beachten ist laut Dokumentation, dass MCP-Anwendungen in Asana keine granularen Berechtigungsbereiche verwenden: Sobald ein Nutzer einen MCP-Client autorisiert, erhält das ausgestellte Token automatisch Zugriff auf alle verfügbaren Werkzeuge. Die eigentliche Einschränkung erfolgt über die bestehenden Asana-Berechtigungen der jeweiligen Person, ein Werkzeug kann also nur auf Projekte und Aufgaben zugreifen, die der authentifizierte Nutzer ohnehin einsehen darf. Kundinnen und Kunden in den Tarifstufen Enterprise+ oder Legacy Enterprise können über das Asana-App-Management einzelne MCP-Clients gezielt blockieren oder erlauben; in anderen Tarifstufen ist dafür eine Anfrage an den Asana-Support durch eine Super-Administratorin oder einen Super-Administrator notwendig.

Praxisnutzen und Grenzen

Im Alltag eignet sich der Server für Anfragen wie das Auflisten aller in dieser Woche fälligen, noch offenen Aufgaben, das Anlegen einer neuen Aufgabe im passenden Projekt oder das Abfragen des Status eines laufenden Projekts, jeweils direkt aus der Konversation mit dem Assistenten heraus, ohne die Asana-Oberfläche manuell zu öffnen. Für Programmier-Werkzeuge wie Claude Code, Codex, Cursor oder VS Code gibt es laut Anbieter eine gesonderte, ausführlichere Anleitung zur Anbindung solcher Coding-Clients. Die Grenze liegt darin, dass ohne granulare Berechtigungsscopes jede Autorisierung vollen Werkzeugzugriff im Rahmen der Nutzerrechte gewährt; wer feinere Kontrolle benötigt, muss diese über die Asana-eigene Rollenverwaltung steuern, nicht über den MCP-Server selbst. Bei Verbindungsproblemen empfiehlt der Anbieter, sich ab- und wieder anzumelden sowie zu prüfen, ob die notwendigen Berechtigungen im Workspace tatsächlich vorhanden sind.