Servidor MCP lineal

Este es un servidor de Protocolo de contexto de modelo (MCP) para Linear, que permite a Claude interactuar con la API de Linear para administrar equipos, problemas, proyectos y ciclos.

Características

linear_get_teams : Obtener todos los equipos con sus estados y etiquetas
linear_search_issues : busca problemas con el filtrado y la paginación
linear_get_cycles : Obtener todos los ciclos de un equipo
linear_get_projects : Obtener todos los proyectos
linear_create_issue : Crea un nuevo problema
linear_update_issue : Actualizar un problema existente

Inicio rápido

Para los usuarios de Cline MCP Marketplace:

Instalar el servidor a través de Cline MCP Marketplace
Configure sus credenciales lineales en el archivo de configuración de MCP
Verifique la instalación probando la conexión con linear_search_issues

Consulte las secciones detalladas de Instalación y verificación a continuación.

Instalación

Clonar este repositorio
Instalar dependencias:
npm install
Construir el servidor:
npm run build

El proceso de instalación tiene tres pasos principales:

Configuración : Clonar y construir el servidor (pasos anteriores)
Configuración : configure su token OAuth lineal y configure el servidor MCP
Verificación : Pruebe la conexión para asegurarse de que funciona correctamente

⚠️ ¡Tu instalación no estará completa hasta que hayas verificado que la conexión funciona!

Configuración

El servidor requiere un token OAuth de Linear para autenticarse con la API de Linear. Puede configurar este token en el archivo de configuración de MCP.

Obtener un token OAuth lineal

Cree una aplicación OAuth lineal en https://linear.app/settings/api/applications
Crear una aplicación OAuth
Nombre de la aplicación Cline MCP
Establezca la URI de redirección en http://localhost:3000/callback
Anote el ID del cliente y el secreto del cliente
Crear y copiar un token de desarrollador basado en USUARIO

Configuración de MCP

Agregue lo siguiente a su archivo de configuración de MCP:

