Trello MCP-Server

Ein Model Context Protocol (MCP)-Server, der Tools zum Abrufen und Interagieren mit Trello-Boards, -Listen und -Karten bereitstellt.

Funktionen

• Alle Boards für den authentifizierten Benutzer abrufen

• Board-Details abrufen

• Listen von einem Board abrufen

• Karten von Boards oder Listen abrufen

• Spezifische Kartendetails abrufen

• Karten über Boards hinweg suchen

• Kartenaktionen/-verlauf abrufen

Related MCP server: Trello MCP Server

Einrichtung

1. Trello API-Anmeldedaten abrufen

Wichtig: Sie müssen ein Power-Up erstellen, um API-Anmeldedaten zu erhalten.

1. Besuchen Sie https://trello.com/power-ups/admin

2. Klicken Sie auf "Create New Power-Up" (oder die Schaltfläche "Crear")

3. Geben Sie die grundlegenden Informationen ein:

   • Name: "Trello MCP" (oder ein Name Ihrer Wahl)

   • Workspace: Wählen Sie Ihren Workspace aus

4. Sobald das Power-Up erstellt ist, gehen Sie zum Abschnitt "API Key" in Ihren Power-Up-Einstellungen

5. Sie sehen Ihren API Key (eine 32-stellige Zeichenfolge)

6. Klicken Sie auf den "Token"-Link (oder "token" in der Beschreibung), um Ihr API-Token zu generieren

7. Autorisieren Sie das Token, wenn Sie dazu aufgefordert werden

8. Kopieren Sie sowohl den API key als auch das API token

Alternativ können Sie direkt zu https://trello.com/app-key gehen, falls Sie bereits ein Power-Up erstellt haben.

2. Abhängigkeiten installieren

npm install

3. Umgebungsvariablen konfigurieren

Kopieren Sie die Beispiel-Umgebungsdatei und fügen Sie Ihre Anmeldedaten hinzu:

cp .env.example .env

Bearbeiten Sie .env und fügen Sie Ihre Anmeldedaten hinzu:

TRELLO_API_KEY=your_actual_api_key
TRELLO_API_TOKEN=your_actual_api_token

4. Server testen

Starten Sie den Server direkt:

npm start

Konfiguration

Sie können diesen MCP-Server global in Claude Desktop oder projektbezogen in der Claude Code CLI konfigurieren.

Option 1: Globale Konfiguration (Claude Desktop)

Bearbeiten Sie Ihre Claude Desktop-Konfigurationsdatei:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Fügen Sie die folgende Konfiguration hinzu:

