Documentação
Testar a conexão MCP
Roteiro de prompts para confirmar autorização, marcas, permissões, documentação, paginação e relatórios logo depois de conectar o MCP.
Depois de conectar o MCP, use esta página para confirmar que a conexão está correta antes de depender dela. Todos os testes abaixo são somente leitura, exceto o último, que é opcional.
Comece uma conversa nova
Depois de autorizar, abra uma nova conversa ou sessão no cliente de IA. Alguns clientes só carregam as ferramentas do MCP em conversas iniciadas depois da conexão.
Teste rápido: tudo em um prompt
Cole este prompt para validar a conexão em uma única resposta. Ele não altera dados.
Validar a conexão MCP da Takeat
Quero validar minha conexão MCP com a Takeat. Faça somente consultas, sem
alterar nenhum dado, e responda em português.
1. Use get_restaurant_context e me diga: o restaurant_id, as marcas
autorizadas (id e nome) e a lista de permissões (scopes) desta conexão.
Se houver mais de uma loja, use list_restaurants antes e me pergunte qual
testar.
2. Sem consultar dados do restaurante, use search_documentation para achar a
página sobre paginação da Nova API V1.0 e resuma em duas frases, citando
a URL.
3. Use get_menu com channel=delivery e me diga quantos produtos vieram na
primeira página e se pagination.has_more é true ou false.
4. Use get_table_sessions para os últimos 7 dias. Percorra pagination.next até
has_more=false e me diga quantas comandas existem e quantas páginas foram
lidas.
5. Se a permissão reports:payments:read estiver na lista do passo 1, use
get_payments_report com report=overview para o mês passado. Senão, diga
que a permissão não foi concedida e pule este passo.
Ao final, monte uma tabela com: passo, ferramenta usada, resultado e
OK/Falha. Se alguma ferramenta falhar, copie a mensagem de erro exata, sem
inventar a causa.Como ler o resultado
| Passo | Resultado esperado | Se falhar |
|---|---|---|
| 1. Contexto | Restaurante e marcas que você escolheu no consentimento, mais as permissões aprovadas. | 401: reconecte o cliente. Marcas faltando: faça uma nova autorização escolhendo as marcas. |
| 2. Documentação | Resumo citando docs.takeat.app, sem chamar ferramentas de dados. | Se a IA chamou get_menu ou outra ferramenta de dados, ela confundiu as intenções: repita deixando claro “sem consultar dados”. |
| 3. Cardápio | Contagem de produtos e has_more. Um cardápio vazio também é resposta válida. | menu:read é exigido por toda a conexão MCP: sem ele, nenhuma ferramenta responde (403). Reconecte e aprove a permissão. |
| 4. Comandas | Total de comandas e número de páginas. | Se a IA parou na primeira página sem avisar, peça que continue com pagination.next. |
| 5. Relatório | Faturamento do mês e comparação, ou aviso de permissão ausente. | Conexões antigas não recebem permissões de relatórios: reconecte e aprove. |
Testes individuais
Use os prompts abaixo para investigar um ponto específico.
Permissões e marcas
Liste as permissões (scopes) desta conexão MCP e, para cada uma, diga quais
ferramentas da Takeat ela libera. Não consulte dados além de
get_restaurant_context.Uma permissão que você esperava e não aparece não é ganha ao atualizar o servidor nem ao renovar o token. Reconecte o cliente e aprove a permissão no consentimento.
Marca não autorizada
Consulte get_products usando brand_ids com um ID de marca que NÃO está em
get_restaurant_context. Mostre a mensagem de erro exata.O esperado é uma recusa com a mensagem “Uma ou mais marcas não estão
autorizadas nesta conexão.” Se a consulta retornar dados, informe o suporte com
o X-Error-Id ou o horário da chamada.
Documentação sem dados
Quero criar um app que lê o cardápio de delivery da Takeat. Sem consultar
dados do meu restaurante, use a documentação para dizer qual endpoint usar,
qual escopo pedir e como paginar. Cite as URLs .md.A resposta deve citar GET /v1/menu, o escopo menu:read e a página de
paginação, sem chamar ferramentas de dados.
Multilojas
Use list_restaurants e me mostre as lojas autorizadas. Depois, para cada loja,
use get_restaurant_context com o restaurant_id dela e compare as marcas.O assistente nunca deve escolher automaticamente a primeira loja. Veja integrações para multilojas.
Teste de escrita (opcional)
Só faça este teste se a conexão tiver uma permissão de escrita, como
products:write, e em um item que você pode alterar sem prejudicar a operação.
Escritas alteram dados reais
Não existe ambiente de teste no MCP. A alteração aparece no cardápio do restaurante imediatamente. Escolha um produto de teste e desfaça a mudança ao final.
Quero testar uma alteração controlada. Use get_products para achar o produto
chamado "[NOME DE UM PRODUTO DE TESTE]" e me mostre id, marca e
disponibilidade atual no delivery. NÃO altere nada ainda.
Depois que eu confirmar, use set_product_availability para deixá-lo
indisponível no delivery, consulte de novo para confirmar a mudança e então
restaure o valor original. Mostre o antes e o depois.O assistente deve pedir confirmação antes de gravar. Se o cliente mostrar as ferramentas de escrita mas a conexão não tiver a permissão, o esperado é “Permissão necessária ausente: products:write”.
Se algo não funcionar
Veja a tabela de erros em Conecte a Takeat à sua IA. Ao pedir ajuda ao suporte, informe o cliente de IA usado, o horário, o nome da ferramenta e a mensagem de erro. Nunca envie tokens ou capturas de tela com credenciais.