MCP Playground: ejecuta los tools de tus agentes en vivo, desde la documentación
La semana pasada convertimos los tools MCP en un API Contract de primera clase: apunta Archyl a un servidor MCP en vivo y descubre cada tool y su esquema de entrada, documentado y vinculado a tu modelo C4 como cualquier contrato REST o GraphQL.
Eso respondía a la primera pregunta: ¿qué pueden hacer mis agentes?
Hoy respondemos a la segunda: ¿realmente hace eso?
Te presentamos el MCP Playground: una nueva pestaña en cada contrato MCP en vivo que te permite invocar cualquier tool contra el servidor real e inspeccionar el resultado real. Sin configurar un cliente, sin JSON-RPC a mano, sin salir de tu documentación de arquitectura.
Del esquema al formulario, automáticamente
Abre un contrato MCP en vivo y encontrarás una pestaña Playground junto al esquema. Elige un tool de la lista — la misma lista con buscador que documentaste — y Archyl convierte su inputSchema en un formulario:
- Strings, números y booleanos se convierten en campos tipados.
- Los enums se convierten en desplegables con los valores permitidos.
- Los parámetros obligatorios están marcados y se validan antes de enviar nada.
- Los objetos anidados y arrays tienen un campo JSON en bruto, validado al enviar.
Rellénalo, pulsa Ejecutar tool, y el resultado vuelve con su duración — renderizado como un resultado merece serlo. La vista Formateado muestra la respuesta como JSON limpio e indentado. La vista Árbol hace navegables las payloads grandes: colapsa lo que no te interesa, expande lo que sí. Texto, imágenes y recursos devueltos por un tool se renderizan de forma nativa.
Si el tool devuelve un error, ves exactamente lo que vería un agente: el flag de error y la payload, mostrados en rojo, nunca silenciados.
Tu token nunca sale de tu navegador
El Playground sigue el mismo modelo de seguridad que el descubrimiento en vivo, y vale la pena repetirlo porque es la clave de todo:
Cada llamada se ejecuta desde tu navegador. Cuando pulsas Ejecutar tool, tu navegador habla directamente con tu servidor MCP. El backend de Archyl no está en el camino.
- El token nunca se almacena. Lo introduces para la sesión; vive en la página y en ningún otro sitio.
- Los resultados nunca se persisten. Lo que vuelve se renderiza, se lee, y desaparece al cerrar la pestaña.
- Sin acceso del lado servidor a tu red. Como la petición sale de tu máquina, el playground alcanza
localhosty servidores privados — y no existe ninguna ruta de petición del lado servidor que abusar.
El único compromiso, como con el descubrimiento, es CORS: el servidor de destino debe permitir el origen de Archyl. Para los servidores que controlas, es una línea de configuración.
Por qué importa
Los tools MCP son la interfaz que tus agentes de IA usan de verdad. Hasta ahora, comprobar uno significaba montar un cliente, fabricar un sobre JSON-RPC, o simplemente… confiar en la descripción.
Ahora la documentación es el banco de pruebas:
- ¿Revisas la superficie de un agente? Ejecuta los tools y ve las formas reales, no las descritas.
- ¿Depuras por qué falló la llamada de un agente? Reprodúcela en dos clics con exactamente los mismos argumentos.
- ¿Incorporas a alguien a un servicio? Envíale el contrato: puede leer cada tool y probarlo.
Esto es lo que entendemos por documentación viva. Una spec que puede ejecutarse no deriva en silencio; queda al descubierto en el momento en que miente.
Dogfooding, como siempre
Archyl es en sí mismo un servidor MCP — 181 tools esta semana. El primer usuario del Playground fue nuestro propio contrato: ejecutamos list_projects, get_project_c4_model y compañía contra nuestro propio endpoint, desde nuestra propia documentación, todos los días. La captura de arriba es exactamente eso.
Pruébalo
Abre un proyecto → API Contracts → cualquier contrato MCP con endpoint en vivo → Playground. Introduce tu token, elige un tool, ejecútalo.
Tu documentación de arquitectura acaba de aprender a ejecutarse.