Configura Linear MCP en un workspace de OpenCode
Linear MCP en un solo workspace
Para activar Linear MCP en un solo repositorio, crea un opencode.jsonc local. Después, autentica el servidor y comprueba el resultado con opencode mcp list.
El archivo vive en el repositorio. Solo afecta a ese directorio y deja intacto el perfil global de OpenCode.
1. Crea la configuración del workspace
Crea opencode.jsonc en la raíz del proyecto con este bloque MCP:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"linear-project": {
"type": "remote",
"url": "https://mcp.linear.app/mcp",
"enabled": true
}
}
}Uso "linear-project" en lugar de "linear" para evitar colisiones con otras herramientas o alias. Puedes elegir otro nombre, pero úsalo también en el comando de autenticación.
2. Autentica el servidor
Desde ese workspace, ejecuta:
opencode mcp auth linear-projectSi tu versión de OpenCode no incluye este comando, abre la configuración de la aplicación y autentícate desde la sección MCP.
3. Confirma que está activo en ese workspace
Comprueba que el servidor aparece en la lista:
opencode mcp listDespués, hazle al agente una consulta de solo lectura:
Muéstrame los primeros cinco issues abiertos que tengo asignados en Linear.Lo importante es que devuelva datos reales de tu workspace. Si lo hace, la integración funciona.
4. Si falta opencode mcp auth
Algunas versiones de OpenCode incluyen la autenticación MCP en la aplicación en lugar del CLI. Si opencode mcp auth linear-project no existe, abre la configuración, busca la sección MCP, selecciona la misma entrada del servidor de Linear y autentícate allí.
Después, ejecuta:
opencode mcp listSi linear-project aparece al ejecutar el comando desde el workspace, la configuración es válida.
5. Comprueba que solo afecta a ese workspace
Como el archivo de configuración vive en el repositorio, el entorno global no cambia.
Para comprobarlo, ejecuta opencode mcp list en este repositorio. Después, repítelo en otra carpeta que no tenga el mismo opencode.jsonc. La entrada de Linear debería aparecer solo en el workspace configurado.
Enlaces relacionados
Preguntas frecuentes
- ¿Cómo añado Linear MCP a OpenCode?
- Crea un `opencode.jsonc` en el workspace con la entrada del servidor MCP remoto de Linear. Después, ejecuta `opencode mcp auth linear-project` para autenticarte.
- ¿Existe una integración de Linear con OpenCode?
- Sí. Linear ofrece un servidor MCP remoto. Añade `https://mcp.linear.app/mcp` al `opencode.jsonc` del workspace, autentica y comprueba la conexión con `opencode mcp list`.
- ¿Para qué sirve Linear MCP en OpenCode?
- Permite que el agente de OpenCode lea y actúe sobre los issues de Linear de ese workspace. Puedes listar issues, ver a quién está asignado cada uno y usar otras herramientas MCP sin activar Linear en todos tus proyectos.
- ¿Puedo limitar Linear MCP a un solo workspace?
- Sí. Pon la configuración MCP en el `opencode.jsonc` del proyecto. Ese workspace tendrá las herramientas de Linear y el perfil global quedará sin cambios.
- ¿Qué hago si `opencode mcp auth` no está disponible?
- Abre la configuración de OpenCode, busca la sección MCP y autentica allí la misma entrada del servidor de Linear.