Trello MCP-Server
Ein leistungsstarker MCP-Server für die Interaktion mit Trello-Boards, -Listen und -Karten über AI-Hosts.
Inhaltsverzeichnis
- Inhaltsverzeichnis
- Voraussetzungen
- Vorinstallation
- Installation
- Servermodi
- Konfiguration
- Client-Integration
- Funktionen
- Detaillierte Funktionen
- Verwendung
- Fehlerbehebung
- Beitragen
Voraussetzungen
- Python 3.12 oder höher, kann einfach durch
uv
verwaltet werden - Claude für Desktop installiert
- Trello-Konto und API-Anmeldeinformationen
- UV -Paketmanager installiert
Vorinstallation
- Stellen Sie sicher, dass Sie die Claude Desktop App installiert haben
- Stellen Sie sicher, dass Sie sich bereits mit Ihrem Konto bei Claude angemeldet haben.
- Start Claude
Installation
- Richten Sie die Trello-API-Anmeldeinformationen ein:
- Gehen Sie zur Trello-App-Verwaltung
- Erstellen Sie eine neue Integration bei New Power-Up oder Integration
- Geben Sie Ihre Informationen ein (Sie können die URL des Iframe-Connectors leer lassen) und achten Sie darauf, den richtigen Arbeitsbereich auszuwählen.
- Klicken Sie auf das Symbol Ihrer App und navigieren Sie in der linken Seitenleiste zu „API-Schlüssel“.
- Kopieren Sie Ihren „API-Schlüssel“ und auf der rechten Seite: „Sie können manuell ein Token generieren.“ Klicken Sie auf das Wort „Token“, um Ihr Trello-Token zu erhalten.
- Benennen Sie die Datei
.env.example
im Projektstammverzeichnis in.env
um und legen Sie die Variablen fest, die Sie gerade erhalten haben:
- Installieren Sie uv, falls Sie dies noch nicht getan haben:
- Klonen Sie dieses Repository:
- Installieren Sie Abhängigkeiten und richten Sie den Server für Claude mit uv: ein:
- Starten Sie die Claude Desktop-App neu
Servermodi
Dieser MCP-Server kann in zwei verschiedenen Modi ausgeführt werden:
Claude App-Modus
Dieser Modus lässt sich direkt in die Claude Desktop-Anwendung integrieren:
- Setzen Sie
USE_CLAUDE_APP=true
in Ihrer.env
Datei (das ist die Standardeinstellung) - Führen Sie den Server aus mit:
- Starten Sie die Claude Desktop-Anwendung neu
SSE-Servermodus
Dieser Modus wird als eigenständiger SSE-Server ausgeführt, der mit jedem MCP-kompatiblen Client verwendet werden kann, einschließlich Cursor:
- Setzen Sie
USE_CLAUDE_APP=false
in Ihrer.env
Datei - Führen Sie den Server aus mit:
- Der Server ist standardmäßig unter
http://localhost:8000
(oder Ihrem konfigurierten Port) verfügbar.
Docker-Modus
Sie können den Server auch mit Docker Compose ausführen:
- Stellen Sie sicher, dass Docker und Docker Compose installiert sind
- Erstellen Sie Ihre
.env
Datei mit Ihrer Konfiguration - Erstellen und starten Sie den Container:
- Der Server wird standardmäßig im SSE-Modus ausgeführt
- So zeigen Sie Protokolle an:
- So stoppen Sie den Server:
Konfiguration
Der Server kann mithilfe von Umgebungsvariablen in der .env
Datei konfiguriert werden:
Variable | Beschreibung | Standard |
---|---|---|
TRELLO_API_KEY | Ihr Trello-API-Schlüssel | Erforderlich |
TRELLO_TOKEN | Ihr Trello-API-Token | Erforderlich |
MCP_SERVER_NAME | Der Name des MCP-Servers | Trello MCP-Server |
MCP_SERVER_HOST | Hostadresse für den SSE-Modus | 0.0.0.0 |
MCP_SERVER_PORT | Port für SSE-Modus | 8000 |
USE_CLAUDE_APP | Ob der Claude-App-Modus verwendet werden soll | WAHR |
Sie können den Server anpassen, indem Sie diese Werte in Ihrer .env
Datei bearbeiten.
Client-Integration
Verwendung mit Claude Desktop
- Führen Sie den Server im Claude-App-Modus aus (
USE_CLAUDE_APP=true
) - Starten oder starten Sie Claude Desktop neu
- Claude erkennt automatisch Ihren MCP-Server und verbindet sich mit ihm
Verwendung mit Cursor
So verbinden Sie Ihren MCP-Server mit Cursor:
- Führen Sie den Server im SSE-Modus aus (
USE_CLAUDE_APP=false
) - Gehen Sie im Cursor zu Einstellungen (Zahnradsymbol) > KI > Modellkontextprotokoll
- Fügen Sie einen neuen Server mit der URL
http://localhost:8000
(oder Ihrem konfigurierten Host/Port) hinzu. - Wählen Sie den Server aus, wenn Sie die KI-Funktionen von Cursor verwenden
Sie können diese Konfiguration auch zu Ihrer JSON-Datei mit den Cursoreinstellungen hinzufügen (normalerweise unter ~/.cursor/mcp.json
):
Verwendung mit anderen MCP-Clients
Verweisen Sie andere MCP-kompatible Clients auf den SSE-Endpunkt unter http://localhost:8000
.
Minimales Client-Beispiel
Hier ist ein minimales Python-Beispiel zum Herstellen einer Verbindung mit dem SSE-Endpunkt:
Funktionen
Betrieb | Planke | Liste | Karte | Checklist | Checklistenelement |
---|---|---|---|---|---|
Lesen | ✅ | ✅ | ✅ | ✅ | ✅ |
Schreiben | ❌ | ✅ | ✅ | ✅ | ✅ |
Aktualisieren | ❌ | ✅ | ✅ | ✅ | ✅ |
Löschen | ❌ | ✅ | ✅ | ✅ | ✅ |
Detaillierte Funktionen
Vorstandstätigkeiten
- ✅ Alle Boards lesen
- ✅ Lesen Sie spezifische Boarddetails
Listenvorgänge
- ✅ Lesen Sie alle Listen in einem Board
- ✅ Lesen Sie spezifische Listendetails
- ✅ Neue Listen erstellen
- ✅ Listennamen aktualisieren
- ✅ Listen archivieren (löschen)
Kartenoperationen
- ✅ Lesen Sie alle Karten in einer Liste
- ✅ Lesen Sie spezifische Kartendetails
- ✅ Neue Karten erstellen
- ✅ Kartenattribute aktualisieren
- ✅ Karten löschen
Checkliste Operationen
- ✅ Holen Sie sich eine spezifische Checkliste
- ✅ Alle Checklisten auf einer Karte auflisten
- ✅ Erstellen Sie eine neue Checkliste
- ✅ Aktualisieren Sie eine Checkliste
- ✅ Eine Checkliste löschen
- ✅ Prüfpunkt zur Checkliste hinzufügen
- ✅ Prüfpunkt aktualisieren
- ✅ Häkchen löschen
Verwendung
Nach der Installation können Sie über Claude mit Ihren Trello-Boards interagieren. Hier sind einige Beispielabfragen:
- „Zeig mir alle meine Boards“
- „Welche Listen gibt es im Board [Boardname]?“
- „Erstellen Sie eine neue Karte in der Liste [Listenname] mit dem Titel [Titel]“
- „Aktualisieren Sie die Beschreibung der Karte [card_name]“
- „Archiviere die Liste [list_name]“
Hier sind meine Anwendungsbeispiele:
Fehlerbehebung
Wenn Probleme auftreten:
- Überprüfen Sie Ihre Trello-API-Anmeldeinformationen in der
.env
Datei - Überprüfen Sie, ob Sie über die erforderlichen Berechtigungen in Ihrem Trello-Arbeitsbereich verfügen.
- Stellen Sie sicher, dass Claude für Desktop die neueste Version ausführt
- Überprüfen Sie die Protokolle mit dem Befehl
uv run mcp dev main.py
auf Fehlermeldungen. - Stellen Sie sicher, dass UV ordnungsgemäß installiert ist und sich in Ihrem PATH befindet
Beitragen
Senden Sie uns gerne Probleme und Verbesserungsvorschläge!
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Ein leistungsstarker MCP-Server für die Interaktion mit Trello-Boards, -Listen und -Karten über AI-Hosts.
Related MCP Servers
- -securityFlicense-qualityAn MCP server that enables AI assistants like Claude to interact with Anki flashcard decks, allowing users to create, manage, and update flashcards through natural language conversations.Last updated -1TypeScript
- -securityFlicense-qualityA specialized MCP server that enables AI agents to interact with Reddit, including reading posts, creating content, and managing subreddit configurations.Last updated -715TypeScript
- -securityFlicense-qualityA MCP server that allows AI assistants to interact with the browser, including getting page content as markdown, modifying page styles, and searching browser history.Last updated -5TypeScript
- AsecurityAlicenseAqualityAn MCP server implementation that allows AI assistants to access, search, and interact with Dev.to content, including fetching articles, retrieving user information, and publishing new content.Last updated -1053PythonMIT License