¿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 casi 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), el protocolo define un estándar para que el agente “enchufe” cualquier herramienta que exponga un servidor MCP. Tú sigues teniendo el control en todo momento: el agente solo puede usar lo que tú autorizas, y cada acción te pide permiso antes de ejecutarse.

La idea suena técnica, pero el día a día es muy concreto. Sin MCP, cada cliente de IA tiene que inventar su propia forma de hablar con cada servicio: una para leer archivos, otra para GitHub, otra para tu calendario. Con MCP, esa conversación se estandariza. Cualquiera puede publicar un servidor (los hay oficiales, de empresas y de la comunidad) y, si tu cliente entiende el protocolo, lo conectas con un par de líneas de configuración. Ese cambio aparentemente pequeño es lo que está haciendo que los agentes pasen de “chats listos” a “trabajadores conectados”.

El protocolo es abierto, así que no dependes de una sola empresa. Hoy lo soportan Claude Desktop, Claude Code, Cursor, VS Code y un puñado largo de clientes más. Si te aburres de uno, te llevas tu lista de servidores al siguiente y sigues trabajando casi igual.

Qué te abre

Conectar MCPs convierte al agente en alguien que puede tocar tu entorno, no solo opinar sobre él. Un servidor de archivos le permite leer y organizar tu carpeta de proyectos. Uno de GitHub le deja abrir issues y revisar PRs. Uno de navegador le da acceso a la web en tiempo real. Uno de tu app de notas le da memoria de largo plazo. Cada servidor es un superpoder concreto que el agente puede invocar cuando hace falta.

El truco está en cómo se combinan. Un mismo agente puede tener varios MCPs activos a la vez y decidir cuál usar para cada parte de la tarea. Si le pides “mira mis notas de la reunión con el cliente X y abre un issue en el repo del proyecto”, el agente consulta el MCP de notas, redacta el resumen y usa el MCP de GitHub para crear el issue. Lo que antes era pegar contexto a mano entre pestañas, ahora pasa solo.

Otra ventaja menos obvia es que escribes la integración una vez y la reutilizas. El mismo servidor de filesystem te sirve en Claude Desktop por la mañana y en Cursor por la tarde. No tienes que volver a configurar tu flujo cada vez que cambias de herramienta: cambias de cliente, conservas tus enchufes.

Cómo conectarlo

Hay tres piezas que conviene distinguir antes de configurar nada:

• 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 tú 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. Escribes la integración una vez y la reutilizas en todos lados.

Para conectar un servidor en Claude Desktop, el camino corto es el siguiente. Primero verifica que tienes Node.js instalado con node --version, porque la mayoría de los servidores corren con npx. Si no lo tienes, instala la versión LTS desde nodejs.org. Después abre Claude Desktop, ve a Configuración, pestaña Developer y pulsa “Edit Config”. Eso abre (o crea) el archivo claude_desktop_config.json en la ubicación que indica el frontmatter de esta ficha (cambia entre Windows y Mac). Pega ahí el bloque mcpServers con el servidor que quieras conectar, guarda y cierra Claude Desktop por completo (no basta con cerrar la ventana, hay que salir desde el menú). Al volver a abrirlo, el cliente carga la configuración y el servidor aparece disponible.

El ejemploConfig de esta lección es la plantilla mínima: un objeto mcpServers con una clave por servidor, y dentro command y args. La mayoría de servidores se invocan con npx -y seguido del paquete; otros usan docker o uvx. La ficha de cada MCP de la biblioteca trae el bloque exacto que toca pegar.

Si trabajas en Claude Code en lugar de Claude Desktop, el flujo cambia: usas claude mcp add en el terminal en vez de editar JSON a mano. El resultado es el mismo (el cliente acaba con una lista de servidores conectados), pero el camino es más cómodo cuando ya vives en la terminal.

Seguridad y permisos

MCP está diseñado para que el agente nunca actúe a tus espaldas, pero la seguridad real depende de a qué le des acceso. Cuando conectas un servidor de filesystem y le pasas la carpeta Documentos entera, el agente puede leer todo lo que haya ahí dentro mientras esté activo. La regla práctica es darle solo lo que necesita para la tarea de hoy: una carpeta concreta, un repo concreto, una bóveda concreta. Cuanto más estrecho sea el alcance, menos margen para sorpresas.

Las claves de API (las que piden servidores como Firecrawl o GitHub) son la otra pata. Trátalas como contraseñas: nunca las pegues en chats públicos ni las subas a un repositorio. Si una clave queda expuesta, revócala y genera otra. Y antes de aprobar acciones de escritura (borrar, sobrescribir, abrir un PR), léelas con calma; el botón de “permitir” es tuyo y conviene usarlo con criterio.

Casos de uso reales

Un desarrollador conecta el MCP de filesystem a su carpeta de proyectos y el de GitHub a su cuenta. Pide “revisa el último commit, identifica el bug y abre un issue describiéndolo”. El agente lee los archivos relevantes, redacta el issue y lo crea, sin que él tenga que saltar entre VS Code y la web de GitHub.

Una consultora monta su segundo cerebro en Obsidian y le conecta el MCP correspondiente. Antes de cada reunión le pide al agente “resume lo que sé del cliente X y prepárame tres preguntas para la llamada de hoy”. El agente busca en sus notas, conecta puntos y le devuelve un brief que antes le costaba treinta minutos preparar.

Un analista usa el MCP de Firecrawl para extraer información estructurada de la web y el de filesystem para guardarla en su disco. Pide “rastrea estas cinco páginas, sácame los precios y déjalos en un CSV en mi carpeta de mercado”. Lo que antes eran copiar-pegar interminables se convierte en una sola instrucción.

Errores comunes y cómo evitarlos

• El servidor no aparece después de editar la config. Casi siempre es porque no cerraste Claude Desktop del todo. Sal desde el menú, no solo cierres la ventana, y vuelve a abrirlo.
• JSON roto. Una coma de más, una llave sin cerrar o unas comillas raras pegadas desde una web rompen toda la config. Usa un validador (jsonlint.com) si dudas.
• npx no encuentra el paquete. Suele faltar Node.js en el PATH o estar en una versión muy vieja. Reinstala la LTS y vuelve a probar.
• El agente “no ve” la herramienta. Comprueba que el bloque está dentro de mcpServers y no fuera, que el nombre del paquete está bien escrito y que reiniciaste el cliente.
• Claves filtradas. Si pegas la clave real en un repo, no la edites: revócala y genera otra. Los buscadores de GitHub indexan más rápido de lo que crees.

Combinarlo con otros MCPs y skills

MCP es el cimiento de casi todo lo demás en esta biblioteca. Encaja especialmente bien con servidores concretos como el de filesystem (para leer y guardar resultados), el de GitHub (para gestionar trabajo en equipo), Firecrawl (para datos de la web) y Obsidian (para memoria de largo plazo). También se complementa con las skills de Claude Code: las skills le dan al agente “cómo trabajar”, y los MCPs le dan “con qué trabajar”.

Mini-ejercicio

Instala Node.js si no lo tienes, abre el claude_desktop_config.json y pega un bloque mcpServers con un servidor simple (puedes usar el de filesystem apuntando a una carpeta de prueba). Reinicia Claude Desktop y pídele al agente que liste los archivos de esa carpeta. Sabrás que está bien si te responde con la lista real, no con una excusa de “no tengo acceso a tus archivos”.

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