Servidor MCP de avión

El servidor MCP de Plane es un servidor de protocolo de contexto de modelo (MCP) que proporciona una integración perfecta con las API de Plane, lo que habilita proyectos, elementos de trabajo y capacidades de automatización para desarrolladores e interfaces de IA.

Casos de uso

Crear, actualizar proyectos y elementos de trabajo
Asignar personas, propiedades y escribir comentarios para avanzar en el trabajo
Moverse y observar con varios elementos de trabajo en los estados
Agregar etiquetas a los elementos de trabajo
Extracción y análisis de datos de proyectos y miembros dentro de Plane
Creación de herramientas y aplicaciones impulsadas por IA que interactúan con el ecosistema de Plane

Parámetros de configuración

PLANE_API_KEY : El token de API del usuario. Se puede obtener en la página /settings/api-tokens/ de la interfaz de usuario.
PLANE_WORKSPACE_SLUG : el slug del espacio de trabajo para su instancia de Plane.
PLANE_API_HOST_URL (opcional): URL del host del servidor API de Plane. El valor predeterminado es https://api.plane.so/

Herramientas

Usuarios

get_user - Obtener la información del usuario actual
- No se requieren parámetros

Proyectos

get_projects - Obtener todos los proyectos del usuario actual
- No se requieren parámetros
create_project - Crea un nuevo proyecto
- name : Nombre del proyecto (cadena, obligatorio)

Tipos de problemas

list_issue_types : obtiene todos los tipos de problemas para un proyecto específico
- project_id : UUID del proyecto (cadena, obligatoria)
get_issue_type - Obtener detalles de un tipo de problema específico
- project_id : UUID del proyecto (cadena, obligatoria)
- type_id : UUID del tipo de problema (cadena, obligatoria)
create_issue_type - Crea un nuevo tipo de problema en un proyecto
- project_id : UUID del proyecto (cadena, obligatoria)
- issue_type_data : Objeto que contiene:
  - name : Nombre del tipo de problema (cadena, obligatorio)
  - description : Descripción del tipo de problema (cadena, obligatoria)
update_issue_type - Actualizar un tipo de problema existente
- project_id : UUID del proyecto (cadena, obligatoria)
- type_id : UUID del tipo de problema (cadena, obligatoria)
- issue_type_data : Campos para actualizar sobre el tipo de problema (objeto)
delete_issue_type - Eliminar un tipo de problema
- project_id : UUID del proyecto (cadena, obligatoria)
- type_id : UUID del tipo de problema (cadena, obligatoria)

Estados

list_states - Obtener todos los estados de un proyecto específico
- project_id : UUID del proyecto (cadena, obligatoria)
get_state - Obtener detalles de un estado específico
- project_id : UUID del proyecto (cadena, obligatoria)
- state_id : UUID del estado (cadena, obligatoria)
create_state - Crea un nuevo estado en un proyecto
- project_id : UUID del proyecto (cadena, obligatoria)
- state_data : Objeto que contiene:
  - name : Nombre del estado (cadena, obligatorio)
  - color : Código de color para el estado (cadena, obligatorio)
update_state - Actualizar un estado existente
- project_id : UUID del proyecto (cadena, obligatoria)
- state_id : UUID del estado (cadena, obligatoria)
- state_data : Campos para actualizar en el estado (objeto)
delete_state - Eliminar un estado
- project_id : UUID del proyecto (cadena, obligatoria)
- state_id : UUID del estado (cadena, obligatoria)

Asuntos

get_issue_using_readable_identifier : obtiene los detalles del problema mediante un identificador legible (por ejemplo, PROJ-123)
- project_identifier : Identificador del proyecto (p. ej., "PROJ") (cadena, obligatoria)
- issue_identifier : Número de problema (p. ej., "123") (cadena, obligatoria)
get_issue_comments - Obtener todos los comentarios de un problema específico
- project_id : UUID del proyecto (cadena, obligatoria)
- issue_id : UUID del problema (cadena, obligatoria)
add_issue_comment - Agregar un comentario a un problema
- project_id : UUID del proyecto (cadena, obligatoria)
- issue_id : UUID del problema (cadena, obligatoria)
- comment_html : contenido HTML del comentario (cadena, obligatoria)
create_issue - Crea un nuevo problema
- project_id : UUID del proyecto (cadena, obligatoria)
- issue_data : Objeto que contiene:
  - name : Título del problema (cadena, obligatorio)
  - description_html : Descripción HTML del problema (cadena, obligatoria)
update_issue - Actualizar un problema existente
- project_id : UUID del proyecto (cadena, obligatoria)
- issue_id : UUID del problema (cadena, obligatoria)
- issue_data : Campos para actualizar en el problema (objeto)

Módulos

