Caja de arena API MCP

Las pruebas de API tienen excelentes herramientas GUI, y ninguna de ellas está donde los desarrolladores trabajan cada vez más: dentro de un asistente de IA. Copiar URLs y tokens entre una ventana de chat y Postman rompe el flujo que hace que los asistentes sean productivos en primer lugar.

API Sandbox MCP cierra esa brecha. Es un servidor de Model Context Protocol, publicado en npm, que expone 42 herramientas que cubren todo el ciclo de vida de pruebas de API: gestión de entornos, solicitudes HTTP, colecciones guardadas, exploración de especificaciones OpenAPI, generación de datos simulados, flujos de varios pasos, aserciones, ejecuciones masivas de pruebas y pruebas de carga. El asistente se convierte en el cliente de la API: "iniciar sesión en staging, usar el token para obtener mi perfil y verificar la forma de la respuesta" es una sola oración, no una sesión cambiando de herramienta.

El problema del token, resuelto por un formato

Las respuestas de la API consumen muchos tokens: un solo cuerpo JSON extenso puede agotar una conversación. El servidor responde con dos mecanismos. TOON (Token-Oriented Object Notation), una salida predeterminada compacta inspirada en YAML que elimina la puntuación de JSON y ahorra aproximadamente un 40% de tokens por respuesta. Y niveles de verbosidad en cada solicitud: minimal elimina encabezados y trunca cuerpos (~95% de ahorro), normal filtra encabezados innecesarios y limita el tamaño del cuerpo (~75%), mientras que la respuesta completa sin truncar siempre se almacena en caché y se puede recuperar por call_id; no se requiere reenvío.

Diseñar herramientas para un LLM es un ejercicio de presupuesto de tokens: cada byte de respuesta compite con el razonamiento que el modelo podría estar haciendo en su lugar.

Las variables fluyen a través de todo

Los entornos son conjuntos de variables JSON con nombre almacenados en el directorio de inicio del usuario. Cada herramienta HTTP resuelve los marcadores {{variable}} según el entorno activo, y las URL relativas se resuelven contra BASE_URL, por lo que una solicitud guardada escrita una vez se ejecuta en cualquier entorno. Los grupos vinculan los entornos a rutas de directorios: al entrar en una carpeta de proyecto, su entorno predeterminado se activa automáticamente.

Flujos: pruebas de múltiples pasos en una sola llamada

La herramienta flow_run ejecuta una secuencia ordenada de solicitudes donde cada paso puede extraer valores de su cuerpo de respuesta mediante la ruta de puntos y pasarlos adelante como variables: el patrón canónico de iniciar sesión y luego usar el token:

{
  "steps": [
    {
      "name": "inicio_de_sesión",
      "method": "POST",
      "url": "{{BASE_URL}}/auth/login",
      "body": { "email": "test@example.com", "password": "..." },
      "extract": { "TOKEN": "token", "USER_ID": "user.id" }
    },
    {
      "name": "obtener_perfil",
      "method": "GET",
      "url": "{{BASE_URL}}/users/{{USER_ID}}",
      "headers": { "Authorization": "Bearer {{TOKEN}}" }
    }
  ]
}

Las variables se acumulan a lo largo de los pasos; un 5xx detiene el flujo mientras que un 4xx permite que continúe, coincidiendo con cómo un probador humano realmente reacciona a los fallos. Cada paso informa sobre el estado, el tiempo y lo que se extrajo.

Las especificaciones hacen que el asistente sea un experto en tu API

api_import obtiene una especificación OpenAPI 3.x desde una URL o un archivo y resuelve recursivamente cada $ref, allOf, oneOf y anyOf en el momento de la importación. A partir de entonces, el asistente puede listar los endpoints filtrados por etiqueta o método, profundizar en el detalle completo de parámetros y esquemas, y generar cuerpos de solicitud simulados correctamente tipados, respetando correos electrónicos, UUIDs, marcas de tiempo y enumeraciones. Importa la especificación de Petstore y "agregar una mascota con datos realistas" se convierte en una conversación de dos herramientas.

Todo es reversible: las colecciones y los entornos se exportan a archivos de proyecto portátiles y al formato Postman v2.1, y se importan de la misma manera. Tu conjunto de pruebas nunca queda atrapado dentro de la herramienta.