Configurar un MCP server en Linux tiene algunos detalles que no están documentados en los tutoriales genéricos — especialmente en Fedora, donde SELinux y los paths de configuración difieren de Ubuntu o macOS. Esta guía cubre todo lo que necesitás saber para dejar Claude Code conectado a Cerebro MCP en Fedora sin errores de permisos ni conexiones que no arrancan.

Prerequisitos

Antes de empezar, verificá que tenés instalado:

  • Claude Code: descargado e instalado desde claude.ai/code. En Fedora el binario queda en ~/.local/bin/claude o /usr/local/bin/claude según el método de instalación.
  • Node.js 18+ o Python 3.10+: dependiendo del MCP server que uses. Cerebro MCP usa un backend FastAPI pero la conexión desde Claude Code es vía SSE, así que no necesitás instalar nada extra del lado del cliente.
  • API key de Cerebro MCP: generada en tu portal en cerebro.intea.com.ar/portal.php tras el registro.

Ubicación del archivo mcp.json en Linux

En Fedora (y Linux en general), el archivo de configuración de MCP de Claude Code vive en:

~/.claude/mcp.json

Si Claude Code no lo creó automáticamente, crealo vos:

mkdir -p ~/.claude
touch ~/.claude/mcp.json

Configuración de Cerebro MCP

El contenido del mcp.json para Cerebro MCP es:

{
  "mcpServers": {
    "cerebro": {
      "type": "sse",
      "url": "https://api.intea.com.ar/mcp/sse",
      "headers": {
        "Authorization": "Bearer TU_API_KEY_AQUI"
      }
    }
  }
}

Reemplazá TU_API_KEY_AQUI con tu API key real (formato CRB-XXXXXX-XXXXXX-XXXXXX). Si ya tenés otros MCP servers configurados, agregá el bloque "cerebro": {...} dentro del objeto mcpServers existente — no sobrescribas todo el archivo.

Permisos del archivo

La API key es una credencial. Ajustá los permisos para que solo tu usuario pueda leerla:

chmod 600 ~/.claude/mcp.json

SELinux — el detalle específico de Fedora

Si Claude Code no puede leer el archivo o la conexión SSE falla con errores de red, SELinux puede ser la causa. Verificá el log:

sudo ausearch -m avc -ts recent | grep claude

Si aparecen deniegaciones (denied), la solución más limpia es marcar el archivo con el contexto correcto:

restorecon -v ~/.claude/mcp.json

Si Claude Code está instalado en un path no estándar, puede necesitar un contexto adicional:

chcon -t user_home_t ~/.claude/mcp.json

En la mayoría de las instalaciones de Claude Code en Fedora, esto no es necesario — SELinux no bloquea lecturas del home del usuario por aplicaciones del mismo usuario. Pero si usás un perfil SELinux personalizado o Fedora Silverblue, puede aparecer.

Verificar que el MCP está activo

Después de editar el mcp.json, reiniciá Claude Code completamente (no solo la ventana — el proceso entero). Al abrir una sesión nueva, ejecutá:

/tools

Deberías ver las 6 tools de Cerebro MCP listadas:

cerebro__get_context
cerebro__search_knowledge
cerebro__get_prompt
cerebro__get_checklist
cerebro__get_script
cerebro__list_knowledge

Si no aparecen, el problema más común es un error de sintaxis en el JSON. Validalo:

python3 -m json.tool ~/.claude/mcp.json

Firewalld — conexiones salientes

Fedora con firewalld activo no bloquea conexiones HTTPS salientes por defecto. Claude Code se conecta a api.intea.com.ar:443 vía HTTPS/SSE — esto pasa sin configuración adicional en la mayoría de las instalaciones domésticas o de oficina.

Si estás en un entorno corporativo con reglas de egress estrictas, necesitás que el administrador de red permita tráfico HTTPS saliente a api.intea.com.ar. No hay configuración local que puedas hacer del lado del cliente en ese caso.

Troubleshooting

Los errores más comunes y sus causas:

  • Tools no aparecen tras reiniciar: JSON malformado. Correr python3 -m json.tool ~/.claude/mcp.json para verificar.
  • Tools aparecen pero retornan error 401: API key incorrecta o con espacios extra al pegar. Verificar que no haya saltos de línea dentro del valor.
  • Error de conexión / timeout: verificar conectividad con curl -I https://api.intea.com.ar/health. Si responde 200, el problema es local.
  • Tools aparecen pero Claude no las llama: normal en las primeras sesiones. Claude necesita contexto para inferir cuándo llamarlas. Pedile explícitamente: "auditá la seguridad de este proyecto".

Uso desde la terminal

Una de las ventajas de Claude Code en Linux es que podés usarlo directamente desde la terminal en el directorio del proyecto:

cd ~/proyectos/mi-sitio-php
claude "revisá la seguridad del formulario de login"

Con Cerebro MCP activo, Claude llama automáticamente a get_context("security-audit") antes de analizar los archivos. No hay diferencia en el comando — la diferencia está en la profundidad y especificidad de la respuesta.