Summary
Guía paso a paso para convertir cualquier API REST en un servidor compatible con MCP utilizando AnythingMCP. No se requiere programación.
¿Qué es el Protocolo de Contexto de Modelo (MCP)?
El Protocolo de Contexto de Modelo (MCP) es un estándar abierto que permite a agentes de IA como Claude, ChatGPT y otros interactuar con herramientas y fuentes de datos externas de manera estructurada. MCP define cómo los modelos de IA pueden descubrir, entender y utilizar herramientas.
¿Por qué Convertir APIs REST a MCP?
La mayoría de las aplicaciones empresariales exponen APIs REST. Al convertir estas en servidores MCP, habilitas a los agentes de IA para:
- Leer y escribir datos de tus sistemas internos
- Ejecutar flujos de trabajo empresariales a través del lenguaje natural
- Acceder a información en tiempo real de bases de datos y servicios
Guía Paso a Paso
Paso 1: Desplegar AnythingMCP
Clona el repositorio y comienza la aplicación con Docker Compose:
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 PostgreSQL, la API backend (puerto 4000) y el panel de control (puerto 3000).
Paso 2: Crear un Conector REST
Abre el panel de control de AnythingMCP en http://localhost:3000 y crea un nuevo conector REST. Puedes importar la definición de tu API desde múltiples fuentes:
- OpenAPI/Swagger — Sube o pega la URL de tu especificación OpenAPI
- Colección de Postman — Importa directamente desde una exportación JSON de Postman
- Comandos cURL — Pega comandos cURL y AnythingMCP los convertirá en endpoints
Paso 3: Configurar la Autenticación
En la configuración del conector, configura la autenticación para tu API. AnythingMCP soporta tokens Bearer, claves API, autenticación básica y OAuth2. Se pueden utilizar variables de entorno para secretos.
Paso 4: Revisar y Personalizar Herramientas
AnythingMCP genera automáticamente herramientas MCP a partir de tus endpoints de API. En el panel de control, puedes revisar cada herramienta, personalizar nombres y descripciones, y elegir qué endpoints exponer u ocultar.
Paso 5: Probar Herramientas en el Panel
Utiliza la interfaz de prueba de herramientas integrada para llamar a cada herramienta directamente desde el panel y verificar las respuestas antes de conectar un agente de IA.
Paso 6: Conectar a Agentes de IA
Configura tu cliente MCP (Claude Desktop, Claude.ai, Cursor, Windsurf, o cualquier agente compatible con MCP) para conectarte a tu servidor AnythingMCP:
{
"mcpServers": {
"my-api": {
"url": "http://localhost:4000/mcp"
}
}
}
Mejores Prácticas
- Comienza con endpoints de solo lectura — Expón primero los endpoints GET, luego añade operaciones de escritura
- Usa nombres significativos — Personaliza los nombres de las herramientas en el panel para mayor claridad
- Añade descripciones — Ayuda a los agentes de IA a entender qué hace cada herramienta
- Limitación de tasa — Configura límites de tasa para proteger tu API
Próximos Pasos
- Guía de SOAP a MCP — Convertir servicios SOAP
- Guía de Base de Datos a MCP — Conectar bases de datos directamente
¿Te ha sido útil esta guía?
