Resumen
MCP presenta el catálogo público de OiAir mediante cinco herramientas de lectura. Ninguna envía mensajes, crea solicitudes ni reserva plazas.
Este servidor público no requiere autenticación. No permite gestionar organizaciones, inscripciones ni datos personales.
Conectar un cliente
En un cliente compatible con servidores MCP remotos, añade la dirección siguiente y selecciona Streamable HTTP. La compatibilidad y la configuración dependen del cliente.
Claude Code
Añade el servidor en el terminal. Después, usa /mcp en Claude Code para comprobar la conexión.
claude mcp add --transport http oiair https://oiair.com.br/api/mcpMCP Inspector
Para comprobar la conexión sin un agente, enumera las herramientas con el cliente oficial de diagnóstico.
npx @modelcontextprotocol/inspector --cli \
'https://oiair.com.br/api/mcp' --transport http \
--method tools/listHerramientas disponibles
| Función | Entradas principales |
|---|---|
search_activitiesBusca actividades con texto, filtros y cursor. | query, filters, locale, limit, cursor |
get_organizationConsulta la ficha pública de la organización. | organizationId, locale |
list_offeringsEnumera las publicaciones actuales de la organización. | organizationId, locale |
get_offeringConsulta el grupo exacto; puede verificar una versión esperada. | publicationId, expectedVersion?, locale |
get_booking_linkGenera el enlace al formulario para la organización, publicación y versión exactas. | organizationId, publicationId, expectedVersion, visit? |
get_booking_link requiere expectedVersion; visit acepta trial o regular. Utiliza la versión devuelta por la publicación. Si ha cambiado, consúltala de nuevo antes de generar el enlace.
De la búsqueda al formulario
Busca actividades
Usa search_activities con la edad, la ciudad y las preferencias familiares.
Comprueba el grupo
Usa get_offering para consultar la dirección, horarios, precios y versión de la publicación elegida.
Abre el formulario
Usa get_booking_link con organizationId, publicationId y expectedVersion. La familia revisa las condiciones y envía la solicitud en OiAir.
El cliente inicializa MCP y envía tools/call. Este ejemplo muestra el cuerpo de la llamada tras conectar.
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "search_activities",
"arguments": {
"query": "desenho",
"locale": "es",
"filters": {
"city": "Florianópolis",
"age": 6
},
"limit": 5
}
}
}El formulario OiAir envía una solicitud a la organización. El envío no reserva una plaza. Esta conexión de lectura no envía solicitudes ni confirma inscripciones.
Alcance de la conexión
- Usa los datos devueltos por el servidor. No deduzcas plazas disponibles a partir del horario publicado.
- Muestra los filtros aplicados y unresolvedConstraints. Los resultados son una selección ordenada; respeta resultScope, nextCursor y la vigencia de los datos.
- No incluyas nombres, teléfonos ni otros datos personales en las búsquedas.
- El cliente debe conectar el servidor para usar las herramientas. Un endpoint no publica OiAir automáticamente en directorios de terceros.
- Las herramientas devuelven texto y datos estructurados. Las interfaces visuales dentro del chat dependen del cliente y no son necesarias para esta conexión.
Integración y versiones
Consulta ejemplos de conexión y el historial de versiones en GitHub. Revisa los metadatos del servidor en MCP Registry.
Siguiente paso
¿Necesitas una integración directa en tu aplicación? Consulta los endpoints y el contrato de la API.