Cloud/Conectores/Playground

Playground

Pergunte à IA sobre a Vinkius

A aba onde um conector deixa de ser configuração e vira algo que você pode cutucar: o MCP Playground, embutido no conector, rodando suas AI Capabilities ao vivo pelo navegador com respostas reais.

O Playground é a aba onde um conector deixa de ser uma lista de configurações e vira algo que você pode de fato usar. É o MCP Playground, embutido direto no conector: cole uma Connector URL (ou abra pelo próprio conector) e toda AI Capability que o conector expõe vira uma ferramenta que você pode rodar pelo navegador, com a resposta ao vivo de volta para você. Depois do Dashboard para observá-lo, das Credentials para identificá-lo, dos Connection Tokens para distribuir chaves e das AI Capabilities para decidir o que está ligado, o Playground é onde você prova que as capacidades realmente funcionam antes que sua IA as chame.

R

Playground

Test this connector live in the MCP Playground.

Connected
GitHub

list_issues

read-only

List issues in a GitHub repository, filtered by state.

Parameters

Configure tool inputs

owner*string
repo*string
stateenum

On the free plan the Playground shows an Upgrade plan card; with a credentialed connector it connects on its own. Configure credentials first or it stays on Setup required.

Playground, live. The connector wired straight into the MCP Playground: search the tools, open list_issues, run it and watch the JSON response land with the call counted in Session metrics and Execution history on the right.

O mockup é o workspace ao vivo e conectado. Busque as ferramentas, abra list_issues, preencha owner e repo e clique em Run tool: a resposta JSON cai no painel de resultado e a chamada é contada nas métricas de Session e no Execution history à direita.

Como ele abre

O Playground não é para todo mundo de graça, e não fica aberto antes do setup. Duas barreiras ficam no caminho, e o console mostra cada uma claramente:

  • Plano pago obrigatório. No plano free a aba é um card, não um workspace: um ícone de frasco, o nome do conector, a linha "Test this Connector's AI capabilities live, right from your browser.", um botão Upgrade plan com cadeado, e a nota de que o Playground roda conectores ao vivo com um connection token válido, disponível nos planos pagos.
  • Credenciais obrigatórias. Se o conector tem um credential schema que ainda não foi configurado, a aba fica bloqueada com um cadeado, o título "Setup required" e um botão que leva direto para a aba Credentials.

Em um plano pago com credenciais já configuradas, o conector é dono do Playground e se conecta sozinho no momento em que você abre a aba: sem URL para colar, sem token para copiar. O card que você via no plano free simplesmente vira o workspace ao vivo abaixo.

O workspace, uma vez conectado

Uma barra de status fica no topo de tudo que você faz. Um ponto verde Connected, o nome do conector, a versão dele e o host em que está rodando, a contagem de ferramentas ao vivo e um botão Disconnect. Disconnect derruba a sessão ao vivo; o conector é dono do playground, então nada sobrevive à view. Abaixo ficam três painéis.

Escolha uma ferramenta

O painel esquerdo é a lista de ferramentas, cada capacidade que o conector expõe. Digite na busca e ele filtra por nome e descrição enquanto você digita, exatamente como no console. Cada linha carrega um número de índice, o nome da ferramenta em monoespaçado e uma descrição de uma linha, mais um pontinho se você já rodou aquela ferramenta: verde para sucesso, vermelho para erro. Abra uma ferramenta e o painel central preenche com ela.

Leia suas capacidades

O painel central abre no cabeçalho da ferramenta: o nome, os selos de anotação que o conector publicou para ela, e a descrição. read-only (verde) significa que a ferramenta só lê, destructive (vermelho) significa que ela escreve ou muda algo, idempotent (azul) significa que repetir é seguro. Abaixo, o formulário de Parameters é montado a partir do schema da própria ferramenta: uma caixa de texto para strings, um campo numérico para inteiros e decimais, botões-pílula para enums, um switch para booleans, e um asterisco obrigatório nos campos que a ferramenta exige. Passe o mouse no ícone de ajuda ao lado de qualquer campo para ver a descrição dele.

Veja a resposta ao vivo

Clique em Run tool e o console invoca a capacidade contra o conector real. Enquanto roda você vê o spinner; quando retorna, o painel de resultado mostra um selo de success e a resposta bruta em um visualizador JSON que você pode copiar para a área de transferência. Se um campo obrigatório estiver vazio, o formulário avisa "This field is required." e não roda até você preencher.

A sessão num relance

O rail direito guarda duas coisas para toda a sessão: as métricas de Session e o Execution history.

  • Session são quatro números: Calls (quantas vezes você rodou uma ferramenta), Success rate, Errors e Avg latency. A taxa de sucesso começa boa e fica âmbar se os erros aparecerem; os erros ficam mudos até que haja um para mostrar.
  • O Execution history é cada execução que você fez nesta sessão: um ícone para sucesso ou erro, o nome da ferramenta, um resumo curto dos argumentos passados, a duração em milissegundos e há quanto tempo. Clique em qualquer linha para rodar de novo, ou limpe a lista toda com o botão de lixeira.

Por que esta tela existe

Seus agentes vão chamar essas ferramentas às 2 da manhã sem ninguém olhando. O Playground é o lugar para descobrir, ao meio-dia, que create_pr_comment escreve no repositório errado ou que list_issues precisa de um estado que você esqueceu. Você testa a capacidade no navegador, lê a resposta real, e só então deixa sua IA chegar perto, e como as skills que você silencia em AI Capabilities nunca aparecem aqui, o playground e o perímetro se movem juntos. As abas restantes cobrem o resto da construção: publicar mudanças, o registro do que rodou, e o lado de negócio do conector.

O que vem a seguir

O conector ainda tem abas para cobrir: Deployments para publicar mudanças, Audit Logs e Log Streaming para o registro, e Settings e Monetize para o negócio. Cada uma ganha sua própria página de docs, uma de cada vez, na ordem do próprio console.