{
  "mcpServers": {
    "github.com/cpropster/linear-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/linear-mcp-server/build/index.js"
      ],
      "env": {
        "LINEAR_CLIENT_ID": "your-client-id",
        "LINEAR_CLIENT_SECRET": "your-client-secret",
        "LINEAR_REDIRECT_URI": "http://localhost:3000/callback",
        "LINEAR_REFRESH_TOKEN": "your-refresh-token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Reemplace las credenciales de marcador de posición con sus credenciales reales.

Verificación de la instalación

⚠️ IMPORTANTE : Su instalación no estará completa hasta que verifique que la conexión MCP funciona correctamente.

Después de configurar el servidor MCP, debe probar la conexión para asegurarse de que funciona correctamente:

Recargar la configuración de MCP
Pruebe la conexión utilizando la herramienta linear_search_issues :

use_mcp_tool(
  server_name="github.com/cpropster/linear-mcp-server",
  tool_name="linear_search_issues",
  arguments={
    "first": 5
  }
)

Si tiene éxito, verá una respuesta como esta:

{
  "issues": {
    "nodes": [
      {
        "id": "123abc",
        "title": "Example issue 1",
        "identifier": "TEAM-123",
        "description": "This is an example issue"
        // ... other issue data
      },
      // ... more issues
    ]
  }
}

Si la conexión funciona, verá una lista de problemas de su cuenta de Linear. Si ve un error, revise su configuración y credenciales.

Problemas comunes:

Ruta de servidor incorrecta en el campo args
Tokens lineales no válidos o vencidos
Faltan variables de entorno requeridas
El servidor está deshabilitado en la configuración

Uso

Conseguir equipos

Utilice la herramienta linear_get_teams para recuperar todos los equipos:

use_mcp_tool(
  server_name="github.com/cpropster/linear-mcp-server",
  tool_name="linear_get_teams",
  arguments={}
)

Problemas de búsqueda

Utilice la herramienta linear_search_issues para buscar problemas:

use_mcp_tool(
  server_name="github.com/cpropster/linear-mcp-server",
  tool_name="linear_search_issues",
  arguments={
    "query": "Optional search query",
    "teamIds": ["Optional team IDs"],
    "first": 10 // Number of issues to return (default: 50)
  }
)

Obteniendo ciclos

Utilice la herramienta linear_get_cycles para recuperar ciclos de un equipo:

use_mcp_tool(
  server_name="github.com/cpropster/linear-mcp-server",
  tool_name="linear_get_cycles",
  arguments={
    "teamId": "required-team-id"
  }
)

Conseguir proyectos

Utilice la herramienta linear_get_projects para recuperar proyectos:

use_mcp_tool(
  server_name="github.com/cpropster/linear-mcp-server",
  tool_name="linear_get_projects",
  arguments={
    "teamId": "optional-team-id",
    "first": 10 // Number of projects to return (default: 50)
  }
)

Creando problemas

Utilice la herramienta linear_create_issue para crear un nuevo problema:

use_mcp_tool(
  server_name="github.com/cpropster/linear-mcp-server",
  tool_name="linear_create_issue",
  arguments={
    "teamId": "required-team-id",
    "title": "Required issue title",
    "description": "Optional issue description",
    "assigneeId": "optional-assignee-id",
    "stateId": "optional-state-id",
    "priority": 0, // Optional priority (0-4)
    "estimate": 1, // Optional estimate
    "cycleId": "optional-cycle-id",
    "projectId": "optional-project-id",
    "labelIds": ["optional-label-ids"]
  }
)

Problemas de actualización

Utilice la herramienta linear_update_issue para actualizar un problema existente:

use_mcp_tool(
  server_name="github.com/cpropster/linear-mcp-server",
  tool_name="linear_update_issue",
  arguments={
    "issueId": "required-issue-id",
    "title": "Optional new title",
    "description": "Optional new description",
    "assigneeId": "optional-assignee-id",
    "stateId": "optional-state-id",
    "priority": 0, // Optional priority (0-4)
    "estimate": 1, // Optional estimate
    "cycleId": "optional-cycle-id",
    "projectId": "optional-project-id",
    "labelIds": ["optional-label-ids"]
  }
)

Depuración

Si encuentra problemas durante el paso de verificación o si la conexión MCP deja de funcionar, puede utilizar estas técnicas de depuración:

Verificar la configuración de MCP : asegúrese de que su archivo de configuración de MCP tenga la ruta de servidor y las credenciales correctas.
Ejecutar el cliente de prueba : utilice el cliente de prueba incluido para verificar que el servidor pueda conectarse a Linear:
node test-client.js
Esto ejecutará una serie de pruebas para verificar que el servidor pueda conectarse a Linear y recuperar datos.
Comprobar el estado de la API lineal : verifique que la API lineal esté operativa en status.linear.app .
Inspeccionar los registros del servidor : si está ejecutando el servidor manualmente, verifique la salida de la consola para ver si hay mensajes de error.

Desarrollo

El servidor se creó con TypeScript y el SDK Linear. La implementación principal se encuentra en src/index.ts .

Para realizar cambios en el servidor:

Editar el código fuente en src/
Construya el servidor con npm run build
Pruebe sus cambios con el cliente de prueba
Actualice la configuración de MCP para usar la nueva compilación

Consideraciones de seguridad

Este servidor MCP requiere acceso a su cuenta de Linear. Para proteger sus datos:

Nunca confirmes tokens confidenciales : el archivo .env y cualquier archivo que contenga tokens se excluyen en .gitignore
Utilice variables de entorno : utilice siempre variables de entorno en la configuración de MCP en lugar de codificar tokens.
Limitar permisos : al crear una aplicación OAuth lineal, otorgue solo los permisos necesarios
Rotar tokens regularmente : generar nuevos tokens periódicamente y actualizar su configuración

El servidor utiliza el SDK oficial de Linear y se comunica con la API de Linear a través de HTTPS, lo que garantiza que sus datos se transmitan de forma segura.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Linear MCP Server

Integrations