Asana MCP einrichten: V2, OAuth und Projektzugriff

Notieren Sie vor der Einrichtung eine Aufgabe, die Sie in Asana öffnen können: Titel, Projekt und Zuständigkeit reichen für einen ersten Vergleich. Verwenden Sie möglichst ein eigenes Testprojekt ohne vertrauliche Inhalte. Die spätere Antwort soll genau diese Aufgabe wiedergeben; eine Anmeldung allein bestätigt den Zugriff auf Ihr Projekt noch nicht.

V2 verwenden und die MCP-App registrieren

Der aktuelle Endpunkt lautet https://mcp.asana.com/v2/mcp. Der frühere V1-Zugang unter /sse ist abgelöst. Für V2 registrieren Sie im Asana-Entwicklerbereich eine App vom Typ „MCP app“. Eine normale API-App oder ein persönliches API-Token ersetzt diesen OAuth-Weg nicht. Legen Sie in den Verteilungseinstellungen fest, für welchen Workspace die App verfügbar sein soll.

VS Code verbinden

Fügen Sie der MCP-App beide Redirect-URLs hinzu: http://127.0.0.1:33418/ und https://vscode.dev/redirect. Der abschließende Schrägstrich der lokalen Adresse gehört dazu. Öffnen Sie in VS Code „MCP: Add Server“, wählen Sie HTTP und tragen Sie den V2-Endpunkt ein. Für eine vorhandene .vscode/mcp.json sieht der Servereintrag so aus:

{
  "servers": {
    "asana": {
      "type": "http",
      "url": "https://mcp.asana.com/v2/mcp"
    }
  }
}

VS Code fragt die Client-ID und das Client-Secret der registrierten App im Anmeldeablauf ab, weil Asana keine dynamische Clientregistrierung anbietet. Tragen Sie das Secret dort ein, nicht in die Projektdatei. Schließen Sie anschließend die OAuth-Freigabe im Browser ab. Der VS-Code-Leitfaden erklärt die Dateiformate und den ersten Start.

Den ersten Abruf begrenzen

1. Prüfen Sie das angemeldete Konto und den Workspace. Gleiche Projektnamen können in unterschiedlichen Workspaces vorkommen.

2. Lesen Sie die Werkzeugliste und wählen Sie eine lesende Funktion. Lassen Sie die vorbereitete Aufgabe im ausdrücklich genannten Projekt suchen.

3. Vergleichen Sie Titel, Aufgabenkennung und Zuständigkeit mit der Asana-Oberfläche. Öffnen Sie einen zurückgegebenen Aufgabenlink nur, wenn seine Domain und sein Ziel passen.

4. Notieren Sie Datum, Projektkennung und Ergebnis. Wiederholen Sie den Abruf nach einem Neustart des Clients, bevor Sie weitere Projekte einbeziehen.

Fehler an der richtigen Stelle suchen

MCP handelt mit den Rechten der angemeldeten Person. Eine lesend formulierte Aufgabe entzieht dem Konto keine Schreibrechte. Aktivieren Sie für Ihren ersten Versuch nur die benötigten Werkzeuge und prüfen Sie den Zugriffsplan. Eine leere Suchantwort ist kein Nachweis fehlender Daten: Vergleichen Sie zunächst denselben Projektbereich in Asana. Die Registersuche zu Asana zeigt zusätzlich die Angaben verschiedener Anbieter; sie ersetzt die App-Registrierung nicht.

Kann ich einen alten SSE-Eintrag weiterverwenden?

Richten Sie den dokumentierten V2-Zugang ein. Ein bloßer Austausch der URL reicht nicht, wenn die registrierte MCP-App und ihre OAuth-Einstellungen fehlen.

Warum fragt VS Code nach einer Client-ID?

Asanas V2-Server verlangt eine zuvor registrierte MCP-App. Übernehmen Sie die Werte aus Ihrer eigenen App und prüfen Sie deren Workspace-Freigabe.

Ist die Verbindung automatisch nur lesend?

Nein. Der Zugriff folgt den Rechten des autorisierenden Kontos. Prüfen Sie Kontorechte und die im Client freigegebenen Werkzeuge getrennt.

Was sollte ich für eine Übergabe dokumentieren?

Endpunkt, Workspace, Projektkennung, Client und einen wiederholbaren Lesetest. Geben Sie keine Secrets oder Zugriffstokens in einer gemeinsamen Anleitung weiter.

Weitere Werkzeuge finden Sie in der App-Auswahl für Team und Projekte.

Herstellerdokumentation am 2. Oktober 2026 geprüft. Die Prüfschritte sind ein Vorschlag für Ihre Umgebung, kein angemeldeter Kontotest.

1. Asana: MCP integration
   Abrufbefehl anzeigen

   curl -s https://developers.asana.com/docs/integrating-with-asanas-mcp-server
2. Asana: client setup
   Abrufbefehl anzeigen

   curl -s https://developers.asana.com/docs/connecting-mcp-clients-to-asanas-v2-server
3. VS Code: MCP configuration
   Abrufbefehl anzeigen

   curl -s https://code.visualstudio.com/docs/agent-customization/mcp-servers

Alle Beiträge