Linear MCP: gestión de proyectos nativa para agentes de IA

Tus agentes de IA ya escriben código, clasifican correos y gestionan infraestructura. Pero en la gestión de proyectos están a ciegas: no pueden ver el backlog, crear issues ni actualizar el estado de un proyecto sin copiar y pegar a mano.

Linear MCP lo resuelve. Da a cualquier agente de IA compatible con MCP acceso completo y estructurado a tu espacio de trabajo de Linear.

Qué hace

Linear MCP expone toda la superficie de gestión de proyectos de Linear a través del Model Context Protocol. Los agentes de IA pueden gestionar:

Gestión del trabajo principal

• Issues: crear (de forma individual o por lotes), actualizar, buscar, eliminar, gestionar la jerarquía padre-hijo y crear relaciones entre issues
• Proyectos: crear, actualizar, eliminar, buscar, crear con issues y asociar con iniciativas
• Comentarios: crear respuestas en hilo, actualizar, eliminar y resolver/reabrir hilos
• Hitos: CRUD completo, además de creación masiva y búsqueda

Flujo de trabajo y descubrimiento

• Equipos, usuarios, estados de flujo de trabajo, etiquetas y ciclos
• Búsqueda de texto libre con filtros opcionales (equipo, proyecto, responsable, estado, prioridad, ciclo)
• Resolución exacta de identificadores de issues (por ejemplo, ENG-431) con búsqueda ordenada como alternativa

Integraciones y superficies avanzadas

• Adjuntos, webhooks y entidades de portafolio (iniciativas, clientes)
• Sesiones de agente y actividades de agente
• Descubrimiento de capacidades en tiempo de ejecución y diagnósticos en vivo

Arquitectura

AI Agent (Claude / Codex / OpenClaw / Cline)
  -> MCP transport (stdio or HTTP)
    -> Linear MCP server
      -> Linear GraphQL API

Linear MCP valida los esquemas de las herramientas en tiempo de ejecución antes de despachar el handler. Los payloads mal formados fallan con errores de validación estructurados en el límite de MCP, no en lo profundo de la API de Linear.

Contratos protegidos: los flujos de trabajo críticos de issues (creación individual, creación por lotes, búsqueda) usan operaciones GraphQL directas y auditadas en lugar de mutaciones del SDK, lo que evita que las regresiones del SDK lleguen a tus agentes. Ejecuta npm run verify:linear-api-contracts para auditarlos en local.

Telemetría estructurada: cada solicitud a una herramienta emite telemetría por stderr con el nombre de la herramienta, el transporte, la duración y metadatos de fallos depurados para facilitar la resolución de problemas.

Autenticación

API key (lo más sencillo):

LINEAR_API_KEY=your_personal_access_token

OAuth (para implementaciones compartidas o remotas):

1. Llama a linear_auth con tu clientId, clientSecret y redirectUri
2. Abre la URL de autorización que se devuelve
3. Llama a linear_auth_callback con el code y el state

En el modo stream, cada sesión MCP obtiene su propio contexto de autenticación aislado.

Inicio rápido

# Install from npm
npx @kkaminsk/linear-mcp

# Or clone and build
git clone https://github.com/kkaminsk/linear-mcp.git
cd linear-mcp && npm install && npm run build

# Run with API key
LINEAR_API_KEY=your_key npm start

Configuración del cliente MCP:

{
  "mcpServers": {
    "linear": {
      "command": "node",
      "args": ["/path/to/linear-mcp/build/index.js"],
      "env": {
        "LINEAR_API_KEY": "your_personal_access_token"
      }
    }
  }
}

Para quién es

• Equipos de desarrollo: agentes de IA que pueden clasificar, crear y actualizar issues como parte de su flujo de trabajo
• Responsables de ingeniería: actualizaciones automatizadas del estado de los proyectos, seguimiento de hitos y depuración del backlog
• Equipos de DevOps y SRE: agentes de IA que crean incidentes, vinculan issues y hacen seguimiento de su resolución
• Creadores de agentes de IA: cualquier cliente MCP que necesite acceso estructurado a la gestión de proyectos

GitHub: github.com/kkaminsk/linear-mcp

npm: @kkaminsk/linear-mcp