¿Qué es un MCP?

%APPDATA%\Claude\claude_desktop_config.json

~/Library/Application Support/Claude/claude_desktop_config.json

node --version

MCP es a los agentes de IA lo que el USB-C fue a los dispositivos: antes cada aparato traía su propio cable y su propio enchufe, y conectar algo nuevo era una pelea. El USB-C puso un solo conector que sirve para todo. MCP hace lo mismo con los agentes: en vez de programar una integración a medida para cada servicio (tu disco, GitHub, una base de datos, un sitio web), define un estándar para que el agente “enchufe” cualquier herramienta que exponga un servidor MCP. Vos sigues teniendo el control: el agente solo puede usar lo que vos autorizás, y cada acción te pide permiso.

Cómo encaja en el ecosistema

Hay tres piezas que conviene distinguir:

• El modelo (Claude, por ejemplo) razona y decide qué hacer.
• El cliente MCP (Claude Desktop, Claude Code, VS Code y otros) es el programa donde vos trabajas y que le habla a los servidores.
• El servidor MCP es el “enchufe” de cada herramienta: uno para archivos, otro para GitHub, otro para la web. Cada servidor expone funciones que el agente puede llamar.

La gracia es que un mismo servidor sirve para cualquier cliente compatible. Escribís la integración una vez y la reusás en todos lados.

Cómo conectar un servidor, paso a paso

1. Verifica que tienes Node.js, que la mayoría de los servidores necesitan:

node --version

Si no lo tienes, instálalo desde nodejs.org (versión LTS).

2. En Claude Desktop, abre Configuración, ve a la pestaña Developer y toca “Edit Config”. Eso abre (o crea) el archivo claude_desktop_config.json. La ubicación cambia según el sistema:

Windows: %APPDATA%\Claude\claude_desktop_config.json
Mac:     ~/Library/Application Support/Claude/claude_desktop_config.json

3. Añade el servidor dentro de mcpServers:

{
  "mcpServers": {
    "mi-servidor": {
      "command": "npx",
      "args": ["-y", "@ejemplo/servidor-mcp"]
    }
  }
}

4. Guarda y reinicia Claude Desktop por completo (ciérralo del todo, no solo la ventana). Recién ahí carga el servidor.

Ejemplo real

Con un servidor conectado, le hablás al agente en lenguaje natural y él decide cuándo usar las funciones que el servidor expone:

Revisa la carpeta de mi proyecto, decime qué archivos hay y resumime el README.

Seguridad y errores comunes

• El agente nunca actúa solo: vos aprobás cada acción. Aun así, dale acceso únicamente a lo que necesite.
• Si el servidor no aparece, casi siempre es porque no reiniciaste Claude Desktop del todo.
• Errores típicos de JSON: una coma de más o una llave sin cerrar rompen toda la config.
• Si una herramienta pide una clave, usa un placeholder como TU_API_KEY mientras pruebas y nunca subas la clave real a un repositorio.

Cuándo conviene

Cuando quieres que el agente deje de estar “encerrado” en su conocimiento y pueda trabajar con tus datos y herramientas reales: leer tus archivos, mover datos, consultar APIs o automatizar tareas. Es la base de todo lo que sigue en esta biblioteca.

{
  "mcpServers": {
    "mi-servidor": {
      "command": "npx",
      "args": ["-y", "@ejemplo/servidor-mcp"]
    }
  }
}