Servidor MCP de Plane

Un servidor del Protocolo de Contexto de Modelo (MCP) para la integración con Plane. Este servidor proporciona herramientas y recursos para interactuar con Plane a través de agentes de IA.

Características

• 🔧 Integración con Plane: Interactúa con las API y servicios de Plane

• 🔌 Múltiples transportes: Admite transportes stdio, SSE y HTTP transmitible

• 🌐 Remoto y local: Funciona tanto localmente como un servicio remoto

• 🛠️ Extensible: Fácil de añadir nuevas herramientas y recursos

Related MCP server: claude-plane

Uso

El servidor admite tres métodos de transporte. Recomendamos usar uvx ya que no requiere instalación.

1. Transporte Stdio (para uso local)

Configuración del cliente MCP (usando uvx - recomendado):

{
  "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. Transporte HTTP remoto con OAuth

Conéctese al servidor MCP de Plane alojado utilizando autenticación OAuth.

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

Configuración del cliente MCP (para herramientas como Claude Desktop sin soporte nativo para MCP remoto):

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

Nota: La autenticación OAuth se gestionará automáticamente al conectarse al servidor remoto.

3. Transporte HTTP remoto usando token PAT

Conéctese al servidor MCP de Plane alojado utilizando un Token de Acceso Personal (PAT).

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

Cabeceras:

• Authorization: Bearer <PAT_TOKEN>

• X-Workspace-slug: <SLUG>

Configuración del cliente MCP (para herramientas como Claude Desktop sin soporte nativo para MCP remoto):

{
  "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. Transporte SSE (Obsoleto)

⚠️ Transporte obsoleto: El transporte SSE (Server-Sent Events) se mantiene por compatibilidad con versiones anteriores. Las nuevas implementaciones deben utilizar el transporte HTTP (secciones 2 o 3) en su lugar.

Conéctese al servidor MCP de Plane alojado utilizando autenticación OAuth a través de Server-Sent Events.

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

Configuración del cliente MCP (para herramientas que admiten el transporte SSE):

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

Nota: La autenticación OAuth se gestionará automáticamente al conectarse al servidor remoto. Este transporte está en desuso en favor del transporte HTTP.

Configuración

Autenticación

El servidor requiere autenticación a través de variables de entorno:

• PLANE_BASE_URL: URL base para la API de Plane (predeterminado: https://api.plane.so) - Opcional

• PLANE_API_KEY: Clave de API para autenticación (requerida para el transporte stdio)

• PLANE_WORKSPACE_SLUG: Identificador slug del espacio de trabajo (requerido para el transporte stdio)

• PLANE_ACCESS_TOKEN: Token de acceso para autenticación (alternativa a la clave de API)

Ejemplo (para el transporte stdio):

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

Nota: Para transportes HTTP remotos (OAuth o PAT), la autenticación se gestiona a través del método de conexión (flujo OAuth o cabeceras PAT) y no requiere estas variables de entorno.

Herramientas disponibles

El servidor proporciona herramientas integrales para interactuar con Plane. Todas las herramientas utilizan modelos Pydantic del SDK de Plane para la seguridad de tipos y la validación.

Proyectos

Elementos de trabajo

Ciclos

Módulos

Iniciativas

Elementos de trabajo de entrada

Propiedades de elementos de trabajo

Usuarios

Total de herramientas: Más de 55 herramientas en 8 categorías

Desarrollo

Ejecución de pruebas

pytest

Formato de código

black plane_mcp/
ruff check plane_mcp/

Licencia

Licencia MIT - consulte LICENSE para más detalles.

Contribución

¡Las contribuciones son bienvenidas! Por favor, siéntase libre de enviar una Pull Request.

Aviso de desaprobación

⚠️ El plane-mcp-server basado en Node.js está en desuso y ya no recibe mantenimiento.

Este repositorio representa la nueva implementación basada en Python+FastMCP del servidor MCP de Plane. Si estaba utilizando la versión anterior de Node.js, migre a esta versión basada en Python para obtener soporte y actualizaciones continuas.

La nueva implementación ofrece:

• Mejor seguridad de tipos con modelos Pydantic

• Rendimiento mejorado con FastMCP

• Cobertura de herramientas mejorada

• Mantenimiento y desarrollo activos

Para obtener ayuda con la migración, consulte los ejemplos de configuración en este README o abra un issue para obtener soporte.

Configuración antigua de Node.js (en desuso):

Si estaba utilizando el anterior @makeplane/plane-mcp-server basado en Node.js, su configuración se veía así:

{
  "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>"
      }
    }
  }
}

Por favor, migre a la nueva configuración basada en Python que se muestra en la sección de Uso anterior.