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

Related MCP server: Linear MCP Server

Inicio rápido

Para los usuarios de Cline MCP Marketplace:

1. Instalar el servidor a través de Cline MCP Marketplace

2. Configure sus credenciales lineales en el archivo de configuración de MCP

3. 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

1. Clonar este repositorio

2. Instalar dependencias:

   npm install

3. Construir el servidor:

   npm run build

El proceso de instalación tiene tres pasos principales:

1. Configuración : Clonar y construir el servidor (pasos anteriores)

2. Configuración : configure su token OAuth lineal y configure el servidor MCP

3. 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

1. Cree una aplicación OAuth lineal en https://linear.app/settings/api/applications

2. Crear una aplicación OAuth

3. Nombre de la aplicación Cline MCP

4. Establezca la URI de redirección en http://localhost:3000/callback

5. Anote el ID del cliente y el secreto del cliente

6. 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:

1. Recargar la configuración de MCP

2. 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:

1. 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.

2. 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.

3. Comprobar el estado de la API lineal : verifique que la API lineal esté operativa en status.linear.app .

4. 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:

1. Editar el código fuente en src/

2. Construya el servidor con npm run build

3. Pruebe sus cambios con el cliente de prueba

4. 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:

1. Nunca confirmes tokens confidenciales : el archivo .env y cualquier archivo que contenga tokens se excluyen en .gitignore

2. Utilice variables de entorno : utilice siempre variables de entorno en la configuración de MCP en lugar de codificar tokens.

3. Limitar permisos : al crear una aplicación OAuth lineal, otorgue solo los permisos necesarios

4. 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)