Qué es MCP y cómo conectar tu primer servidor paso a paso

¿Qué es MCP? MCP (Model Context Protocol) es un estándar abierto que permite a una app de IA, como Claude, ChatGPT o Cursor, conectarse con sistemas externos: archivos, bases de datos, tu calendario, Notion o GitHub. Sus creadores lo comparan en la documentación oficial con un puerto USB-C: un solo conector que sirve para muchos dispositivos.

En este tutorial explico cómo funciona MCP por dentro y después conectamos un primer servidor MCP en Claude Code (remoto y local) y en la app de Claude. Los comandos salen de la documentación de Claude Code y del repositorio de servidores de referencia de MCP.

Qué es MCP en la práctica

Un modelo de lenguaje, por sí solo, no ve tus archivos ni tu calendario. Para que un agente de IA pueda hacer algo en el mundo necesita herramientas (qué es un agente lo expliqué en Qué es un agente de IA). Sin un estándar común, cada app tendría que conectar cada herramienta a su manera.

MCP cambia eso: alguien escribe una sola vez un servidor MCP para un servicio y luego lo puede usar cualquier app compatible con el protocolo. La documentación da ejemplos de lo que eso permite:

1. un agente con acceso a tu Google Calendar y Notion,
2. Claude Code construyendo una app web completa a partir de un diseño de Figma,
3. un chatbot de empresa conectado a varias bases de datos a la vez,
4. un modelo que diseña un objeto 3D en Blender y lo manda a la impresora.

¿De dónde salió MCP?

Anthropic publicó MCP como código abierto el 25 de noviembre de 2024. Un año después, el 9 de diciembre de 2025, la empresa cedió el protocolo a la Agentic AI Foundation, un fondo dentro de la Linux Foundation que también cofundaron OpenAI y Block. Así, MCP ya no pertenece a una sola empresa.

Hoy el protocolo lo soportan, entre otros, Claude, ChatGPT, Visual Studio Code y Cursor, así que un servidor escrito una vez funciona en muchos sitios.

¿Cómo funciona MCP por dentro?

Según la descripción de la arquitectura, MCP tiene tres roles:

1. Host: la app de IA que usas (por ejemplo Claude Code o Claude Desktop),
2. Cliente: un componente dentro del host. El host crea un cliente distinto para cada servidor,
3. Servidor: el programa que aporta datos y herramientas.

Un servidor puede funcionar en local (en tu ordenador, comunicándose por la entrada y salida estándar, lo que se llama “stdio”) o en remoto (en internet, mediante “Streamable HTTP”). Los mensajes usan el formato JSON-RPC 2.0.

Un servidor ofrece tres tipos de cosas:

1. herramientas (tools): funciones que el modelo puede invocar, como una consulta a la base de datos o guardar un archivo,
2. recursos (resources): datos para el contexto, como el contenido de un archivo o el esquema de una base de datos,
3. prompts: plantillas listas para interactuar con el modelo.

El flujo es sencillo: el cliente pide al servidor la lista de herramientas (tools/list), el modelo elige una y el cliente la invoca (tools/call) y le devuelve el resultado al modelo. Lo curioso es que en la versión actual de la especificación (2026-07-28) el protocolo no tiene estado: cada petición lleva todo lo que el servidor necesita para atenderla.

Paso 1: ¿cómo conectar un servidor MCP remoto a Claude Code?

Doy por hecho que ya tienes instalado Claude Code (si no, empieza por mi tutorial de Claude Code). Según la documentación, un servidor HTTP remoto es la opción recomendada. La sintaxis básica es esta:

claude mcp add --transport http <nombre> <url>

El ejemplo de la documentación, conectar Notion:

claude mcp add --transport http notion https://mcp.notion.com/mcp

La mayoría de los servidores remotos piden iniciar sesión. En ese caso escribes /mcp en la sesión de Claude Code y completas el inicio de sesión en el navegador. El mismo comando muestra también el estado de todos los servidores conectados.

Si el servidor usa un token en lugar de un inicio de sesión, añades una cabecera:

claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

Paso 2: ¿cómo ejecutar un servidor MCP local?

Un servidor local corre en tu ordenador como un proceso normal. Un buen primer ejemplo es el servidor de archivos de referencia, que da al modelo acceso solo a las carpetas que indiques. Necesitas Node.js (para npx).

