Conectar servidores MCP con Claude: guía práctica

Qué es MCP y por qué importa

MCP (Model Context Protocol) es la capa estándar que permite a modelos de IA como Claude conectarse con herramientas externas —APIs, archivos, repositorios y bases de datos— sin construir una integración personalizada para cada combinación. Antes de MCP, conectar un modelo a GitHub, Slack o una base de datos exigía integraciones separadas; Anthropic describió esto como el problema “N×M”. MCP cambia eso a un enfoque N+M: construyan un servidor MCP para GitHub y cualquier cliente compatible podrá usarlo.

Para equipos en América Latina esto facilita poner a producir integraciones comunes (por ejemplo, acceso a repositorios o almacenamiento en la nube) sin repetir trabajo para cada cliente de IA que adopten.

Arquitectura en 3 partes (explicación rápida)

Entender las tres piezas evita la mayoría de los dolores de configuración:

Host: la aplicación de IA con la que interactúa el usuario y que administra contexto y seguridad (Claude Desktop, Claude Code, Cursor, etc.).
Cliente MCP (dentro del host): maneja la comunicación de protocolo con los servidores MCP.
Servidor MCP: proceso externo que expone herramientas o recursos al modelo a través de MCP (por ejemplo, un servidor MCP para GitHub o para el sistema de archivos).

Cuando piden a Claude “revisa mis PRs abiertos en GitHub”, el flujo típico es:

Claude decide que necesita un servidor externo.
El cliente MCP dentro de Claude envía una petición JSON-RPC al servidor MCP correspondiente.
El servidor consulta la API (GitHub) y devuelve datos estructurados.
Claude incorpora esos datos y genera la respuesta. Todo puede ocurrir en menos de un segundo; ustedes no ven esta tubería.

Nota técnica: a abril de 2026 Anthropic recomienda Streamable HTTP como transporte y está deprecando el transporte SSE más antiguo.

Claude Desktop: opciones de configuración

Claude Desktop carga su configuración MCP desde un archivo JSON. Hay dos métodos principales para agregar servidores MCP:

Desktop Extensions (.mcpb): instalación con un clic, sin editar JSON.
JSON config: control total para servidores personalizados o privados.

Método 1 — Desktop Extensions (.mcpb)

Las Desktop Extensions son paquetes preempaquetados (.mcpb; antes se usaba la extensión .dxt) que se instalan con doble clic. Recomendadas para usuarios no técnicos o para servidores que quieren “set and forget”.

Pasos:

Abrir Claude Desktop.
Clic en el botón ”+” en la esquina inferior izquierda del área de chat.
Seleccionar “Connectors” para abrir el menú de conectores.
Buscar el servidor (por ejemplo, GitHub o Google Drive) y hacer clic en “Install”. También pueden elegir “add connectors” para ir al directorio de conectores.
Reiniciar Claude Desktop. El servidor se activará automáticamente.

Ventaja: no hay que lidiar con edición de archivos JSON ni con problemas de PATH de Node.js que son comunes al instalar servidores manualmente.

Método 2 — JSON config (control total)

Claude Desktop lee la configuración desde claude_desktop_config.json. Las ubicaciones varían según el sistema operativo:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows (instalador .exe directo): %APPDATA%\Claude\claude_desktop_config.json
Windows (Microsoft Store, WinGet o MSIX): %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json

Un punto que suele confundir: si no encuentran el archivo en %APPDATA% en Windows, probablemente tengan la versión de la Tienda/MSIX y el archivo estará en la ruta más larga mencionada arriba. El empaquetado de Windows redirige silenciosamente la ubicación.

Si el archivo aún no existe, abran Claude Desktop → menú superior → Settings → Developer → Edit Config. Esto crea el archivo en la ruta correcta y lo abre en su editor predeterminado.

El archivo tiene una sola clave superior: mcpServers, que es una lista de servidores que desean declarar. Cada entrada suele contener al menos:

command: el comando que arranca el servidor (a menudo npx para servidores distribuidos como paquetes npm).
argumentos y variables de entorno: les da control sobre flags y credenciales cuando usan servidores privados.

Un detalle crítico en Windows: las rutas en JSON deben escapar la barra invertida. Por ejemplo, en un JSON una ruta como C:\Users\yourname\Documents debe escribirse como C:\Users\yourname\Documents; una sola barra invertida rompe el parser JSON.

Claude Code: agregar servidores MCP desde la línea de comando

Claude Code (la variante orientada a desarrolladores) permite administrar servidores MCP vía CLI. El comando clave es:

claude mcp add

Ejecuten este comando en la terminal y sigan las indicaciones para registrar un servidor MCP local o remoto. Este flujo es útil para entornos de desarrollo y despliegues automatizados donde prefieren scripts sobre edición manual.

Qué servidores instalar primero

Los servidores más prácticos para empezar suelen ser aquellos que exponen recursos que consultan con frecuencia: GitHub (o su hosting de repos), un servidor de archivos (filesystem), y conectores a almacenamiento en la nube o a sistemas internos de la empresa. Las Desktop Extensions ofrecen versiones “listas para usar” de muchos de estos.

Errores comunes y cómo resolverlos

No veo el archivo de config en Windows: verifiquen si usaron la versión de la Tienda/MSIX; la ruta puede ser la de LocalCache mencionada arriba.
JSON inválido por barras invertidas: escapen las \ con doble \ en Windows.
Servidor no arranca desde JSON: revisen el comando declarado (por ejemplo, que npx exista en PATH) y consideren usar una Desktop Extension para evitar problemas de PATH.
Transporte antiguo (SSE): si encuentran transportes SSE documentados en guías antiguas, recuerden que Anthropic recomienda Streamable HTTP desde abril de 2026.

Avanzado: construir su propio servidor MCP

Si necesitan exponer funcionalidades internas (bases de datos, repositorios privados, herramientas internas), pueden implementar un servidor MCP que actúe como puente entre esas APIs y Claude. La idea general:

Implementar un proceso que responda al protocolo MCP (JSON-RPC y transporte recomendado: Streamable HTTP).
Exponer los endpoints o prompts que quieran poner a disposición del modelo.
Registrar el servidor en Claude Desktop (JSON) o en Claude Code (claude mcp add).

Construir su propio servidor es ideal para empresas latinoamericanas que quieran mantener control sobre datos sensibles o integrar herramientas internas sin depender de paquetes públicos.

Conclusión y recomendaciones prácticas

Para equipos no técnicos o despliegues rápidos: usen Desktop Extensions (.mcpb) y eviten edición manual.
Para servidores privados o configuraciones específicas: usen el archivo claude_desktop_config.json y el flujo de Edit Config para asegurarse de escribir en la ruta correcta.
Para desarrolladores y automatización: gestionen servidores desde Claude Code con la CLI (claude mcp add).
Tengan especial cuidado con rutas en Windows y con la visibilidad del binario (PATH). Y adopten Streamable HTTP como transporte cuando implementen servidores nuevos.

Con MCP, la integración entre modelos y herramientas deja de ser un rompecabezas N×M y pasa a ser manejable. Aprovechar esta capa puede acelerar mucho la adopción de IA en sus procesos y productos.