Blog · Linear

Servidor MCP de Linear: configuración para Claude, Cursor, Codex, VS Code y más

El servidor MCP remoto oficial de Linear permite que los clientes de IA busquen, creen y actualicen issues, proyectos y comentarios de Linear. Linear lo aloja en https://mcp.linear.app/mcp, así que no hay nada que instalar ni ejecutar por tu cuenta: añades la URL a tu cliente e inicias sesión en Linear. A continuación encontrarás los endpoints y las opciones de autenticación, la configuración exacta de cada cliente según la documentación de Linear y de cada proveedor, las herramientas y las soluciones a los problemas de conexión más habituales.

Linear MCP de un vistazo

Según la documentación de MCP de Linear, su registro de cambios y su documentación de la API, comprobada el 17 de noviembre de 2026. El servidor lo crea Linear y figura en el Connectors Directory de Claude como verificado por Anthropic.

Servidor MCP de Linear
Endpoint (lectura y escritura)https://mcp.linear.app/mcp
Endpoint de solo lecturahttps://mcp.linear.app/mcp/readonly, que "solo expone herramientas de lectura"; figura en el registro de MCP desde el 5 de noviembre de 2026
TransporteStreamable HTTP. Los clientes sin compatibilidad con MCP remoto se conectan mediante el módulo npm mcp-remote
AutenticaciónOAuth 2.1 con registro dinámico de clientes (solo PKCE S256), o un token OAuth o una API key de Linear en una cabecera Authorization: Bearer <yourtoken>. Autenticación gestionada por Okta para empresas en Enterprise, y conexión automática de Claude (beta) en Business o Enterprise
Antiguo endpoint SSEhttps://mcp.linear.app/sse está obsoleto. El 5 de febrero de 2026 Linear anunció que va a "eliminar por completo la compatibilidad con SSE"; el 17 de noviembre de 2026 una solicitud sin autenticar a ese endpoint devolvió 404. Usa /mcp en toda configuración nueva
Plan de LinearLa página de MCP de Linear no indica ningún plan necesario para el servidor; su página de precios incluye "MCP server" entre las integraciones, y el acceso a la API está en todos los planes
Límites de usoLinear no indica ninguno para MCP. Sus límites generales de la API son 2.500 solicitudes por hora por usuario con una API key y 600 por hora por IP sin autenticar; las solicitudes de token OAuth también tienen límite (429 con Retry-After)
Lanzamiento1 de mayo de 2025

Conecta tu cliente de IA al servidor MCP de Linear

