Cómo conectar Claude Code a tus DBs y APIs mediante MCP (Model Context Protocol)

Durante mucho tiempo, la mayor limitación de los asistentes de desarrollo basados en IA no era su capacidad para escribir código, sino su ceguera ante el mundo real.

Le pedías a la IA que investigara un bug sutil en producción, y el modelo empezaba a inventar tablas que no existían, asumir tipos de columnas equivocados o sugerir llamadas a endpoints obsoletos. Tenías que hacer de "puente humano": copiar la respuesta del terminal, pegarla en el chat, pedirle una SQL, ejecutarla tú en tu cliente de base de datos y pegarle el resultado.

Ese trabajo manual se acabó. Model Context Protocol (MCP) es el estándar abierto propuesto por Anthropic que permite a asistentes como Claude Code conectarse de forma nativa a tus bases de datos, APIs de staging, repositorios y servicios internos.

¿Qué es exactamente Model Context Protocol (MCP)?

Piensa en MCP (Model Context Protocol) como el estándar USB-C para los modelos de lenguaje.

Antes de MCP, si querías que un LLM interactuara con Postgres, tu API GraphQL o un canal de Slack, tenías que escribir integraciones ad-hoc y wrappers frágiles para cada herramienta.

MCP unifica todo bajo una arquitectura cliente-servidor muy simple:

• Host (o Cliente MCP): Tu entorno de desarrollo o agente (por ejemplo, Claude Code, AGY o Cursor).
• Servidor MCP: Un proceso ligero que expone herramientas (tools), recursos (resources) y prompts hacia el cliente mediante un protocolo JSON-RPC estándar over stdio o HTTP/SSE.

Cuando el agente necesita saber qué tablas existen en tu base de datos, llama a la herramienta list_tables expuesta por tu servidor MCP, recibe la respuesta estructurada y actúa en consecuencia sin que tú tengas que mover un dedo.

Cómo configurar un servidor MCP en Claude Code

Conectar Claude Code a una base de datos o servicio externo es cuestión de minutos. Puedes usar servidores MCP creados por la comunidad o construir el tuyo propio.

1. Usar un servidor existente (Ejemplo: PostgreSQL / Supabase)

Puedes añadir un servidor MCP directamente a la configuración de tu entorno con un comando sencillo:

claude mcp add postgres npx -y @modelcontextprotocol/server-postgres postgresql://user:pass@localhost:5432/mydb

A partir de ese momento, Claude Code tiene acceso a herramientas seguras como query para inspeccionar esquemas y ejecutar consultas de lectura cuando se lo pidas en lenguaje natural.

2. Crear tu propio servidor MCP personalizado en TypeScript

Si tienes una API interna o reglas de negocio propietarias, puedes construir tu propio servidor MCP en TypeScript con muy pocas líneas:

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";

const server = new Server(
  { name: "mi-api-interna", version: "1.0.0" },
  { capabilities: { tools: {} } }
);

// 1. Listar herramientas disponibles para la IA
server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: [{
    name: "buscar_usuario_por_email",
    description: "Busca los datos de un usuario en el entorno de staging por su email",
    inputSchema: {
      type: "object",
      properties: { email: { type: "string" } },
      required: ["email"]
    }
  }]
}));

// 2. Ejecutar la lógica cuando la IA invoca la herramienta
server.setRequestHandler(CallToolRequestSchema, async (request) => {
  if (request.params.name === "buscar_usuario_por_email") {
    const { email } = request.params.arguments as { email: string };
    const user = await miApiStaging.getUser(email);
    return { content: [{ type: "text", text: JSON.stringify(user) }] };
  }
  throw new Error("Herramienta no encontrada");
});

const transport = new StdioServerTransport();
await server.connect(transport);

Seguridad: Evitando riesgos en producciones reales

Darle acceso a un agente de IA a tus bases de datos y servicios requiere precauciones claras:

1. Principio de mínimo privilegio: Configura tus servidores MCP con credenciales de solo lectura para entornos de desarrollo o staging.
2. Protección contra inyecciones: Tal como explicamos en nuestro análisis sobre inyección indirecta de prompts en agentes de IA, nunca permitas que datos no confiables provenientes de la base de datos o de usuarios modifiquen el comportamiento del agente sin sanitizar.
3. Control de contexto: Utiliza técnicas de graph engineering para estructurar los datos expuestos por tus herramientas MCP y evitar saturar la memoria del modelo.

El protocolo MCP cambia drásticamente la relación entre el desarrollador y la IA. Dejas de copiar y pegar respuestas del terminal para convertir a tu agente en un miembro activo del equipo que consulta métricas, ejecuta tests y verifica estados en tiempo real.

Si quieres llevar tus habilidades al siguiente nivel y dominar la integración de agentes con infraestructuras reales, explora los Cursos de Dominicode. Y si buscas construir proyectos con arquitecturas avanzadas de IA, entra en Dominicode Labs.

Preguntas frecuentes

¿MCP funciona solo con Claude Code o con cualquier cliente de IA?

MCP es un estándar abierto. Aunque fue creado por Anthropic, puede ser implementado por cualquier cliente, IDE o framework de agentes (como Cursor, Antigravity, VS Code o agentes personalizados).

¿Es seguro conectar una base de datos de producción a través de MCP?

Se recomienda conectar únicamente entornos de desarrollo, staging o réplicas de solo lectura. Para operaciones de escritura en producción, el servidor MCP debe solicitar siempre confirmación explícita del usuario antes de ejecutar cualquier cambio.

¿Qué diferencia hay entre una llamada a una API tradicional y un servidor MCP?

Una llamada a API tradicional requiere que tú programes la petición exacta en tu código. Un servidor MCP le enseña a la IA la firma de la herramienta para que el modelo decida de forma autónoma cuándo y cómo invocarla según el contexto de la conversación.

¿Dónde puedo encontrar servidores MCP listos para usar?

Existen repositorios oficiales y comunitarios con servidores MCP para PostgreSQL, GitHub, Slack, Puppeteer, Brave Search, Google Drive y decenas de servicios populares.

Por Bezael Pérez — Developer senior con más de 15 años de experiencia y fundador de Dominicode.