Cómo conectar tu agente de programación con IA a tus propias herramientas mediante MCP

Si has pasado tiempo con un agente de programación con IA, probablemente te hayas topado con el muro en el que dice algo como "no puedo ver tu base de datos" o "pega aquí los detalles del problema." El agente es inteligente, pero está encerrado: solo sabe lo que hay en tus archivos y lo que tú escribes. El Model Context Protocol (MCP) es la forma de derribar ese muro y dejar que el agente alcance tus herramientas reales: una base de datos, GitHub, un panel de monitoreo, un archivo de diseño.

Esta guía explica qué es MCP y recorre la conexión de tu primer servidor a Claude Code, con las mismas ideas aplicándose a Cursor y Copilot.

Qué es MCP en realidad

MCP es un estándar abierto: piénsalo como un adaptador universal entre los agentes de IA y los sistemas que ya usas. En lugar de que cada herramienta invente su propia manera de comunicarse con cada agente, una herramienta publica un único servidor MCP, y cualquier agente compatible con MCP (Claude, Cursor, Copilot) puede conectarse a él. Por eso has visto "MCP" por todas partes en 2026: es la fontanería que permite a los agentes hacer trabajo real en lugar de solo hablar de él.

Una buena regla general: conecta un servidor cada vez que te sorprendas copiando datos hacia el chat desde otra herramienta. Si sigues pegando registros de errores de Sentry o detalles de tickets de Jira, esa es una señal de que un servidor MCP te ahorraría el viaje.

Los dos tipos de servidores

Hay dos variantes que te encontrarás:

• Servidores remotos (HTTP) se ejecutan en la nube y te conectas a través de la red — Notion, GitHub y la mayoría de las herramientas SaaS funcionan así. Esta es la opción predeterminada recomendada.
• Servidores locales (stdio) se ejecutan como un proceso en tu propia máquina — útiles para cosas que necesitan acceso directo al sistema, como el controlador de una base de datos local.

Añadir tu primer servidor

El comando central es claude mcp add. Esta es la forma básica para un servidor HTTP remoto:

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

Un ejemplo concreto — conectar Notion para que tu agente pueda leer y actualizar páginas:

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

Si el servidor necesita autenticación, pasa un token como encabezado:

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

Para un servidor local, todo lo que viene después de -- es el comando que lo inicia:

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

Ese -- importa: separa los flags propios de Claude del comando que lanza el servidor, de modo que un --port destinado al servidor no se interprete como una opción de Claude.

Una vez añadido, comprueba lo que has conectado:

claude mcp list        # see all servers and their status
claude mcp get notion  # details for one server

Dentro de una sesión de Claude Code, el comando /mcp muestra el estado de conexión en vivo y, para los servidores que usan OAuth, te permite iniciar sesión.

Elige el alcance correcto

Cuando añades un servidor, decide quién debería verlo con el flag --scope:

• local (el predeterminado) — solo tú, solo este proyecto.
• project — compartido con todo tu equipo mediante un archivo .mcp.json incluido en el control de versiones. Ideal para la incorporación: un nuevo compañero clona el repositorio y el agente ya conoce las herramientas del equipo.
• user — disponible para ti en todos los proyectos de tu máquina.

Para una base de datos de equipo o un rastreador de incidencias, el alcance project suele ser lo que quieres. Para una clave de API personal, mantenlo en local o user para que nunca acabe en el repositorio.

Hazlo de forma segura

MCP es potente precisamente porque le da a un agente alcance real, así que un poco de precaución vale la pena:

• Confía en el servidor antes de conectarlo. Un servidor que obtiene contenido externo puede exponerte al riesgo de inyección de prompts, donde texto malicioso en los datos obtenidos intenta manipular a tu agente. Cíñete a servidores oficiales de proveedores que reconozcas.
• Limita las credenciales al mínimo. Dale al servidor una clave de solo lectura o de mínimo privilegio cuando la tarea solo necesita leer. Este es exactamente el principio que Microsoft incorporó en su plugin empresarial de Dataverse: el agente solo ve lo que permite el rol que se le ha concedido.
• Mantén los secretos fuera de la configuración compartida. Pon los tokens en variables de entorno o en un alcance local, nunca en un .mcp.json con alcance project que se incluya en el control de versiones.
• Revisa lo que puede hacer. Después de conectar, abre /mcp y echa un vistazo a las herramientas que expone el servidor para que no haya sorpresas.

La recompensa

Una vez que un servidor está conectado, el cambio en tu forma de trabajar es inmediato. En lugar de "aquí está el esquema que pegué," puedes pedir: "Encuentra los 10 registros más recientes en nuestra base de datos Postgres y redacta una invitación a una sesión de feedback para cada uno." El agente consulta la base de datos, lee los resultados y redacta los correos, todo en un solo flujo, porque por fin puede alcanzar los sistemas en los que realmente vive tu trabajo.

Empieza con un servidor para la herramienta desde la que más pegas. Esa única conexión suele hacer que el valor sea evidente más rápido que cualquier cantidad de lectura al respecto.