El comando del servidor va después de --, y todo lo que sigue a ese signo llega al servidor sin cambios:

claude mcp add --transport stdio filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/notas

El último argumento es la carpeta a la que el servidor tiene acceso (puedes poner varias). El servidor ofrece, entre otras, las herramientas read_text_file, write_file, edit_file, list_directory y search_files. Ahora puedes pedirle a Claude Code algo como “busca en mis notas todo sobre MCP y hazme una lista”.

Si el servidor necesita una clave de API, se la pasas con --env. Un ejemplo de la documentación:

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

Paso 3: ¿cómo gestionar los servidores MCP?

Para gestionarlos bastan tres comandos sencillos:

claude mcp list          # lista de servidores
claude mcp get notion    # detalles de un servidor
claude mcp remove notion # eliminar un servidor

También importa el ámbito (scope), es decir, dónde se guarda el servidor:

Ámbito	Dónde funciona	¿Lo recibe el equipo?	Dónde se guarda
local (por defecto)	solo el proyecto actual	no	~/.claude.json
project	solo el proyecto actual	sí, a través del repositorio	.mcp.json en la carpeta del proyecto
user	todos tus proyectos	no	~/.claude.json

El ámbito se elige con la opción --scope, por ejemplo --scope user. Con el ámbito project, guarda las claves de API en variables de entorno (${VAR} en el archivo .mcp.json) para que no acaben en el repositorio.

Paso 4: ¿cómo añadir un servidor MCP en la app de Claude?

En la app de Claude (web y escritorio), los servidores MCP se llaman conectores. Los ya hechos están en el directorio de conectores, y tu propio servidor remoto lo añades como “custom connector”. Según el centro de ayuda de Claude:

1. entra en Customize > Connectors,
2. haz clic en “+ Add” y luego en “Add custom connector”,
3. escribe un nombre y la URL del servidor MCP remoto,
4. revisa la configuración de autenticación y haz clic en “Add”.

Los conectores funcionan en todos los planes, pero en el plan gratuito puedes añadir solo un conector propio. Ojo: Claude se conecta al servidor desde la nube de Anthropic, así que el servidor tiene que ser accesible desde internet. Otras funciones de Claude también usan los conectores, por ejemplo el agente Claude Duet.

¿En qué fijarse?

Primero, en quién confías. Un servidor MCP le da al modelo capacidad real de actuar, y la documentación de Claude Code avisa claramente de que los servidores que traen contenido externo te exponen a la inyección de prompts (prompt injection). El centro de ayuda añade que los servidores maliciosos pueden contener instrucciones ocultas que intentan llevar a Claude a hacer cosas no deseadas. Conecta solo servidores de empresas y autores de confianza.

Segundo, en los permisos. Pulsa “Allow always” solo en herramientas en las que confíes lo bastante como para dejarlas actuar sin supervisión. La buena noticia: un repositorio clonado no puede aprobar por sí mismo sus servidores de .mcp.json, Claude Code te pide permiso antes.

Tercero, en el alcance del acceso. Al servidor de archivos dale solo una carpeta concreta, no todo el disco. Escribí más sobre cómo proteger claves y agentes en Seguridad de los agentes de IA.

FAQ

¿Qué es MCP en palabras sencillas?

Un estándar común con el que las apps de IA se conectan a herramientas y datos. Un servidor MCP escrito una vez funciona en muchas apps, igual que un dispositivo USB-C funciona con muchos ordenadores.

¿MCP solo funciona con Claude?

No. El protocolo lo creó Anthropic, pero hoy lo desarrolla la Agentic AI Foundation dentro de la Linux Foundation, y lo soportan, entre otros, ChatGPT, Visual Studio Code y Cursor.

¿En qué se diferencia un servidor MCP local de uno remoto?

El local corre en tu ordenador y se comunica por stdio, normalmente con una sola app. El remoto funciona en internet (Streamable HTTP) y suele atender a muchos clientes a la vez. Para la autenticación, la especificación recomienda OAuth.

¿MCP es gratis?

El protocolo en sí es abierto y gratuito. Pagas por la app de IA que usas y, en su caso, por el servicio al que se conecta el servidor.