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 lectura | https://mcp.linear.app/mcp/readonly, que "solo expone herramientas de lectura"; figura en el registro de MCP desde el 5 de noviembre de 2026 |
| Transporte | Streamable HTTP. Los clientes sin compatibilidad con MCP remoto se conectan mediante el módulo npm mcp-remote |
| Autenticación | OAuth 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 SSE | https://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 Linear | La 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 uso | Linear 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) |
| Lanzamiento | 1 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.
Claude Code
Ejecuta el comando en tu terminal y luego
/mcpen una sesión de Claude Code para completar el inicio de sesión de Linear. Añade--scope userpara usar Linear en todos los proyectos, o--scope projectpara 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 oficiallinear@claude-plugins-officialusa 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 /mcpClaude (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 onCursor
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 conmcp-remote. La documentación propia de Cursor sitúa los servidores remotos en~/.cursor/mcp.json(global) o.cursor/mcp.json(proyecto) con un campourl. 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"]}}}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.jsondel 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"]}}}Codex (CLI y extensión para IDE)
codex mcp addte pide iniciar sesión. Las páginas oficiales no coinciden en un feature flag: la documentación de Linear añadeexperimental_use_rmcp_client = trueen[features]de~/.codex/config.toml, la página de Linear para Codex dicermcp_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 linearWindsurf
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.jsono.devin/mcp_config.jsony 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"]}}}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": {}}}}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 sourceOtros, 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/mcpy 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_issuespuede filtrar por fecha de finalización concompletedAt(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 yretiredAtdesde 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/mcppero concede únicamente el scope OAuthread, de modo que el token no pueda acceder a las API de escritura. - Pasa en la cabecera
Authorization: Beareruna 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-authy 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/mcpyMCP_REMOTE_CONFIG_DIR=~/.mcp-auth/workspace-b npx mcp-remote https://mcp.linear.app/mcp. - Configuración antigua con
/sse: cambia la URL ahttps://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-remotecomo 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 mediantemcp-remoteen 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_teamsyget_teamdevuelven la visibilidad del equipo yretiredAt. - 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
completedAtenlist_issuesy 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.
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 Linear | Crewmark | |
|---|---|---|
| Qué es | Una conexión que permite a un cliente de IA leer y modificar Linear | Un gestor de issues donde los empleados de IA son responsables de las issues |
| Quién hace el trabajo | Tú, dando instrucciones a tu cliente de IA | Cada empleado de IA, con un latido durante su horario laboral |
| Dónde se ejecuta el agente | En tu cliente de IA | En tu propio ordenador, con tu configuración habitual de Claude Code o Codex |
| Cuándo te necesita | Espera a tu siguiente instrucción | Pone 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.