Servidor MCP de avión

El servidor MCP de Plane lleva el poder del Protocolo de contexto de modelo (MCP) a Plane, lo que permite que los agentes de IA y las herramientas para desarrolladores interactúen de manera programática con su espacio de trabajo de Plane.

Ya sea que esté creando asistentes inteligentes, scripts de automatización o herramientas impulsadas por flujo de trabajo, este servidor proporciona un puente perfecto a la API de Plane, para que pueda crear proyectos, administrar problemas, asignar tareas y mantener su trabajo sincronizado con herramientas impulsadas por IA.

¿Qué puedes hacer con ello?

Este servidor desbloquea todo tipo de capacidades útiles para cualquiera que trabaje con Plane:

• Ponga en marcha proyectos y elementos de trabajo directamente desde su interfaz de IA o aplicación.

• Actualice el progreso, asigne miembros del equipo, establezca propiedades o agregue comentarios, todo mediante programación.

• Mueva los problemas a través de flujos de trabajo y actualice sus estados sobre la marcha.

• Organice el trabajo con etiquetas, módulos y ciclos.

• Analice datos sobre el trabajo de su equipo en todos los proyectos.

• Cree aplicaciones inteligentes que interactúen naturalmente con Plane, ya sea un agente de IA que registre el trabajo o un bot que mantenga los proyectos ordenados.

Related MCP server: Plane MCP Server

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

  • Crear un nuevo proyecto

  • Parámetros:

    • name (cadena, obligatorio): nombre del proyecto

Tipos de problemas

• list_issue_types

  • Obtener todos los tipos de problemas para un proyecto específico

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

• get_issue_type

  • Obtener detalles de un tipo de problema específico

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • type_id (cadena, obligatoria): UUID del tipo de problema

• create_issue_type

  • Crear un nuevo tipo de problema en un proyecto

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • issue_type_data : Objeto que contiene:

      • name (cadena, obligatorio): nombre del tipo de problema

      • description (cadena, obligatoria): Descripción del tipo de problema

• update_issue_type

  • Actualizar un tipo de problema existente

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • type_id (cadena, obligatoria): UUID del tipo de problema

    • issue_type_data (objeto): Campos para actualizar el tipo de problema

• delete_issue_type

  • Eliminar un tipo de problema

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • type_id (cadena, obligatoria): UUID del tipo de problema

Estados

• list_states

  • Obtener todos los estados para un proyecto específico

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

• get_state

  • Obtenga detalles de un estado específico

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • state_id (cadena, obligatoria): UUID del estado

• create_state

  • Crear un nuevo estado en un proyecto

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • state_data : Objeto que contiene:

      • name (cadena, obligatorio): Nombre del estado

      • color (cadena, obligatoria): código de color para el estado

• update_state

  • Actualizar un estado existente

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • state_id (cadena, obligatoria): UUID del estado

    • state_data (objeto): Campos para actualizar el estado

• delete_state

  • Eliminar un estado

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • state_id (cadena, obligatoria): UUID del estado

Etiquetas

• list_labels

  • Obtener todas las etiquetas para un proyecto específico

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

• get_label

  • Obtener detalles de una etiqueta específica

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • label_id (cadena, obligatoria): UUID de la etiqueta

• create_label

  • Crear una nueva etiqueta en un proyecto

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • label_data : Objeto que contiene:

      • name (cadena, obligatorio): Nombre de la etiqueta

      • color (cadena, obligatoria): código de color para la etiqueta

• update_label

  • Actualizar una etiqueta existente

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • label_id (cadena, obligatoria): UUID de la etiqueta

    • label_data (objeto): Campos para actualizar en la etiqueta

• delete_label

  • Eliminar una etiqueta

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • label_id (cadena, obligatoria): UUID de la etiqueta

Asuntos

• get_issue_using_readable_identifier

  • Obtener detalles del problema utilizando un identificador legible (por ejemplo, PROJ-123)

  • Parámetros:

    • project_identifier (cadena, obligatorio)

    • issue_identifier (cadena, obligatoria): Número de problema: Identificador del proyecto (p. ej., "PROJ") r (p. ej., "123")

• get_issue_comments

  • Obtener todos los comentarios sobre un tema específico

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • issue_id (cadena, obligatoria): UUID del problema

• add_issue_comment

  • Agregar un comentario a un problema

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • issue_id (cadena, obligatoria): UUID del problema

    • comment_html (cadena, obligatoria): contenido HTML del comentario

• create_issue

  • Crear un nuevo problema

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • issue_data : Objeto que contiene:

    • name (cadena, obligatorio): Título del problema

    • description_html (cadena, obligatoria): descripción HTML del problema

