Servidor MCP
Ligue o Claude, o Cursor, o Codex ou qualquer cliente MCP aos registos de conformidade de um restaurante com um URL e a sua chave de API.
A BackResto tem um servidor Model Context Protocol em
https://api.backresto.com/mcp. Ligue-lhe a sua ferramenta de IA com a sua
chave de API e pode fazer perguntas sobre os registos de um restaurante na
própria interface da ferramenta: sem código, nada para instalar do nosso lado,
nada para alojar do seu.
Lê através da mesma API Partner que tudo o resto, com a mesma chave. Não consegue ver nada que a chave não pudesse já ver: as concessões por restaurante e por âmbito são aplicadas pela API, não pela ferramenta que ligar.
Ligue a sua ferramenta
Primeiro precisa de uma chave; veja Obter uma chave. Depois, escolha a sua ferramenta:
Escolha a sua ferramenta
Registar o servidor
Abra um terminal e execute este comando, com a sua chave em vez de brp_YOUR_KEY.
shellclaude mcp add --transport http --scope user backresto \ https://api.backresto.com/mcp \ --header "Authorization: Bearer brp_YOUR_KEY"Verificar a ligação
Inicie o Claude Code e escreva /mcp. backresto aparece como ligado, com quatro ferramentas.
Pronto
Pergunte pelas suas entregas por palavras normais. A chave já sabe qual é o seu restaurante.
As ferramentas
Oito ferramentas, agrupadas pelo que leem.
Entregas
| Ferramenta | O que faz |
|---|---|
backresto_list_deliveries | Lista as entregas num intervalo ordenado em milissegundos epoch de no máximo 366 dias. Recebe from, to, e opcionalmente limit (1–100, 50 por omissão) e cursor. |
backresto_get_delivery | Obtém uma entrega pelo seu deliveryId. |
backresto_get_delivery_photos | Mostra as fotografias de uma entrega, cada uma devolvida como uma imagem que o modelo pode ver, com o seu URL pré-assinado. Requer delivery-images:read. |
| Ferramenta | O que faz |
|---|---|
backresto_list_collections | Lista as coleções que foram concedidas a esta chave, com o âmbito que abriu cada uma. É a primeira chamada certa quando não sabe o que a chave alcança. |
backresto_list_records | Lê uma página de registos de uma coleção, marcas de eliminação incluídas. Recebe collection, e opcionalmente limit (1–100, 50 por omissão) e cursor. |
backresto_get_record | Obtém um registo pela collection e pelo recordId. |
backresto_list_record_assets | Lista os ficheiros associados a um registo — cleaning-task-pictures, traceability-labels ou drive-files — como URL assinados. |
Ambas
| Ferramenta | O que faz |
|---|---|
backresto_list_restaurants | Lista os restaurantes que a chave alcança, com os seus âmbitos em cada um. |
restaurantId é opcional em todo o lado. Se o omitir, é usado o restaurante da
chave: um restaurante com uma só chave nunca precisa de conhecer o seu
identificador. Só uma chave que alcança vários restaurantes tem de escolher, e o
erro indica as opções.
As oito estão declaradas como só de leitura e idempotentes, pelo que um cliente bem feito não lhe pede autorização a cada chamada, como faz com uma ferramenta que escreve.
Dois limites práticos. As fotografias são incorporadas para o modelo até dez imagens e cerca de 7,5 MB por resposta; o que passar disso continua a aparecer no resumo, com o seu URL e a razão por que não foi mostrado. E todo o endpoint partilha o orçamento da API de Parceiros de 300 pedidos por minuto por chave — uma chamada de ferramenta é um pedido, número de que uma conversa nunca se aproxima e um ciclo sim.
Proteger a chave
A chave é a totalidade do seu acesso, e a configuração de um cliente MCP é um ficheiro comum num portátil.
- Nunca faça commit desse ficheiro. Se a sua ferramenta guarda a configuração num repositório, faça referência a uma variável de ambiente ou a um cofre de segredos do sistema, como faz a configuração do Codex acima.
- Dê a cada máquina a sua própria chave. Uma chave por portátil significa que um portátil perdido custa uma revogação, não uma rotação em todas as suas integrações.
- Pergunte-nos quando uma chave foi usada pela última vez se suspeitar que ainda há uma cópia ativa algures. Vemos a última autenticação de cada chave, e uma revogação é o mesmo e-mail.
Iniciar sessão com a sua conta BackResto
Algumas ferramentas, como os conectores personalizados do claude.ai, ligam-se enviando-o para uma página de início de sessão em vez de pedirem uma chave. Isso requer um início de sessão OAuth com a sua conta BackResto, que ainda não está disponível. Todas as ferramentas acima funcionam hoje com uma chave. Se o início de sessão é o que o separa de uma integração, diga-nos: sobe na lista.
Em que é bom
Em concreto, com as ferramentas ligadas, um responsável de operações pode perguntar:
- «Que entregas foram recusadas no mês passado, e porquê?»
- «Mostra-me todas as entregas de frango acima de 4 °C neste trimestre.»
- «Mostra-me as fotos da entrega recusada na terça-feira: vê-se o dano?»
- «Que frigoríficos saíram de intervalo mais vezes, e em que zona?»
- «Os ciclos de arrefecimento desceram todos a tempo na semana passada?»
- «Que tarefas de limpeza ficaram por fazer, e quais não têm fotografia?»
As três primeiras leem entregas; as restantes leem coleções, e apenas aquelas que foram concedidas à sua chave. As respostas vêm dos mesmos registos que um inspetor leria, através das mesmas concessões que o restaurante emitiu.
A um modelo que lê coleções deve ser dito o que está a ler: um instantâneo daquilo que a API recebeu, não um histórico com completude garantida. Se puser isto à frente de um cliente, ponha essa frase ao lado.