Takeat
Versão da documentação
Prompts

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.

Prompt pronto para usar

Validar a conexão MCP da Takeat

Copie e adapte
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.
Revise o contexto antes de enviar e nunca inclua credenciais reais.

Como ler o resultado

PassoResultado esperadoSe falhar
1. ContextoRestaurante 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çãoResumo 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ápioContagem 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. ComandasTotal 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órioFaturamento 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.

On this page