Linear MCP en OpenCode por workspace | Alex Pedersen (alexx855)

Q: ¿Cómo agrego Linear MCP a OpenCode?

Crea un archivo `opencode.jsonc` en tu workspace con la configuración remota de Linear y ejecuta `opencode mcp auth linear-project`.

Q: ¿Puedo limitar Linear MCP a un solo workspace?

Sí. Al definir la configuración en el archivo `opencode.jsonc` del proyecto, el servidor MCP queda restringido a ese workspace.

Q: ¿Qué hago si `opencode mcp auth` no está disponible?

Abre la configuración de OpenCode, entra en la sección MCP e inicia la autenticación desde ahí para el mismo servidor de Linear.

Configuración de Linear MCP por workspace

Para agregar Linear MCP a OpenCode en un solo repositorio, crea un opencode.jsonc local, ejecuta opencode mcp auth linear-project y confirma el resultado con opencode mcp list.

Esta configuración limita el acceso de Linear MCP al repositorio que contiene el opencode.jsonc, sin cambiar la configuración global.

1. Crea el archivo `opencode.jsonc` en tu workspace

En la raíz de tu proyecto, añade este archivo:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "linear-project": {
      "type": "remote",
      "url": "https://mcp.linear.app/mcp",
      "enabled": true
    }
  }
}

Nota: Usamos "linear-project" en lugar de "linear" para evitar colisiones con otras herramientas o alias, pero puedes elegir cualquier nombre.

2. Autentica el workspace

Para vincular tu cuenta, ejecuta este comando en la terminal:

opencode mcp auth linear-project

Si tu versión de OpenCode no incluye este comando, puedes autenticarte directamente desde la sección MCP en la configuración del cliente.

3. Verifica que el servidor esté activo

Primero, comprueba que el servidor aparece en la lista de integraciones:

opencode mcp list

Luego, hazle una petición de lectura al agente para confirmar que la comunicación funciona:

Muéstrame los primeros cinco issues abiertos que tengo asignados en Linear.

Si el agente responde con datos reales de tu workspace, la integración está lista.

4. Si falta `opencode mcp auth`

Algunas versiones de OpenCode muestran la autenticación MCP en la interfaz en lugar del CLI. Si opencode mcp auth linear-project no existe, abre la configuración, busca la sección MCP y completa ahí la autenticación para el mismo servidor.

Después, ejecuta:

opencode mcp list

Si linear-project aparece en la salida del workspace, la configuración sigue siendo válida.

5. Cómo confirmar que solo afecta a un workspace

Usar un archivo de configuración local por proyecto evita cambios accidentales en tu entorno global.

La comprobación directa es ejecutar opencode mcp list dentro de este repositorio y luego en otra carpeta que no tenga el mismo opencode.jsonc. La entrada de Linear debería aparecer solo donde añadiste la configuración.

Enlaces relacionados

Preguntas frecuentes

¿Cómo agrego Linear MCP a OpenCode?

Solo necesitas configurar el archivo opencode.jsonc en tu workspace apuntando a la URL remota de Linear y ejecutar el comando de autenticación.

¿Puedo limitar Linear MCP a un solo workspace?

Sí. Guarda la configuración en el opencode.jsonc de ese proyecto y verifica con opencode mcp list que la entrada de Linear solo aparece ahí.

¿Qué hago si `opencode mcp auth` no está disponible?

Usa la sección MCP dentro de la configuración de OpenCode para iniciar la autenticación del mismo servidor y luego vuelve a ejecutar opencode mcp list.