Plane MCP-Server

Ein Model Context Protocol (MCP)-Server für die Plane-Integration. Dieser Server stellt Tools und Ressourcen bereit, um über KI-Agenten mit Plane zu interagieren.

Funktionen

• 🔧 Plane-Integration: Interaktion mit Plane-APIs und -Diensten

• 🔌 Mehrere Transporte: Unterstützt stdio-, SSE- und streamfähige HTTP-Transporte

• 🌐 Remote & Lokal: Funktioniert sowohl lokal als auch als Remote-Dienst

• 🛠️ Erweiterbar: Einfaches Hinzufügen neuer Tools und Ressourcen

Related MCP server: claude-plane

Verwendung

Der Server unterstützt drei Transportmethoden. Wir empfehlen die Verwendung von uvx, da hierfür keine Installation erforderlich ist.

1. Stdio-Transport (für die lokale Nutzung)

MCP-Client-Konfiguration (unter Verwendung von uvx - empfohlen):

{
  "mcpServers": {
    "plane": {
      "command": "uvx",
      "args": ["plane-mcp-server", "stdio"],
      "env": {
        "PLANE_API_KEY": "<your-api-key>",
        "PLANE_WORKSPACE_SLUG": "<your-workspace-slug>",
        "PLANE_BASE_URL": "https://api.plane.so"
      }
    }
  }
}

2. Remote-HTTP-Transport mit OAuth

Verbindung zum gehosteten Plane MCP-Server mittels OAuth-Authentifizierung.

URL: https://mcp.plane.so/http/mcp

MCP-Client-Konfiguration (für Tools wie Claude Desktop ohne native Remote-MCP-Unterstützung):

{
  "mcpServers": {
    "plane": {
      "command": "npx",
      "args": ["mcp-remote@latest", "https://mcp.plane.so/http/mcp"]
    }
  }
}

Hinweis: Die OAuth-Authentifizierung wird bei der Verbindung zum Remote-Server automatisch abgewickelt.

3. Remote-HTTP-Transport mit PAT-Token

Verbindung zum gehosteten Plane MCP-Server mittels Personal Access Token (PAT).

URL: https://mcp.plane.so/api-key/mcp

Header:

• Authorization: Bearer <PAT_TOKEN>

• X-Workspace-slug: <SLUG>

MCP-Client-Konfiguration (für Tools wie Claude Desktop ohne native Remote-MCP-Unterstützung):

{
  "mcpServers": {
    "plane": {
      "command": "npx",
      "args": ["mcp-remote@latest", "https://mcp.plane.so/http/api-key/mcp"],
      "headers": {
        "Authorization": "Bearer <PAT_TOKEN>",
        "X-Workspace-slug": "<SLUG>"
      }
    }
  }
}

4. SSE-Transport (Veraltet)

⚠️ Veralteter Transport: Der SSE-Transport (Server-Sent Events) wird aus Gründen der Abwärtskompatibilität beibehalten. Neue Implementierungen sollten stattdessen den HTTP-Transport (Abschnitt 2 oder 3) verwenden.

Verbindung zum gehosteten Plane MCP-Server mittels OAuth-Authentifizierung über Server-Sent Events.

URL: https://mcp.plane.so/sse

MCP-Client-Konfiguration (für Tools, die den SSE-Transport unterstützen):

{
  "mcpServers": {
    "plane": {
      "command": "npx",
      "args": ["mcp-remote@latest", "https://mcp.plane.so/sse"]
    }
  }
}

Hinweis: Die OAuth-Authentifizierung wird bei der Verbindung zum Remote-Server automatisch abgewickelt. Dieser Transport ist zugunsten des HTTP-Transports veraltet.

Konfiguration

Authentifizierung

Der Server erfordert eine Authentifizierung über Umgebungsvariablen:

• PLANE_BASE_URL: Basis-URL für die Plane-API (Standard: https://api.plane.so) - Optional

• PLANE_API_KEY: API-Schlüssel für die Authentifizierung (erforderlich für Stdio-Transport)

• PLANE_WORKSPACE_SLUG: Workspace-Slug-Bezeichner (erforderlich für Stdio-Transport)

• PLANE_ACCESS_TOKEN: Zugriffstoken für die Authentifizierung (Alternative zum API-Schlüssel)

Beispiel (für Stdio-Transport):

export PLANE_BASE_URL="https://api.plane.so"
export PLANE_API_KEY="your-api-key"
export PLANE_WORKSPACE_SLUG="your-workspace-slug"

Hinweis: Bei Remote-HTTP-Transporten (OAuth oder PAT) erfolgt die Authentifizierung über die Verbindungsmethode (OAuth-Flow oder PAT-Header) und erfordert diese Umgebungsvariablen nicht.

Verfügbare Tools

Der Server bietet umfassende Tools für die Interaktion mit Plane. Alle Tools verwenden Pydantic-Modelle aus dem Plane-SDK für Typsicherheit und Validierung.

Projekte

Arbeitselemente (Work Items)

Zyklen (Cycles)

Module

Initiativen

Intake-Arbeitselemente

Arbeitselement-Eigenschaften

Benutzer

Gesamtanzahl Tools: 55+ Tools in 8 Kategorien

Entwicklung

Tests ausführen

pytest

Code-Formatierung

black plane_mcp/
ruff check plane_mcp/

Lizenz

MIT-Lizenz - siehe LICENSE für Details.

Mitwirken

Beiträge sind willkommen! Bitte zögern Sie nicht, einen Pull Request einzureichen.

Hinweis zur Veraltung

⚠️ Der Node.js-basierte plane-mcp-server ist veraltet und wird nicht mehr gewartet.

Dieses Repository stellt die neue Python+FastMCP-basierte Implementierung des Plane MCP-Servers dar. Wenn Sie die vorherige Node.js-Version verwendet haben, migrieren Sie bitte auf diese Python-basierte Version, um weiterhin Support und Updates zu erhalten.

Die neue Implementierung bietet:

• Bessere Typsicherheit mit Pydantic-Modellen

• Verbesserte Leistung mit FastMCP

• Erweiterte Tool-Abdeckung

• Aktive Wartung und Entwicklung

Für Unterstützung bei der Migration lesen Sie bitte die Konfigurationsbeispiele in dieser README oder eröffnen Sie ein Issue für Support.

Alte Node.js-Konfiguration (Veraltet):

Wenn Sie das vorherige Node.js-basierte @makeplane/plane-mcp-server verwendet haben, sah Ihre Konfiguration wie folgt aus:

{
  "mcpServers": {
    "plane": {
      "command": "npx",
      "args": [
        "-y",
        "@makeplane/plane-mcp-server"
      ],
      "env": {
        "PLANE_API_KEY": "<YOUR_API_KEY>",
        "PLANE_API_HOST_URL": "<HOST_URL_FOR_SELF_HOSTED>",
        "PLANE_WORKSPACE_SLUG": "<YOUR_WORKSPACE_SLUG>"
      }
    }
  }
}

Bitte migrieren Sie auf die neue Python-basierte Konfiguration, die im Abschnitt „Verwendung“ oben gezeigt wird.