Documentação
Prompts
Todos os prompts oficiais da Takeat em um só lugar: testar o MCP, consultar dados, criar, integrar ou migrar uma aplicação.
Esta seção reúne os prompts oficiais para usar com assistentes de IA e agentes de código. Cada página explica quando usar o prompt, o que preparar antes de colar e o que esperar da resposta.
Escolha pelo que você quer fazer
| Você quer… | Prompt | Precisa do MCP? |
|---|---|---|
| Confirmar que a conexão MCP funciona logo depois de conectar | Testar a conexão MCP | Sim |
| Fazer perguntas sobre vendas, cardápio, estoque, financeiro ou clientes | Consultar dados com o MCP | Sim |
| Criar uma aplicação do zero | Criar uma aplicação nova | Recomendado |
| Adicionar a Takeat a um projeto que já funciona | Integrar uma aplicação existente | Recomendado |
Sair do API Legado (webhook.takeat.app) | Migrar do API Legado | Recomendado |
| Implementar a troca e a renovação de tokens da API Key | Implementar access e refresh tokens | Opcional |
| Especificar um app instalável na Takeat Store | Apps para a Takeat Store | Opcional |
“Recomendado” significa que o agente trabalha melhor com o MCP conectado, porque
pode pesquisar os contratos com search_documentation e get_documentation_page
sem sair da conversa. Sem o MCP, todos os prompts de desenvolvimento funcionam
com o índice /llms.txt e as páginas Markdown.
Dois tipos de prompt
Usar a Takeat pela IA
Perguntas feitas a um assistente conectado ao MCP. A IA consulta os dados do restaurante que você autorizou e responde na conversa. Nenhum código é criado.
Construir com a Takeat
Instruções para um agente de código (Claude Code, Codex, Cursor…) criar, integrar ou migrar uma aplicação. A IA lê a documentação, não os dados.
O MCP separa as duas intenções: para dados, começa por get_restaurant_context;
para desenvolvimento, usa as ferramentas de documentação. Se o pedido for
ambíguo, o assistente deve perguntar antes de agir.
Prompt embutido no MCP
Além dos prompts desta seção, o servidor MCP publica o prompt
build_takeat_integration (“Planejar uma integração Takeat”). Ele recebe:
| Argumento | Obrigatório | Descrição |
|---|---|---|
goal | Sim | Objetivo da integração, em texto livre. |
language | Não | Stack principal. Padrão: TypeScript. |
Clientes que listam prompts MCP o mostram como comando. No Claude Code, por
exemplo, digite / e procure build_takeat_integration no servidor takeat.
Ele orienta o agente a pesquisar os contratos antes de decidir, escolher entre
API Key e OAuth com PKCE e não consultar dados do restaurante sem pedido
explícito. Para um projeto completo, prefira os prompts desta seção, que são
mais detalhados.
Regras que valem para todos
- Nunca cole credenciais. API key, token, código OAuth,
code_verifier, senha, cookie ou headerAuthorizationnão entram no prompt. Os prompts pedem ao agente que indique onde você deve colocar cada valor. - Troque só os trechos entre colchetes, como
[NOME DO PRODUTO]. Eles descrevem o seu caso; o restante protege segurança e contratos. - Contratos são a fonte da verdade. Se o agente citar um endpoint, campo ou
escopo que não está na referência, peça a URL
.mdque sustenta a afirmação. - Dados reais exigem cuidado. Uma chave
tk_test_não cria sandbox, e as ferramentas de escrita do MCP alteram o restaurante de verdade.