Visão geral
O MCP apresenta o catálogo público do OiAir como cinco ferramentas de leitura. Nenhuma ferramenta envia mensagens, registra pedidos ou reserva vagas.
Este servidor público não exige autenticação. Ele não dá acesso à gestão da organização, a inscrições ou a dados pessoais.
Conectar um cliente
No cliente que aceita servidores MCP remotos, adicione o endereço abaixo e escolha Streamable HTTP. O suporte e o caminho de configuração dependem do cliente.
Claude Code
No terminal, adicione o servidor. Depois, use /mcp no Claude Code para verificar a conexão.
claude mcp add --transport http oiair https://oiair.com.br/api/mcpMCP Inspector
Para conferir a conexão sem um agente, liste as ferramentas pelo cliente oficial de diagnóstico.
npx @modelcontextprotocol/inspector --cli \
'https://oiair.com.br/api/mcp' --transport http \
--method tools/listFerramentas disponíveis
| Função | Entrada principal |
|---|---|
search_activitiesBusca atividades com texto, filtros e cursor. | query, filters, locale, limit, cursor |
get_organizationLê a ficha pública da organização. | organizationId, locale |
list_offeringsLista as publicações atuais da organização. | organizationId, locale |
get_offeringLê a turma exata; pode conferir uma versão esperada. | publicationId, expectedVersion?, locale |
get_booking_linkGera o link do formulário para a organização, publicação e versão exatas. | organizationId, publicationId, expectedVersion, visit? |
Em get_booking_link, expectedVersion é obrigatório; visit aceita trial ou regular. Use a versão retornada pela publicação. Se a publicação mudou, consulte-a novamente antes de gerar o link.
Da busca ao formulário
Encontre atividades
Use search_activities com a idade, a cidade e as preferências da família.
Confira a turma
Use get_offering para ler o endereço, os horários, os preços e a versão da publicação escolhida.
Abra o formulário
Use get_booking_link com organizationId, publicationId e expectedVersion. A família revisa as condições e envia o pedido no OiAir.
O cliente faz a inicialização MCP e envia tools/call. Este exemplo mostra o corpo da chamada após a conexão.
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "search_activities",
"arguments": {
"query": "desenho",
"locale": "pt-BR",
"filters": {
"city": "Florianópolis",
"age": 6
},
"limit": 5
}
}
}O formulário OiAir envia uma solicitação à organização. Seu envio não reserva uma vaga. Esta conexão de leitura não envia solicitações nem confirma inscrições.
Limites da conexão
- Use os dados retornados pelo servidor. Não deduza vaga disponível a partir do horário publicado.
- Mostre os critérios aplicados e unresolvedConstraints. Os resultados são uma seleção ordenada; respeite resultScope, nextCursor e a validade dos dados.
- Não inclua nomes, telefones ou outros dados pessoais na consulta de busca.
- O cliente deve conectar o servidor para usar as ferramentas. A existência do endpoint não publica o OiAir automaticamente em diretórios de terceiros.
- As ferramentas retornam conteúdo de texto e dados estruturados. Interfaces visuais dentro do chat dependem do suporte do cliente e não são exigidas para esta conexão.
Integração e versões
Veja exemplos de conexão e o histórico de versões no GitHub. Consulte os metadados do servidor no MCP Registry.
Próximo passo
Precisa integrar diretamente em seu aplicativo? Consulte os endpoints e o contrato da API.