{
  "mcpServers": {
    "trello": {
      "command": "node",
      "args": ["/absolute/path/to/trello-mcp/index.js"],
      "env": {
        "TRELLO_API_KEY": "your_api_key_here",
        "TRELLO_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Ersetzen Sie /absolute/path/to/trello-mcp/ durch den tatsächlichen Pfad zu diesem Verzeichnis.

Starten Sie nach dem Hinzufügen der Konfiguration Claude Desktop neu.

Option 2: Projektbezogene Konfiguration (Claude Code CLI)

Für die Claude Code CLI werden MCP-Server projektbezogen in ~/.claude.json konfiguriert.

Wichtig: Sie müssen das Feld type: "stdio" und die env-Variablen direkt in die Konfiguration aufnehmen. Die .env-Datei wird nicht automatisch geladen.

Verwenden Sie diesen Befehl, um ein spezifisches Projekt zu konfigurieren:

# Using jq to add the configuration
jq '.projects."/path/to/your/project".mcpServers.trello = {
  "type": "stdio",
  "command": "node",
  "args": ["/Users/ehigu/Documents/Esteban/Projects/habitus/webapp/trello-mcp/index.js"],
  "env": {
    "TRELLO_API_KEY": "your_api_key_here",
    "TRELLO_API_TOKEN": "your_api_token_here"
  }
}' ~/.claude.json > /tmp/claude_config.json && mv /tmp/claude_config.json ~/.claude.json

Oder bearbeiten Sie ~/.claude.json manuell:

{
  "projects": {
    "/path/to/your/project": {
      "mcpServers": {
        "trello": {
          "type": "stdio",
          "command": "node",
          "args": ["/Users/ehigu/Documents/Esteban/Projects/habitus/webapp/trello-mcp/index.js"],
          "env": {
            "TRELLO_API_KEY": "your_api_key_here",
            "TRELLO_API_TOKEN": "your_api_token_here"
          }
        }
      }
    }
  }
}

Starten Sie nach dem Hinzufügen der Konfiguration Claude Code neu.

Verfügbare Tools

get_my_boards

Ruft alle Boards für den authentifizierten Benutzer ab.

Parameter:

• filter (optional): Filtert Boards nach Typ (all, open, closed, starred, organization, public, members). Standard: "open"

get_board

Ruft Details eines bestimmten Boards ab.

Parameter:

• board_id (erforderlich): Die ID des Boards

get_board_lists

Ruft alle Listen auf einem Board ab.

Parameter:

• board_id (erforderlich): Die ID des Boards

• filter (optional): Filtert Listen (all, open, closed, none). Standard: "open"

get_board_cards

Ruft alle Karten auf einem Board ab.

Parameter:

• board_id (erforderlich): Die ID des Boards

get_list_cards

Ruft alle Karten in einer bestimmten Liste ab.

Parameter:

• list_id (erforderlich): Die ID der Liste

get_card

Ruft Details einer bestimmten Karte ab.

Parameter:

• card_id (erforderlich): Die ID der Karte

search_cards

Sucht nach Karten über alle Boards hinweg.

Parameter:

• query (erforderlich): Suchanfrage

• board_ids (optional): Durch Kommas getrennte Board-IDs, in denen gesucht werden soll

get_card_actions

Ruft Aktionen (Aktivität/Verlauf) für eine bestimmte Karte ab.

Parameter:

• card_id (erforderlich): Die ID der Karte

Nutzungsbeispiele

Sobald die Konfiguration in Claude Desktop erfolgt ist, können Sie natürliche Sprache verwenden, um mit Ihren Trello-Boards zu interagieren:

• "Zeige mir alle meine offenen Trello-Boards"

• "Rufe die Karten vom Board [board_id] ab"

• "Suche nach Karten, die 'bug fix' enthalten"

• "Zeige mir die Details der Karte [card_id]"

• "Welche Listen befinden sich auf meinem Board?"

Fehlerbehebung

Authentifizierungsfehler

Wenn Authentifizierungsfehler auftreten:

1. Überprüfen Sie, ob Ihr API-Key und Ihr Token korrekt sind

2. Stellen Sie sicher, dass das Token nicht abgelaufen ist

3. Generieren Sie das Token bei Bedarf unter https://trello.com/app-key neu

Server startet nicht

1. Überprüfen Sie, ob Node.js installiert ist: node --version

2. Stellen Sie sicher, dass die Abhängigkeiten installiert sind: npm install

3. Überprüfen Sie, ob die Umgebungsvariablen korrekt gesetzt sind

MCP-Server zeigt Status "Failed" an

Wenn der MCP-Server in Claude Code als "failed" angezeigt wird:

1. Fehlendes type-Feld: Stellen Sie sicher, dass Ihre Konfiguration "type": "stdio" enthält. Dies ist für die Claude Code CLI erforderlich.

2. Umgebungsvariablen nicht geladen: Die .env-Datei wird NICHT automatisch geladen, wenn Claude Code den MCP-Server ausführt. Sie müssen das env-Objekt mit Ihren API-Anmeldedaten direkt in die Konfiguration aufnehmen:

   {
     "type": "stdio",
     "command": "node",
     "args": ["/path/to/trello-mcp/index.js"],
     "env": {
       "TRELLO_API_KEY": "your_api_key",
       "TRELLO_API_TOKEN": "your_api_token"
     }
   }

3. Logs prüfen: Führen Sie claude --debug aus, um detaillierte Fehlerprotokolle zu sehen

4. Manuell testen: Starten Sie den Server direkt, um zu überprüfen, ob er funktioniert:

   cd /path/to/trello-mcp
   TRELLO_API_KEY=your_key TRELLO_API_TOKEN=your_token node index.js

5. Claude Code neu starten: Beenden Sie Claude Code nach Konfigurationsänderungen vollständig und starten Sie es neu

MCP-Server wird nicht in Claude angezeigt

1. Überprüfen Sie, ob der Pfad in Ihrer Konfiguration absolut und korrekt ist

2. Starten Sie Claude Desktop/Code vollständig neu

3. Überprüfen Sie die Claude Desktop-Logs auf Fehler

4. Überprüfen Sie bei der Claude Code CLI, ob sich die Konfiguration im richtigen Projektpfad in ~/.claude.json befindet

Lizenz

MIT