Convertir una API REST en herramientas
Convierta endpoints externos en herramientas invocables.
Convertir una API REST en herramientas es una lección gratuita de MCP Academy en CoddyKit. Esta es la lección 2 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de MCP Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de MCP Academy incluye 4 lecciones en total.
Convertir endpoints en herramientas
Cualquier API REST puede convertirse en tools de MCP. Cada endpoint se convierte en una función invocable que el modelo puede usar para obtener o enviar datos. 🌐
Llamar a HTTP desde una herramienta
Dentro de una herramienta realiza una solicitud HTTP normal y, después, devuelve la respuesta como texto que el modelo pueda leer y sobre el que pueda razonar.
Preferir un cliente asíncrono
Use un cliente asíncrono como httpx para que una llamada lenta a una API no bloquee otras solicitudes mientras espera a la red.
import httpx
async with httpx.AsyncClient() as client:
r = await client.get(url)Asignar parámetros a argumentos
Exponga la consulta del endpoint como arguments de la herramienta. El modelo proporciona una ciudad o un id, y usted lo incorpora de forma segura a la solicitud.
@mcp.tool()
async def get_weather(city: str) -> str:
...Mantener los secretos en el servidor
Guarde la key de la API en el entorno del servidor, nunca como argumento de una herramienta. El modelo no debería ver ni enviar nunca credenciales.
key = os.environ["WEATHER_API_KEY"]Comprobar el código de estado
Inspeccione el status HTTP antes de confiar en el cuerpo. Un 404 o 500 significa que debe informar de un error claro, no de datos basura.
r.raise_for_status()Analizar y recortar el JSON
La mayoría de las API devuelven JSON. Analícelo y devuelva únicamente los fields que necesita la tarea, para no inundar el modelo con información innecesaria.
data = r.json()
return data["temp_c"]Dar a cada herramienta una sola función
Asigne un endpoint a una herramienta específica con un nombre claro. Las herramientas granular son más fáciles de elegir correctamente para el modelo.
Escribir descripciones útiles
Describa qué hace el endpoint y cuándo debe utilizarse. Una description precisa es lo que permite al modelo saber que debe llamar a esta herramienta.
Gestionar fallos de red
Envuelva la llamada para que un tiempo de espera agotado o una desconexión devuelva un mensaje de error legible en lugar de bloquear todo el servidor.
Establecer tiempos de espera razonables
Pase siempre un timeout para que un servicio ascendente bloqueado no congele su herramienta indefinidamente esperando una respuesta que nunca llega.
r = await client.get(url, timeout=10.0)Comprobación rápida
¿Dónde debe almacenarse una clave de API?
Resumen: REST como herramientas
Ha envuelto endpoints como herramientas async: argumentos de entrada, claves en el servidor, comprobaciones de estado y JSON recortado como salida. A continuación, agrupará conexiones. 🎯
Preguntas frecuentes
¿La lección «Convertir una API REST en herramientas» es gratis?
Sí — el texto completo de «Convertir una API REST en herramientas» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de MCP Academy, actualiza a CoddyKit PRO. El curso de MCP Academy incluye 4 lecciones en total.
¿Qué aprenderé en «Convertir una API REST en herramientas»?
Convierta endpoints externos en herramientas invocables. Practicas MCP Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar MCP Academy?
No se requiere experiencia previa. MCP Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 2 de 4.
¿Cuánto tiempo toma la lección «Convertir una API REST en herramientas»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de MCP Academy?
Sí. Cada lección de MCP Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Exponer consultas SQL de forma segura
- Convertir una API REST en herramientas
- Agrupar conexiones durante el ciclo de vida
- Almacenar en caché y limitar la velocidad de los upstream