Добавить организациюДобавить

ДЛЯ РАЗРАБОТЧИКОВ

OiAir для ИИ-агентов

Дайте агенту доступ к поиску, организациям и опубликованным группам OiAir. Открывайте форму семьи с точно выбранной группой.

Публичные данныеТолько чтениеStreamable HTTP
Эндпоинт MCPhttps://oiair.com.br/api/mcp

Обзор

MCP представляет публичный каталог OiAir через пять инструментов чтения. Они не отправляют сообщения, не создают заявки и не бронируют места.

Публичный сервер не требует аутентификации. Он не предоставляет доступ к управлению организацией, записям или личным данным.

Подключение клиента

В клиенте с поддержкой удалённых MCP-серверов добавьте адрес ниже и выберите Streamable HTTP. Поддержка и путь настройки зависят от клиента.

ТранспортStreamable HTTP

Claude Code

Добавьте сервер в терминале. Затем проверьте подключение командой /mcp в Claude Code.

Claude Code
claude mcp add --transport http oiair https://oiair.com.br/api/mcp

MCP Inspector

Чтобы проверить подключение без агента, запросите список инструментов через официальный клиент диагностики.

MCP Inspector
npx @modelcontextprotocol/inspector --cli \
  'https://oiair.com.br/api/mcp' --transport http \
  --method tools/list
Официальные инструкцииПодключение MCP в Claude Code Использование MCP Inspector

Доступные инструменты

НазначениеОсновные аргументы
search_activitiesИщет занятия по тексту, фильтрам и cursor.query, filters, locale, limit, cursor
get_organizationЧитает публичную карточку организации.organizationId, locale
list_offeringsВозвращает текущие публикации организации.organizationId, locale
get_offeringЧитает точную группу; может проверить ожидаемую версию.publicationId, expectedVersion?, locale
get_booking_linkСоздаёт ссылку на форму для точной организации, публикации и версии.organizationId, publicationId, expectedVersion, visit?

В get_booking_link аргумент expectedVersion обязателен; visit принимает trial или regular. Используйте версию из публикации. Если она изменилась, перечитайте её перед созданием ссылки.

От поиска до формы

  1. Найдите занятия

    Вызовите search_activities с возрастом, городом и предпочтениями семьи.

  2. Проверьте группу

    Вызовите get_offering для чтения адреса, времени, цен и версии выбранной публикации.

  3. Откройте форму

    Вызовите get_booking_link с organizationId, publicationId и expectedVersion. Семья проверит условия и отправит заявку на OiAir.

Клиент выполняет инициализацию MCP и отправляет tools/call. Пример показывает тело вызова после подключения.

Пример вызова инструмента
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "search_activities",
    "arguments": {
      "query": "desenho",
      "locale": "ru",
      "filters": {
        "city": "Florianópolis",
        "age": 6
      },
      "limit": 5
    }
  }
}

Форма OiAir отправляет заявку организации. Отправка не бронирует место. Это подключение для чтения не отправляет заявки и не подтверждает запись.

Возможности подключения

  • Используйте данные сервера. Не выводите наличие мест из опубликованного времени.
  • Показывайте применённые критерии и unresolvedConstraints. Результаты — упорядоченная подборка; учитывайте resultScope, nextCursor и срок актуальности данных.
  • Не включайте имена, телефоны и другие личные данные в поисковый запрос.
  • Для работы инструментов клиент должен подключить сервер. Наличие эндпоинта не добавляет OiAir автоматически в сторонние каталоги.
  • Инструменты возвращают текст и структурированные данные. Визуальный интерфейс в чате зависит от поддержки клиента и не требуется для этого подключения.

Подключение и версии

Примеры подключения и история версий — на GitHub. Метаданные сервера можно посмотреть в MCP Registry.

Примеры и версии на GitHub Метаданные в MCP Registry

Следующий шаг

Нужна прямая интеграция с приложением? Используйте эндпоинты и контракт API.

Публичный API