Summary
Guía completa para convertir APIs REST en servidores MCP para Claude, ChatGPT y Copilot. Transforma cualquier endpoint REST en una herramienta lista para IA con AnythingMCP.
¿Por Qué Convertir APIs REST a MCP?
El Protocolo de Contexto del Modelo (MCP) es el estándar que permite a asistentes de IA como Claude, ChatGPT y Copilot interactuar con herramientas externas. Al convertir tu API REST en un servidor MCP, permites que los agentes de IA llamen a tus endpoints usando lenguaje natural — sin necesidad de código personalizado.
Lo Que Necesitas
- Una API REST (cualquier API con endpoints HTTP)
- Docker instalado en tu máquina
- Un cliente de IA compatible con MCP (Claude Desktop, Claude.ai, ChatGPT, Copilot, Cursor, etc.)
Paso a Paso: Convierte Tu API REST
Paso 1: Desplegar AnythingMCP
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Esto inicia el backend (puerto 4000), el panel de control (puerto 3000) y PostgreSQL.
Paso 2: Crear un Conector REST
Abre el panel de control en http://localhost:3000 y crea un nuevo conector REST. Puedes importar tu API desde:
- Especificación OpenAPI/Swagger — Pega la URL o sube el archivo JSON/YAML
- Colección de Postman — Importa una exportación de Postman directamente
- Comandos cURL — Pega comandos cURL y AnythingMCP los analiza en endpoints
Paso 3: Configurar la Autenticación
Configura el método de autenticación de tu API en la configuración del conector:
- Token Bearer
- Clave API (encabezado o consulta)
- Autenticación Básica
- OAuth 2.0
Se pueden usar variables de entorno para secretos para que no queden en tu configuración.
Paso 4: Revisar Herramientas MCP Auto-Generadas
AnythingMCP convierte automáticamente cada endpoint REST en una herramienta MCP. Revisa las herramientas en el panel de control, personaliza nombres y descripciones, y oculta cualquier endpoint que no quieras exponer.
Paso 5: Conectar a Tu Asistente de IA
Añade el servidor MCP a la configuración de tu cliente de IA:
{
"mcpServers": {
"my-api": {
"url": "http://localhost:4000/mcp"
}
}
}
Ahora tu asistente de IA puede llamar a los endpoints de tu API REST a través del lenguaje natural.
Funciona Con Todas las Principales Herramientas de IA
- Claude Desktop / Claude.ai — Soporte completo de MCP
- ChatGPT — A través del plugin MCP
- Microsoft Copilot — Integración MCP
- Cursor — Soporte MCP integrado
- Windsurf — Soporte nativo de MCP
Mejores Prácticas
- Comienza solo lectura — Expón primero los endpoints GET, luego añade operaciones de escritura
- Usa nombres significativos — Renombra las herramientas en el panel de control para mayor claridad
- Añade descripciones — Ayuda a los agentes de IA a entender qué hace cada herramienta
- Establece límites de tasa — Protege tu API de llamadas excesivas
Próximos Pasos
- Convertir SOAP a MCP — Para servicios SOAP heredados
- Convertir GraphQL a MCP — Para APIs GraphQL
- Conectar Tu Base de Datos a MCP — Para acceso directo a la base de datos
¿Te ha sido útil esta guía?
