MCP Playground: execute os tools dos seus agentes ao vivo, direto da documentação
Na semana passada, tornamos os tools MCP um API Contract de primeira classe: aponte o Archyl para um servidor MCP ativo e ele descobre cada tool e seu schema de entrada, documentado e vinculado ao seu modelo C4 como qualquer contrato REST ou GraphQL.
Isso respondia à primeira pergunta: o que meus agentes podem fazer?
Hoje respondemos à segunda: isso realmente faz o que diz?
Conheça o MCP Playground — uma nova aba em cada contrato MCP ao vivo que permite invocar qualquer tool contra o servidor real e inspecionar o resultado real. Sem configurar cliente, sem JSON-RPC na mão, sem sair da sua documentação de arquitetura.
Do schema ao formulário, automaticamente
Abra um contrato MCP ao vivo e você encontrará uma aba Playground ao lado do schema. Escolha um tool da lista — a mesma lista pesquisável que você documentou — e o Archyl transforma o inputSchema em um formulário:
- Strings, números e booleanos viram campos tipados.
- Enums viram dropdowns com os valores permitidos.
- Parâmetros obrigatórios são marcados e validados antes de qualquer envio.
- Objetos aninhados e arrays ganham um campo JSON bruto, validado no envio.
Preencha, clique em Executar tool, e o resultado volta com sua duração — renderizado como um resultado merece. A visão Formatado mostra a resposta como JSON limpo e indentado. A visão Árvore torna payloads grandes navegáveis: recolha o que não interessa, expanda o que importa. Texto, imagens e recursos retornados por um tool são renderizados nativamente.
Se o tool retornar um erro, você vê exatamente o que um agente veria — a flag de erro e a payload, exibidas em vermelho, nunca engolidas.
Seu token nunca sai do seu navegador
O Playground segue o mesmo modelo de segurança da descoberta ao vivo, e vale repetir porque esse é o ponto central:
Cada chamada roda do seu navegador. Quando você clica em Executar tool, seu navegador fala diretamente com o seu servidor MCP. O backend do Archyl não está no caminho.
- O token nunca é armazenado. Você o digita para a sessão; ele vive na página e em nenhum outro lugar.
- Os resultados nunca são persistidos. O que volta é renderizado, lido, e some quando você fecha a aba.
- Nenhum acesso do lado do servidor à sua rede. Como a requisição parte da sua máquina, o playground alcança
localhoste servidores privados — e não existe caminho de requisição do lado do servidor para abusar.
O único trade-off, como na descoberta, é o CORS: o servidor de destino precisa permitir a origin do Archyl. Para servidores que você controla, é uma linha de configuração.
Por que isso importa
Tools MCP são a interface que seus agentes de IA realmente usam. Até agora, verificar um significava montar um cliente, construir um envelope JSON-RPC, ou simplesmente… confiar na descrição.
Agora a documentação é a bancada de testes:
- Revisando a superfície de um agente? Execute os tools e veja as formas reais, não as descritas.
- Debugando por que a chamada de um agente falhou? Reproduza em dois cliques com exatamente os mesmos argumentos.
- Fazendo onboarding de alguém em um serviço? Envie o contrato — dá para ler cada tool e experimentá-lo.
É isso que chamamos de documentação viva. Uma spec que pode ser executada não deriva em silêncio; é flagrada no momento em que mente.
Dogfooding, como sempre
O Archyl é ele mesmo um servidor MCP — 181 tools nesta semana. O primeiro usuário do Playground foi o nosso próprio contrato: executamos list_projects, get_project_c4_model e companhia contra o nosso próprio endpoint, da nossa própria documentação, todos os dias. O screenshot acima é exatamente isso.
Experimente
Abra um projeto → API Contracts → qualquer contrato MCP com endpoint ao vivo → Playground. Digite seu token, escolha um tool, execute.
Sua documentação de arquitetura acabou de aprender a se executar.