---
title: "Servidor MCP · API e MCP · Agendria"
description: "Conecte o ChatGPT, o Claude e outros assistentes para buscar e agendar com confirmação."
last_updated: 2026-10-10
canonical: "https://agendria.com.br/desenvolvedores/mcp"
---

# Servidor MCP · API e MCP · Agendria

[Desenvolvedores](/desenvolvedores)

[Referência](/desenvolvedores/referencia)

## Conectar

O servidor usa o transporte Streamable HTTP em `https://agendria.com.br/mcp`. Não pede conta nem chave: ele só usa a API pública.

### Claude

1.   Abra os conectores
  No claude.ai, no desktop ou no celular: Configurações, Conectores.
2.   Adicione um conector personalizado
  Cole a URL abaixo e salve.
  URL do servidor
  ```
  `https://agendria.com.br/mcp`
  ```

### ChatGPT

1.   Ative o modo desenvolvedor
  Configurações, Apps e conectores, Configurações avançadas, Modo desenvolvedor.
2.   Crie o conector
  Cole a mesma URL e escolha autenticação: nenhuma.

### Claude Code

Terminal

```
`claude mcp add --transport http agendria https://agendria.com.br/mcp`
```

### Outros clientes (instalação local)

Qualquer cliente MCP que fale stdio pode rodar o servidor localmente.

JSON

```
`{ "mcpServers": { "agendria": { "command": "npx", "args": ["-y", "@agendria/mcp"] } } }`
```

## Ferramentas

| Ferramenta | O que faz |
| --- | --- |
| `search_businesses` | Busca negócios por nome, cidade, segmento ou proximidade. |
| `get_business` | Endereço, horário, profissionais e política de sinal e cancelamento. |
| `list_services` | Serviços, duração, preço e sinal. |
| `check_availability` | Horários livres, em até 14 dias por consulta. |
| `create_booking` | Simula e, só com confirmação do cliente, agenda. |
| `get_booking` | Situação do agendamento e do Pix. |
| `cancel_booking` | Cancela dentro do prazo do negócio. |
| `reschedule_booking` | Remarca para outro horário livre. |

## Confirmação

Chamado sem `confirm`, `create_booking` só simula e devolve um resumo com um `quote_id`. O agendamento acontece numa segunda chamada, com `confirm: true`, o mesmo `quote_id` e os mesmos dados.

O assistente precisa esperar o sim

Mostre o resumo, espere a pessoa confirmar e só então faça a segunda chamada. O `quote_id` vale 15 minutos e repetir a confirmação não duplica a reserva.

- A resposta traz um `booking_token` e o link de gestão. Se houver sinal, traz o Pix copia e cola.
- O `quote_id` do MCP não vale na REST, e o da REST não vale no MCP.
- Serviços de turma, pet, veículo ou com ficha voltam com o link `/agendar` do negócio.

## Limites

| O quê | Limite |
| --- | --- |
| Requisições HTTP | 60 por minuto por IP |
| Leituras | 60 por minuto |
| Simulações | 20 a cada 10 minutos |
| Agendamentos | 5 a cada 10 minutos |
| Cancelar e remarcar | 10 a cada 10 minutos |

## Descoberta

- [/.well-known/ai-catalog.json](https://agendria.com.br/.well-known/ai-catalog.json): catálogo de servidores do domínio.
- `https://agendria.com.br/mcp/server-card`: cartão do servidor.
- [/llms.txt](https://agendria.com.br/llms.txt) e [/llms-full.txt](https://agendria.com.br/llms-full.txt): resumo para modelos de linguagem.

## Sitemap

Veja o [mapa do site](https://agendria.com.br/sitemap.md) com todas as páginas em Markdown.
