Asana MCP Server

Was ist der Asana MCP-Server?

Der Asana MCP-Server fungiert als Brücke zwischen Large Language Model (LLM)-Clients und der Asana-API. Er bietet eine einheitliche und sichere Schnittstelle für den Zugriff, die Suche, das Erstellen, Aktualisieren und Analysieren von Asana-Arbeitsbereichen, Projekten, Aufgaben, Kommentaren und Status. Je nach Bedarf gibt es einen Nur-Lese- und einen Vollzugriffsmodus, der sich an verschiedene Sicherheits- und Workflows anpasst.

So konfigurieren Sie den Asana MCP-Server

1. Erstellen Sie ein Asana-Konto:

   • Registrieren Sie sich unter Asana.

2. Generieren Sie ein Asana-Zugangs-Token:

   • Besuchen Sie die Asana Developer Console und erstellen Sie ein persönliches Zugangs-Token.
   • Weitere Informationen: Asana Token-Leitfaden

3. Installieren Sie den Asana MCP-Server:

   • Für die Integration mit Claude Desktop fügen Sie die folgende Konfiguration zu Ihrer claude_desktop_config.json hinzu:

     {
       "mcpServers": {
         "asana": {
           "command": "npx",
           "args": ["-y", "@roychri/mcp-server-asana"],
           "env": {
             "ASANA_ACCESS_TOKEN": "your-asana-access-token"
           }
         }
       }
     }
     

   • Für Claude Code führen Sie aus:

     claude mcp add asana -e ASANA_ACCESS_TOKEN=<TOKEN> -- npx -y @roychri/mcp-server-asana
     

     Ersetzen Sie <TOKEN> durch Ihr Asana-Zugangs-Token.

4. Umgebungsvariablen:

   • ASANA_ACCESS_TOKEN (erforderlich): Ihr Asana-API-Token.
   • READ_ONLY_MODE (optional): Setzen Sie auf true, um Schreiboperationen zu deaktivieren, ideal für Tests oder Nur-Lese-Workflows.

5. Erweiterte Optionen:

   • Um Änderungen lokal zu testen, verwenden Sie den enthaltenen MCP Inspector.
   • Für Beta-Versionen verwenden Sie @roychri/mcp-server-asana@beta.

So verwenden Sie den Asana MCP-Server

Sobald der Server konfiguriert und betriebsbereit ist, macht der Asana MCP-Server automatisch Asana-Tools und -Ressourcen für Ihre MCP-fähige KI-Anwendung (z. B. Claude Desktop) verfügbar. Um ihn zu nutzen:

1. Stellen Sie natürliche Sprachfragen zu Asana-Arbeitsbereichen, Projekten oder Aufgaben.
2. Für gezieltere Interaktionen erwähnen Sie "asana" in Ihrer Eingabeaufforderung, um dem LLM zu helfen, das richtige Tool auszuwählen.
3. Der Server bietet Dutzende anrufbarer Tools wie die Suche nach Aufgaben, das Erstellen von Projekten, das Auflisten von Kommentaren und die Analyse der Aufgabenerfüllung.
4. Sie können die Toolaufrufe über die Benutzeroberfläche Ihrer KI-Anwendung oder den MCP Inspector überwachen und testen.
5. Im Nur-Lese-Modus werden nur sichere Operationen erlaubt; Versuche, Daten zu erstellen oder zu ändern, werden blockiert.

Hauptfunktionen

• Umfassende Integration: Direkte und sichere Anbindung von KI-Anwendungen an die Asana-API, abdeckend die meisten Kernfunktionen.
• Reiche Werkzeugauswahl: Über 20 aufrufbare Tools zum Suchen, Erstellen, Aktualisieren und Analysieren von Aufgaben, Projekten, Status und Kommentaren.
• Anpassbarer Zugang: Unterstützt sowohl Nur-Lese- als auch Lese- und Schreibbetriebsmodi für erhöhte Sicherheit und Kontrolle.
• Vorlage für Eingabeaufforderungen: Eingebaute Generators für häufige Szenarien wie Statuszusammenfassungen und Analyse der Aufgabenerfüllung.
• Ressourcendarstellung: Vollständige Offenbarung von Asana-Arbeitsbereichen und Projekten als strukturierte MCP-Ressourcen für den reichhaltigen Kontext.
• Skalierbare Architektur: Entwickelt für lokale und Cloud/Server-Bereitstellung.
• Open Source & MIT-Lizenz: Kostenlos zu nutzen, zu ändern und in jedem Kontext zu erweitern.

Anwendungsfälle

• Automatisiertes Projekt-Reporting: Lassen Sie Ihre KI den Status von Projekten oder Aufgaben zusammenfassen, Engpässe aufdecken oder überfällige Arbeitselemente hervorheben.
• Intelligentes Aufgabenmanagement: Interagieren Sie mit Asana in natürlicher Sprache, um Aufgaben hands-free zu erstellen, zu aktualisieren oder zu suchen.
• Workflow-Automatisierung: Betreiben Sie Agenten, die Asana-Aktualisierungen basierend auf Gesprächen oder anderen AI-gesteuerten Workflows auslösen.
• Projektprüfung und -analyse: Nutzen Sie eingebaute Tools, um die Aufgabenerfüllung zu überprüfen, Projektstatistiken zu extrahieren oder die Arbeitsverteilung zu analysieren.
• Testen und Nur-Lese-Überwachung: Erkunden oder überwachen Sie Ihre Asana-Umgebung sicher im Nur-Lese-Modus zu Compliance- oder Demozwecken.

FAQ

Q1: Welche Berechtigungen benötigt mein Asana-Konto, um den MCP-Server zu verwenden?
A1: Sie müssen einen Asana-Plan (frei oder bezahlt) haben, der API-Zugang erlaubt. Ihr generiertes Zugangs-Token muss die erforderlichen Lese- oder Schreiboperationen für Ihren Anwendungsfall erlauben.

Q2: Wie kann ich den Asana MCP-Server im Nur-Lese-Modus ausführen, um versehentliche Änderungen zu verhindern?
A2: Setzen Sie die Umgebungsvariable READ_ONLY_MODE=true beim Starten des Servers. Creations-, Update- und Lösch-Tools werden deaktiviert.

Q3: Der Server gibt Berechtigungsfehler zurück. Wie kann ich das lösen?
A3: Überprüfen Sie, ob Ihr Asana-Zugangs-Token korrekt und aktiv ist. Stellen Sie sicher, dass Ihr Asana-Konto API-Zugang hat und die Serverkonfiguration mit Ihren Anmeldeinformationen in claude_desktop_config.json übereinstimmt.

Q4: Wie kann ich den Server lokal testen, ohne eine vollständige Bereitstellung?
A4: Verwenden Sie den MCP Inspector, indem Sie npm run inspector im Serververzeichnis ausführen. Sie können bei Bedarf benutzerdefinierte Ports mit CLIENT_PORT und SERVER_PORT angeben.

Q5: Kann ich diesen Server auch mit anderen LLMs als Claude verwenden?
A5: Ja, solange Ihr KI-Tool das Model Context Protocol unterstützt, kann es sich mit dem Asana MCP-Server verbinden.