Servidor MCP de avión

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los LLM interactuar con Plane.so , lo que les permite gestionar proyectos e incidencias mediante la API de Plane. Con este servidor, LLM como Claude pueden interactuar directamente con sus flujos de trabajo de gestión de proyectos, manteniendo el control y la seguridad de los usuarios.

Características

Enumere todos los proyectos en su espacio de trabajo de Plane
Obtenga información detallada sobre proyectos específicos
Crea nuevos problemas con propiedades personalizables
Enumerar y filtrar problemas de los proyectos
Obtenga información detallada sobre temas específicos
Actualizar los problemas existentes con nueva información

Prerrequisitos

Node.js 22.x o superior
Una clave API de Plane.so
Un espacio de trabajo de Plane.so

Instalación

Opción 1: Uso de herrería

La forma más rápida de comenzar es usar Smithery para instalar el servidor directamente:

# Install to Claude for Desktop
npx -y @smithery/cli install @kelvin6365/plane-mcp-server --client claude

Este comando configurará automáticamente el servidor MCP de Plane para su uso con Claude. Tras la instalación, deberá configurar el servidor con su clave API de Plane y el slug del espacio de trabajo a través de la configuración de Claude.

Las opciones de cliente válidas son: claude, cline, windsurf, roo-cline, witsy, enconvo, cursor

Ejemplo de instalación con Cursor:

npx -y @smithery/cli install @kelvin6365/plane-mcp-server --client cursor

Opción 2: Configuración manual

Si prefiere configurar el servidor manualmente, siga estos pasos:

Clonar este repositorio:

git clone https://github.com/kelvin6365/plane-mcp-server.git
cd plane-mcp-server

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Uso con Claude para escritorio

Nota: Si usó la Opción 1 (Smithery) mencionada anteriormente, puede omitir esta sección. Smithery configura automáticamente el servidor MCP.

Abra el archivo de configuración de Claude for Desktop:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Ventanas: %APPDATA%\Claude\claude_desktop_config.json
Agregue la configuración del servidor Plane MCP:

{
  "mcpServers": {
    "plane": {
      "command": "node",
      "args": ["path/to/plane-mcp-server/build/index.js"],
      "env": {
        "PLANE_API_KEY": "your_plane_api_key_here",
        "PLANE_WORKSPACE_SLUG": "your_workspace_slug_here"
      }
    }
  }
}

Reiniciar Claude para escritorio

Herramientas disponibles

Nota: Los nombres de las herramientas usan guiones (p. ej., list-projects ), no guiones bajos. El servidor convertirá automáticamente los guiones bajos a guiones para mayor compatibilidad.

lista-proyectos

Enumera todos los proyectos en su espacio de trabajo de Plane.

Parámetros: Ninguno

Ejemplo:

{}

obtener-proyecto

Obtiene información detallada sobre un proyecto específico.

Parámetros:

project_id : ID del proyecto a recuperar

Ejemplo:

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef"
}

crear problema

Crea un nuevo problema en un proyecto específico.

Parámetros:

project_id : ID del proyecto donde se debe crear el problema
name : Título del número
description_html : Descripción HTML del problema (requerida por la API de Plane)
priority (opcional): Prioridad del asunto ("urgente", "alta", "media", "baja", "ninguna")
state_id (opcional): ID del estado para este problema
assignees (opcional): Matriz de ID de usuarios para asignar a este problema

Nota: El parámetro assignees debe ser una matriz de cadenas de ID de usuario. Errores comunes incluyen proporcionar un diccionario/objeto en lugar de una matriz, o anidar accidentalmente todos los datos del problema dentro del campo "assignees". El servidor intentará gestionar estos casos, pero se recomienda usar el formato correcto.

Ejemplo:

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef",
  "name": "Implement new feature",
  "description_html": "<p>We need to implement the new reporting feature</p>",
  "priority": "high",
  "assignees": ["user-id-1", "user-id-2"]
}

problemas de lista

Enumera los problemas de un proyecto específico con filtrado opcional.

Parámetros:

project_id : ID del proyecto del cual se obtendrán los problemas
state_id (opcional): Filtrar por ID de estado
priority (opcional): Filtrar por prioridad
assignee_id (opcional): Filtrar por ID de cesionario
limit (opcional): número máximo de números a devolver (predeterminado: 50)

Ejemplo:

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef",
  "priority": "high",
  "limit": 10
}

obtener problema

Obtiene información detallada sobre un problema específico.

Parámetros:

project_id : ID del proyecto que contiene el problema
issue_id : ID del problema a recuperar

Ejemplo:

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef",
  "issue_id": "01def456-7890-12gh-3456-789ijklmnopq"
}

problema de actualización

Actualiza un problema existente en un proyecto.

Parámetros:

project_id : ID del proyecto que contiene el problema
issue_id : ID del problema a actualizar
name (opcional): Título actualizado del problema
description_html (opcional): descripción HTML del problema (requerida por la API de Plane)
priority (opcional): Prioridad actualizada del problema
state_id (opcional): ID de estado actualizado del problema
assignees (opcional): matriz actualizada de identificaciones de usuarios para asignar a este problema

Nota: El parámetro assignees debe ser una matriz de cadenas de identificación de usuario, siguiendo las mismas pautas de formato que la herramienta de creación de problemas.

Ejemplo:

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef",
  "issue_id": "01def456-7890-12gh-3456-789ijklmnopq",
  "priority": "urgent",
  "description_html": "<p>Updated description with <strong>more details</strong></p>"
}

Desarrollo

Instalar dependencias de desarrollo:

npm install --save-dev typescript @types/node

Inicie el servidor en modo de desarrollo:

npm run dev

Pruebas

Puede probar el servidor utilizando el Inspector MCP:

npx @modelcontextprotocol/inspector node dist/index.js

Ejemplos

A continuación se muestran algunos ejemplos de interacciones que puedes probar con Claude después de configurar el servidor Plane MCP:

"¿Puedes enumerar todos los proyectos en mi espacio de trabajo de Plane?"
Por favor, cree un nuevo problema de alta prioridad en el proyecto de Marketing titulado "Actualizar la estrategia de redes sociales".
"¿Cuáles son todos los temas de alta prioridad en el proyecto de desarrollo?"
Se actualizó el problema n.° 123 del proyecto de control de calidad para cambiar su prioridad a urgente.

Claude utilizará las herramientas adecuadas para interactuar con Plane y solicitará su aprobación antes de crear o modificar cualquier problema.

Consideraciones de seguridad

La clave API requiere permisos de avión adecuados para funcionar
Todas las operaciones que modifican datos requieren la aprobación explícita del usuario
Las variables de entorno deben estar protegidas adecuadamente
Las claves API nunca deben comprometerse con el control de versiones

Contribuyendo

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Apoyo

Si encuentra algún problema o tiene preguntas:

Consulta la sección de problemas de GitHub
Consulte la documentación de MCP en modelcontextprotocol.io
Abrir una nueva emisión con pasos de reproducción detallados

Plane MCP Server

Integrations