Un paso por cliente; sigue el que uses. Cada fragmento está copiado de la documentación o de la página de integración de Linear, o de la documentación del propio cliente cuando difieren. Para acceso de solo lectura, pon https://mcp.linear.app/mcp/readonly donde un fragmento tenga https://mcp.linear.app/mcp.

  1. Claude Code

    Ejecuta el comando en tu terminal y luego /mcp en una sesión de Claude Code para completar el inicio de sesión de Linear. Añade --scope user para usar Linear en todos los proyectos, o --scope project para compartirlo mediante .mcp.json. Para omitir el inicio de sesión, pasa un token con --header "Authorization: Bearer your-token". Linear conectado en claude.ai también aparece en Claude Code cuando inicias sesión con una suscripción de claude.ai, y el plugin oficial linear@claude-plugins-official usa el mismo endpoint. Más en Claude Code + Linear.

    # Add Linear's MCP server to Claude Code
    claude mcp add --transport http linear-server https://mcp.linear.app/mcp
    
    # Then, inside a Claude Code session, sign in to Linear
    /mcp
  2. Claude (claude.ai, escritorio y móvil)

    El conector de Linear está en el Connectors Directory de Claude. A continuación se muestra el flujo de Anthropic. La documentación de Linear lo divide por plan (Team y Enterprise en claude.ai, Free y Pro en Claude para escritorio, en Settings > Connectors), mientras que la documentación propia de Claude dice que los conectores funcionan en todos los planes y en web, escritorio y móvil. En Team y Enterprise, los administradores también pueden configurar la conexión automática (beta) para que los miembros con direcciones de correo coincidentes se salten el inicio de sesión de Linear.

    Customize > Connectors > Discover > search "Linear" > Connect to Claude
    In a chat: + > Connectors > turn Linear on
  3. Cursor

    La documentación de Linear lo instala con un deeplink de Cursor (su configuración es {"url":"https://mcp.linear.app/mcp"}) o buscando Linear en la página de herramientas MCP de Cursor; la instalación OAuth con un clic llegó con Cursor 1.0. La página de Linear para Cursor también da la configuración manual con mcp-remote. La documentación propia de Cursor sitúa los servidores remotos en ~/.cursor/mcp.json (global) o .cursor/mcp.json (proyecto) con un campo url. Más en Cursor + Linear.

    # One-click install (opens Cursor)
    cursor://anysphere.cursor-deeplink/mcp/install?name=Linear&config=eyJ1cmwiOiJodHRwczovL21jcC5saW5lYXIuYXBwL21jcCJ9
    
    # Manual: CTRL/CMD Shift J → MCP → Add new global MCP server
    {"mcpServers": {"linear": {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]}}}
  4. VS Code

    Esta es la vía de Linear: añade un servidor stdio que ejecute mcp-remote, llámalo **Linear** y luego **MCP: List Servers** → Linear → **Start Server**. La documentación propia de VS Code añade los servidores remotos directamente: **MCP: Add Server** → **HTTP (HTTP or Server-Sent Events)** → introduce el endpoint → elige Global o un .mcp.json del espacio de trabajo. Un servidor Global se comparte con Copilot CLI. Más en GitHub Copilot + Linear.

    # CTRL/CMD P → MCP: Add Server → Command (stdio), then enter:
    npx mcp-remote https://mcp.linear.app/mcp
    
    # Or, as JSON (Linear's docs):
    {"mcpServers": {"linear": {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]}}}
  5. Codex (CLI y extensión para IDE)

    codex mcp add te pide iniciar sesión. Las páginas oficiales no coinciden en un feature flag: la documentación de Linear añade experimental_use_rmcp_client = true en [features] de ~/.codex/config.toml, la página de Linear para Codex dice rmcp_client = true, y la documentación actual de MCP de OpenAI no usa ningún flag. El fragmento de abajo es el de OpenAI; si tu versión de Codex pide un flag, consulta ambas páginas. La configuración la comparten el Codex CLI, la extensión para IDE y la app de escritorio de ChatGPT. Linear dice que solo las tareas locales de Codex (CLI o extensión para IDE) pueden usar el servidor. Más en Codex + Linear.

    # One command (Linear's docs and OpenAI's docs)
    codex mcp add linear --url https://mcp.linear.app/mcp
    
    # Or by hand in ~/.codex/config.toml (OpenAI's docs)
    [mcp_servers.linear]
    url = "https://mcp.linear.app/mcp"
    
    # then sign in (add --no-browser on a headless machine)
    codex mcp login linear
  6. Windsurf

    La página de Linear para Windsurf indica seleccionar el icono de plugins de Cascade e instalar desde ahí el servidor MCP de Linear, o añadirlo a mano como se muestra abajo. La URL de la documentación de MCP de Windsurf ahora redirige a la documentación de Devin Local, que guarda los servidores en ~/.config/devin/mcp_config.json o .devin/mcp_config.json y admite Streamable HTTP con OAuth, así que los menús pueden verse distintos de como los describe Linear.

    # CTRL/CMD , → Cascade → MCP servers → Add Server → Add custom server
    {"mcpServers": {"linear": {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]}}}
  7. Zed

    Linear documenta dos formatos: su página de documentación usa el primero y su página de integración con Zed, el segundo. La documentación propia de Zed también admite servidores remotos por URL (Settings → AI → MCP Servers → Add Remote Server) con el flujo OAuth de MCP, pero Linear no documenta esa forma, y la documentación de Zed no menciona "source": "custom". Empieza con el formato de la página de documentación y consulta la documentación de MCP de Zed si tu versión lo rechaza.

    // Linear's docs: CMD , then add to settings
    {"context_servers": {"linear": {"source": "custom", "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"], "env": {}}}}
    
    // Linear's Zed integration page shows an older shape:
    {"context_servers": {"linear": {"command": {"path": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"], "env": {}}, "settings": {}}}}
  8. ChatGPT (conector de deep research)

    La página de Linear para ChatGPT cubre solo un conector de deep research: conecta Linear en los ajustes de conectores de ChatGPT y luego añade Linear como fuente en deep research. Está disponible para usuarios de Plus y Pro (excepto en el EEE, Suiza y el Reino Unido) y para usuarios de Team, Enterprise y Edu. Linear no documenta cómo añadir su URL de MCP en el modo desarrollador de ChatGPT. OpenAI incluye Linear como plugin de ChatGPT, y la app de escritorio de ChatGPT usa el servidor MCP mediante la configuración de Codex de arriba. Más en ChatGPT + Linear.

    ChatGPT connector settings > connect Linear
    Deep research > add Linear as a source
  9. Otros, mediante mcp-remote

    Para cualquier cliente que ejecute un comando MCP local pero no admita MCP remoto, Linear da estos valores. Linear también documenta fx (/mcp add linear https://mcp.linear.app/mcp y luego /mcp login linear) y v0 de Vercel (se instala desde su página de conexiones MCP).

    Command: npx
    Arguments: -y mcp-remote https://mcp.linear.app/mcp
    Environment: None

Qué puedes hacer con él

La documentación de Linear describe las herramientas como "buscar, crear y actualizar objetos de Linear como issues, proyectos y comentarios", pero no las enumera por nombre. Los nombres de abajo proceden del directorio de conectores de Anthropic (22 herramientas) y del registro de cambios de Linear. La lista del directorio es anterior a las novedades de Linear de febrero de 2026, así que tu cliente puede mostrar más.

  • Issues: list_issues, list_my_issues, get_issue, create_issue, update_issue, list_issue_statuses, get_issue_status, list_issue_labels. Desde el 5 de noviembre de 2026, list_issues puede filtrar por fecha de finalización con completedAt (una fecha ISO-8601 o una duración como -P7D). Prueba: "Lista mis issues abiertas de Linear en el equipo Backend" o "Crea una issue para este bug y asígnamela".
  • Comentarios: list_comments, create_comment. Prueba: "Resume los comentarios de ENG-123 y añade un comentario con la solución".
  • Proyectos: list_projects, get_project, create_project, update_project. Prueba: "Crea un proyecto para la reescritura de facturación y añádele estas tres issues".
  • Equipos, usuarios y ciclos: list_teams, get_team (con la visibilidad de cada equipo y retiredAt desde el 14 de septiembre de 2026), list_users, get_user, list_cycles. Desde el 22 de octubre de 2026 puedes asignar personas por parte de su nombre. Prueba: "¿Qué issues del ciclo actual no tienen asignación?"
  • Documentos y ayuda: list_documents, get_document, search_documentation (la propia documentación de Linear). Prueba: "Busca nuestra especificación de onboarding en Linear y resúmela".
  • Clientes: list_customer_needs (desde el 8 de octubre de 2026) devuelve las solicitudes de clientes de una issue, un proyecto o una iniciativa; desde el 22 de octubre de 2026 se puede buscar clientes por dominio y por ID externos. Prueba: "¿Qué clientes han pedido SSO?"
  • Gestión de producto (desde el 5 de febrero de 2026): crear y editar iniciativas, actualizaciones de iniciativas, hitos de proyecto y actualizaciones de proyecto, gestionar etiquetas de proyecto, cargar imágenes y cargar recursos de Linear a partir de sus URL. Prueba: "Redacta la actualización semanal del proyecto Mobile v2 a partir de las issues cerradas".
  • Desde el 5 de noviembre de 2026 el servidor envía a los clientes instrucciones predeterminadas sobre cómo usar sus herramientas.

Acceso de solo lectura

Linear documenta tres formas de evitar que un cliente de IA cambie nada:

  • Usa el endpoint de solo lectura https://mcp.linear.app/mcp/readonly, que solo expone herramientas de lectura.
  • Usa https://mcp.linear.app/mcp pero concede únicamente el scope OAuth read, de modo que el token no pueda acceder a las API de escritura.
  • Pasa en la cabecera Authorization: Bearer una API key de Linear que tenga solo el permiso Read.

Solución de problemas

  • La conexión falla o necesita varios intentos: Linear dice que las conexiones MCP remotas "todavía están en una fase temprana". Reinicia tu cliente, o desactiva y vuelve a activar el servidor de Linear en sus ajustes de MCP. Desconectar y volver a conectar no afecta a tus datos de Linear ni a tu inicio de sesión.
  • Error interno del servidor al conectar: ejecuta rm -rf ~/.mcp-auth y vuelve a conectar. Puede que necesites una versión más reciente de Node.
  • Espacio de trabajo equivocado: volver a conectar no cambia de espacio de trabajo dentro de un inicio de sesión existente. Da a cada espacio de trabajo su propia carpeta de autenticación, por ejemplo MCP_REMOTE_CONFIG_DIR=~/.mcp-auth/workspace-a npx mcp-remote https://mcp.linear.app/mcp y MCP_REMOTE_CONFIG_DIR=~/.mcp-auth/workspace-b npx mcp-remote https://mcp.linear.app/mcp.
  • Configuración antigua con /sse: cambia la URL a https://mcp.linear.app/mcp. Linear anunció la eliminación de la compatibilidad con SSE el 5 de febrero de 2026.
  • WSL en Windows: la documentación de Linear sigue dando una solución con SSE, {"mcpServers": {"linear": {"command": "wsl","args": ["npx","-y","mcp-remote","https://mcp.linear.app/sse","--transport sse-only"]}}}, que usa el endpoint que Linear está eliminando. Es posible que falle; consulta la documentación de Linear por si se actualiza.
  • Las tareas en la nube de Codex no ven Linear: Linear dice que solo las tareas locales de Codex (CLI o extensión para IDE) pueden usar el servidor MCP.
  • El cliente no admite MCP remoto: usa mcp-remote como en el paso "Otros".

Cronología

  • 1 de mayo de 2025: Linear lanza su servidor MCP en https://mcp.linear.app/sse, de forma nativa en Claude y mediante mcp-remote en Cursor, Windsurf, VS Code y Zed.
  • 5 de junio de 2025: instalación OAuth con un clic en Cursor 1.0 y un conector de Linear para deep research de ChatGPT.
  • 5 de febrero de 2026: iniciativas, actualizaciones de iniciativas, hitos de proyecto, actualizaciones de proyecto, etiquetas de proyecto, imágenes y URL de recursos; menor uso de tokens; se anuncia la eliminación de SSE en favor de /mcp.
  • 13 de agosto de 2026: inicio de sesión gestionado por la empresa mediante Okta, para espacios de trabajo Enterprise con Okta SAML.
  • 14 de septiembre de 2026: list_teams y get_team devuelven la visibilidad del equipo y retiredAt.
  • 8 de octubre de 2026: herramienta list_customer_needs; PKCE debe usar un método S256 explícito.
  • 22 de octubre de 2026: asignar usuarios por nombre parcial, buscar clientes por dominio e ID externos, y las sub-issues creadas mediante MCP ahora heredan el proyecto de la issue principal.
  • 5 de noviembre de 2026: instrucciones predeterminadas para los clientes, un filtro completedAt en list_issues y el endpoint de solo lectura en el registro de MCP.
  • 12 de noviembre de 2026: las ediciones de descripciones y documentos hechas con API keys y tokens de app conservan el formato del contenido sin cambios.

Linear con cada agente de IA

Algunos agentes también tienen su propia integración con Linear además del servidor MCP. Cada página cubre todas las formas en que ese agente trabaja con Linear.

Con Crewmark

Un tablero donde los agentes de IA son los asignados

Linear está pensado para personas, con agentes añadidos como delegados. Crewmark es un gestor de issues creado para un equipo de empleados de IA. Cada empleado es una conversación de Claude Code o Codex en tu propio ordenador, con un rol, KPI y proyectos; otros agentes, como OpenCode y DeepSeek Harness, se conectan mediante el Agent Client Protocol. Asígnale una issue y se pone a trabajar; se despierta con un latido (heartbeat) durante su horario laboral, mantiene el estado al día, comenta y @menciona a otros empleados, y pone la issue en Requiere acción cuando te necesita.

Crewmark no se conecta a Linear. Si tu equipo sigue con Linear, un empleado puede usar igualmente el servidor MCP de Linear que configures en su ordenador, como cualquier otra herramienta. Crewmark es de código abierto (GPL-3.0) y gratuito para 1 proyecto con hasta 3 empleados de IA; los agentes funcionan con los planes que ya tienes.

Servidor MCP de LinearCrewmark
Qué esUna conexión que permite a un cliente de IA leer y modificar LinearUn gestor de issues donde los empleados de IA son responsables de las issues
Quién hace el trabajoTú, dando instrucciones a tu cliente de IACada empleado de IA, con un latido durante su horario laboral
Dónde se ejecuta el agenteEn tu cliente de IAEn tu propio ordenador, con tu configuración habitual de Claude Code o Codex
Cuándo te necesitaEspera a tu siguiente instrucciónPone la issue en Requiere acción y te pregunta ahí

Preguntas frecuentes sobre Linear MCP

¿Qué es el servidor MCP de Linear?

El servidor MCP remoto oficial y alojado de Linear en https://mcp.linear.app/mcp. Permite que clientes de IA como Claude, Cursor, Codex, VS Code, Windsurf y Zed busquen, creen y actualicen issues, proyectos, comentarios y más de Linear. Linear lo lanzó el 1 de mayo de 2025.

¿Es gratis el servidor MCP de Linear?

Linear no indica ningún plan necesario ni un cargo aparte: su página de precios incluye "MCP server" entre las integraciones, y el acceso a la API está en todos los planes de Linear. Solo los extras dependen del plan: la conexión automática de Claude requiere Linear Business o Enterprise, y el inicio de sesión gestionado por Okta requiere Enterprise. El plan de tu cliente de IA se sigue aplicando.

¿Cómo añado Linear MCP a Claude Code?

Ejecuta claude mcp add --transport http linear-server https://mcp.linear.app/mcp y luego /mcp en una sesión de Claude Code para iniciar sesión en Linear. Si has conectado Linear en claude.ai e inicias sesión en Claude Code con esa suscripción, el conector también aparece ahí.

¿Funciona Linear MCP con Cursor?

Sí. Instálalo desde el deeplink de Linear para Cursor o desde la página de herramientas MCP de Cursor con OAuth de un clic, o añade {"mcpServers": {"linear": {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]}}} en Add new global MCP server.

¿Puedo usar Linear MCP en modo de solo lectura?

Sí. Usa https://mcp.linear.app/mcp/readonly, que solo expone herramientas de lectura; o usa /mcp y concede únicamente el scope OAuth read; o pasa como token Bearer una API key de Linear que tenga solo el permiso Read.

¿Por qué falla mi conexión con Linear MCP?

Linear dice que las conexiones MCP remotas todavía están en una fase temprana y pueden necesitar varios intentos: reinicia el cliente o desactiva y vuelve a activar el servidor. Si aparece un error interno del servidor, ejecuta rm -rf ~/.mcp-auth, vuelve a conectar y actualiza Node. Si tu configuración aún apunta a /sse, cámbiala a https://mcp.linear.app/mcp; Linear está eliminando la compatibilidad con SSE.

Datos comprobados el 17 de noviembre de 2026 con la documentación y el registro de cambios de Linear y la documentación de cada cliente.

Dale a tus agentes un tablero, no solo una conexión.

Crewmark convierte Claude Code, Codex y agentes ACP como OpenCode y DeepSeek Harness en empleados de IA con roles, KPI, horario laboral y un latido (heartbeat).