list_modules - Obtener todos los módulos para un proyecto específico
- project_id : UUID del proyecto (cadena, obligatoria)
get_module - Obtener detalles de un módulo específico
- project_id : UUID del proyecto (cadena, obligatoria)
- module_id : UUID del módulo (cadena, obligatoria)
create_module - Crea un nuevo módulo en un proyecto
- project_id : UUID del proyecto (cadena, obligatoria)
- module_data : Objeto que contiene:
  - name : Nombre del módulo (cadena, obligatorio)
update_module - Actualizar un módulo existente
- project_id : UUID del proyecto (cadena, obligatoria)
- module_id : UUID del módulo (cadena, obligatoria)
- module_data : Campos a actualizar en el módulo (objeto)
delete_module - Eliminar un módulo
- project_id : UUID del proyecto (cadena, obligatoria)
- module_id : UUID del módulo (cadena, obligatoria)

Problemas con el módulo

list_module_issues : obtener todos los problemas de un módulo específico
- project_id : UUID del proyecto (cadena, obligatoria)
- module_id : UUID del módulo (cadena, obligatoria)
add_module_issues - Agregar problemas a un módulo
- project_id : UUID del proyecto (cadena, obligatoria)
- module_id : UUID del módulo (cadena, obligatoria)
- issues : Matriz de UUID de problemas para agregar (cadena[], obligatoria)
delete_module_issue - Eliminar un problema de un módulo
- project_id : UUID del proyecto (cadena, obligatoria)
- module_id : UUID del módulo (cadena, obligatoria)
- issue_id : UUID del problema a eliminar (cadena, obligatoria)

Ciclos

list_cycles - Obtener todos los ciclos para un proyecto específico
- project_id : UUID del proyecto (cadena, obligatoria)
get_cycle - Obtener detalles de un ciclo específico
- project_id : UUID del proyecto (cadena, obligatoria)
- cycle_id : UUID del ciclo (cadena, obligatoria)
create_cycle - Crea un nuevo ciclo en un proyecto
- project_id : UUID del proyecto (cadena, obligatoria)
- cycle_data : Objeto que contiene:
  - name : Nombre del ciclo (cadena, obligatorio)
  - start_date : Fecha de inicio (AAAA-MM-DD) (cadena, obligatoria)
  - end_date : Fecha de finalización (AAAA-MM-DD) (cadena, obligatoria)
update_cycle - Actualizar un ciclo existente
- project_id : UUID del proyecto (cadena, obligatoria)
- cycle_id : UUID del ciclo (cadena, obligatoria)
- cycle_data : Campos a actualizar en el ciclo (objeto)
delete_cycle - Eliminar un ciclo
- project_id : UUID del proyecto (cadena, obligatoria)
- cycle_id : UUID del ciclo (cadena, obligatoria)

Problemas de ciclo

list_cycle_issues : obtener todos los problemas de un ciclo específico
- project_id : UUID del proyecto (cadena, obligatoria)
- cycle_id : UUID del ciclo (cadena, obligatoria)
add_cycle_issues - Agregar problemas a un ciclo
- project_id : UUID del proyecto (cadena, obligatoria)
- cycle_id : UUID del ciclo (cadena, obligatoria)
- issues : Matriz de UUID de problemas para agregar (cadena[], obligatoria)
delete_cycle_issue - Eliminar un problema de un ciclo
- project_id : UUID del proyecto (cadena, obligatoria)
- cycle_id : UUID del ciclo (cadena, obligatoria)
- issue_id : UUID del problema a eliminar (cadena, obligatoria)

Registros de trabajo

get_issue_worklogs : obtiene todos los registros de trabajo para un problema específico
- project_id : UUID del proyecto (cadena, obligatoria)
- issue_id : UUID del problema (cadena, obligatoria)
get_total_worklogs : obtiene el tiempo total registrado para un proyecto
- project_id : UUID del proyecto (cadena, obligatoria)
create_worklog - Crea un nuevo registro de trabajo para un problema
- project_id : UUID del proyecto (cadena, obligatoria)
- issue_id : UUID del problema (cadena, obligatoria)
- worklog_data : Objeto que contiene:
  - description : Descripción del trabajo realizado (cadena, obligatoria)
  - duration : Duración en minutos (entero, obligatorio)
update_worklog - Actualizar un registro de trabajo existente
- project_id : UUID del proyecto (cadena, obligatoria)
- issue_id : UUID del problema (cadena, obligatoria)
- worklog_id : UUID del registro de trabajo (cadena, obligatoria)
- worklog_data : Campos para actualizar en el registro de trabajo (objeto)
delete_worklog - Eliminar un registro de trabajo
- project_id : UUID del proyecto (cadena, obligatoria)
- issue_id : UUID del problema (cadena, obligatoria)
- worklog_id : UUID del registro de trabajo (cadena, obligatoria)

Uso

Escritorio de Claude

Agregue Plane a Claude Desktop editando su claude_desktop_config.json .

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

VSCode

Agregue Plane a VSCode editando su .vscode.json/mcp.json .

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

Licencia

Este proyecto está licenciado bajo los términos de la licencia de código abierto MIT.

Plane MCP Server