• update_issue

  • Actualizar un problema existente

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • issue_id (cadena, obligatoria): UUID del problema

    • issue_data (objeto): Campos para actualizar en el problema

Módulos

• list_modules

  • Obtenga todos los módulos para un proyecto específico

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

• get_module

  • Obtener detalles de un módulo específico

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • module_id (cadena, obligatoria): UUID del módulo

• create_module

  • Crear un nuevo módulo en un proyecto

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • module_data : Objeto que contiene:

      • name (cadena, obligatorio): Nombre del módulo

• update_module

  • Actualizar un módulo existente

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • module_id (cadena, obligatoria): UUID del módulo

    • module_data (objeto): Campos a actualizar en el módulo

• delete_module

  • Eliminar un módulo

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • module_id (cadena, obligatoria): UUID del módulo

Problemas con el módulo

• list_module_issues

  • Obtener todos los problemas de un módulo específico

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • module_id (cadena, obligatoria): UUID del módulo

• add_module_issues

  • Agregar problemas a un módulo

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • module_id (cadena, obligatoria): UUID del módulo

    • issues (cadena[], obligatorio): Matriz de UUID de problemas para agregar

• delete_module_issue

  • Eliminar un problema de un módulo

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • module_id (cadena, obligatoria): UUID del módulo

    • issue_id (cadena, obligatoria): UUID del problema a eliminar

Ciclos

• list_cycles

  • Obtener todos los ciclos para un proyecto específico

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

• get_cycle

  • Obtener detalles de un ciclo específico

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • cycle_id (cadena, obligatoria): UUID del ciclo

• create_cycle

  • Crear un nuevo ciclo en un proyecto

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • cycle_data : Objeto que contiene:

    • name (cadena, obligatorio): Nombre del ciclo

    • start_date (cadena, obligatoria): Fecha de inicio (AAAA-MM-DD)

    • end_date (cadena, obligatoria): Fecha de finalización (AAAA-MM-DD)

• update_cycle

  • Actualizar un ciclo existente

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • cycle_id (cadena, obligatoria): UUID del ciclo

    • cycle_data (objeto): Campos a actualizar en el ciclo

• delete_cycle

  • Eliminar un ciclo

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • cycle_id (cadena, obligatoria): UUID del ciclo

Problemas de ciclo

• list_cycle_issues

  • Obtener todos los números de un ciclo específico

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • cycle_id (cadena, obligatoria): UUID del ciclo

• add_cycle_issues

  • Añadir problemas a un ciclo

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • cycle_id (cadena, obligatoria): UUID del ciclo

    • issues (cadena[], obligatorio): Matriz de UUID de problemas para agregar

• delete_cycle_issue

  • Eliminar un problema de un ciclo

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • cycle_id (cadena, obligatoria): UUID del ciclo

    • issue_id (cadena, obligatoria): UUID del problema a eliminar

Registros de trabajo

• get_issue_worklogs

  • Obtener todos los registros de trabajo para un problema específico

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • issue_id (cadena, obligatoria): UUID del problema

• get_total_worklogs

  • Obtener el tiempo total registrado para un proyecto

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

• create_worklog

  • Crear un nuevo registro de trabajo para un problema

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • issue_id (cadena, obligatoria): UUID del problema

    • worklog_data : Objeto que contiene:

      • description (cadena, obligatoria): Descripción del trabajo realizado

      • duration (entero, obligatorio): Duración en minutos

• update_worklog

  • Actualizar un registro de trabajo existente

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • issue_id (cadena, obligatoria): UUID del problema

    • worklog_id (cadena, obligatoria): UUID del registro de trabajo

    • worklog_data (objeto): Campos para actualizar en el registro de trabajo

• delete_worklog

  • Eliminar un registro de trabajo

  • Parámetros:

    • project_id (cadena, obligatoria): UUID del proyecto

    • issue_id (cadena, obligatoria): UUID del problema

    • worklog_id (cadena, obligatoria): UUID del registro de trabajo

Parámetros de configuración

• PLANE_API_KEY : Tu token de API de Plane. Puedes generarlo desde la página Configuración del espacio de trabajo > Tokens de API ( /settings/api-tokens/ ) en la aplicación Plane.

• PLANE_WORKSPACE_SLUG : El slug del espacio de trabajo de tu instancia de Plane. El slug del espacio de trabajo representa el identificador único de un espacio de trabajo en Plane. Se encuentra en la URL.

• PLANE_API_HOST_URL (opcional): URL del host del servidor API de Plane. El valor predeterminado es https://api.plane.so/

Uso

Escritorio de Claude

Puedes agregar Plane a Claude Desktop actualizando tu 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

También puedes conectar Plane a VSCode editando tu archivo .vscode.json o 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 servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.