Перейти к содержимому

Серверы MCP

Инструменты MCP Wink публикуются как наборы инструментов — специализированные конечные точки, каждая из которых охватывает одну задачу. Вы подключаете ваш AI-клиент к одной или двум, которые соответствуют вашей работе, а не ко всем сразу.

Каждая конечная точка использует интерактивный вход OAuth2 (PKCE authorization code flow): ваш AI-агент открывает вкладку браузера, вы входите в систему с помощью аккаунта Wink, и всё. Нет необходимости управлять секретами клиента.

Интегратор channel manager подключается к одной конечной точке
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport http
Отельер, управляющий своими тарифами, подключается к другой
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Почему инструменты разделены по конечным точкам

Заголовок раздела «Почему инструменты разделены по конечным точкам»

Wink предоставляет около 500 инструментов. Передавать их все агенту одновременно технически возможно — но это плохая идея.

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

Качество выбора падает с ростом списка. Агент, выбирающий из 500 инструментов с похожими названиями, делает худший выбор, чем агент, выбирающий из 40. Если вы интегрируете channel manager, примерно двадцать инструментов релевантны для вас; остальные 480 — это шум, который затрудняет поиск нужного инструмента.

Работа действительно разделима. Кто-то синхронизирует доступность из PMS, а кто-то курирует страницы аффилиатов — у них почти нет общих инструментов. Разделение по задачам означает, что каждое подключение содержит словарь одной задачи.


Два хоста обслуживают наборы инструментов. Количество инструментов приблизительное и со временем растёт.

Конечная точкаИнструментыЧто охватывает
/mcp/extranet/facilities~64Бронирование и инвентарь на месте: гостевые комнаты и типы комнат, спа, рестораны, конференц-залы, активности, достопримечательности, места, другие продаваемые позиции
/mcp/extranet/property~62Запись объекта и его коммерческие условия: профиль и контент, доп. услуги, политики отмены, бонусы, объявления
/mcp/settings~60Администрирование аккаунта: профиль управляющей организации и брендинг, менеджеры и их права, кастомизация, вебхуки, настройки уведомлений
/mcp/studio/embeds~48Публикация курируемого инвентаря: виджеты, сетки и ранжированные сетки, карточки, карты, глубокие ссылки на инвентарь и страницы поставщиков
/mcp/extranet/rates~44Цены и доступность: периоды тарифов и квоты, тарифные планы, основные тарифы, специальные и промо-тарифы
/mcp/extranet/operations~39Управление объектом в реальном времени: бронирования и их жизненный цикл, отзывы гостей и ответы, календари, запланированные задачи
/mcp/extranet/distribution~37Каналы продаж: каналы сбыта и модификаторы тарифов, запросы на отношения с аффилиатами и поставщиками, регистрация, сбор лидов
/mcp/studio/curation~35Создание коллекций для мерчандайзинга: статические и динамические списки, ранжированные списки, сохранённые поиски, агрегаты объектов
/mcp/link-manager~28Коллекции синдицированных ссылок, их дизайн, категории и теги, а также сокращённые URL
/mcp/reference~24Данные только для чтения: страны, валюты и курсы обмена, языки, часовые пояса, геолокация, IP-геолокация
/mcp/analytics~18Аналитика бронирований и доходов: обзоры, линейные графики, рейтинги, эффективность аффилиатов, метрики доли
/mcp/payment~18Финансовые операции: бухгалтерия, выводы и оценки комиссий, агрегаты средств бронирования
/mcp/booking-engine~17Путь покупателя: поиск и просмотр, корзина и оформление заказа, списки желаний, кастомизация кампаний
/mcp/social~17Подключённые социальные аккаунты, публикация и планирование постов, чтение аналитики постов
/mcp/travel-agent~8Бронирования через агента от имени путешественников и отчёты агента

Одна конечная точка, так как этот хост существует для одной задачи.

Конечная точкаИнструментыЧто охватывает
/mcp/channel-manager~9Подключение и проверка интеграции channel manager, PMS или CRS

Каждая конечная точка также содержит инструмент ping, чтобы вы могли проверить, что соединение активно, прежде чем отправлять реальные запросы.

Для полного процесса бронирования путешественника подключайте Wink Booking Engine по адресу https://api.wink.travel/mcp/booking-engine и совместимый платёжный кошелёк. Добавление Wink MCP открывает окно браузера для входа и выбора разрешений; ваш клиент затем обрабатывает аутентификацию.

Booking Engine включает поиск направления, поиск отелей и комнат, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, получение бронирований и квитанций, когда агентское бронирование и оплата включены для этой среды. См. Agentic Payments для настройки подключения, выбора разрешений и шагов от поиска до подтверждения.


Если вы…Подключайтесь к
Интегрируете channel manager, PMS или CRSintegrations.wink.travel/mcp/channel-manager — только эта конечная точка
Управляете контентом объекта/mcp/extranet/property + /mcp/extranet/facilities
Управляете комнатами и типами комнат/mcp/extranet/facilities
Управляете ценами и доступностью/mcp/extranet/rates
Ведёте ежедневные бронирования/mcp/extranet/operations
Расширяете каналы сбыта/mcp/extranet/distribution + /mcp/analytics
Создаёте страницы аффилиатов/mcp/studio/curation + /mcp/studio/embeds
Ведёте страницы с ссылками в био/mcp/link-manager + /mcp/social
Бронируете от имени путешественников/mcp/travel-agent
Ведёте финансовую сверку/mcp/payment
Бронируете комнату с AI-агентом/mcp/booking-engine + совместимый платёжный кошелёк — см. Agentic Payments
Создаёте опыт бронирования/mcp/booking-engine; опционально /mcp/reference для дополнительных справок

Booking Engine включает основной рабочий процесс бронирования. Он обеспечивает обнаружение аккаунта и кастомизации, поиск направления, доступность отелей и детали тарифов, корзины, оформление заказа и управление бронированиями путешественников. Инструменты агентского бронирования и оплаты также включены, когда они активированы для этой среды.

Для поиска отелей в городе используйте destination_lookup_search_suggestions для определения направления, затем inventory_search_city для поиска доступных отелей и тарифов. Оба инструмента находятся в /mcp/booking-engine, поэтому для этого процесса не требуется подключение к Reference.

Добавьте /mcp/reference, если нужны дополнительные справочные данные, такие как страны, валюты и курсы обмена, поддерживаемые языки, часовые пояса, более широкие географические поиски, классификации OTA или публичные данные об объектах. Это опциональные дополнения к процессу бронирования.

Начните с одного. Добавляйте другой, когда обнаружите, что первый не может выполнить нужную задачу — каждое подключение независимо, и добавление одного не влияет на другие.


Серверы MCP Wink используют поток OAuth2 Authorization Code + PKCE и поддерживают Dynamic Client Registration (RFC 7591). Вот что происходит при первом подключении:

  1. Ваш AI-клиент обнаруживает сервер авторизации из метаданных /.well-known/oauth-protected-resource конечной точки MCP.
  2. Клиент регистрируется самостоятельно через Dynamic Client Registration — ручная настройка приложения не требуется.
  3. Клиент открывает вкладку браузера на https://iam.wink.travel. Вы входите в систему с аккаунтом Wink и подтверждаете запрошенные разрешения на экране согласия.
  4. Wink выдаёт токен доступа, привязанный к вашему аккаунту и идентичности.
  5. AI-клиент прикрепляет токен к каждому запросу MCP. Все результаты инструментов автоматически ограничены вашей управляющей организацией.
  6. Токены действуют 3 часа. Ваш AI-клиент обновляет их в фоне без повторного запроса.

Каждый вызов инструмента выполняется от вашего имени — те же правила контроля доступа, что и в веб-портале, применяются к AI-агенту.


Добавьте каждый набор инструментов в Claude как пользовательский коннектор. Не нужно редактировать конфигурационные файлы или создавать приложения и секреты.

  1. В Claude откройте Customize › Connectors, нажмите Add, затем Add custom connector.

  2. Введите Name (например Wink Link manager) и в поле MCP server URL вставьте набор инструментов из каталога выше, например:

    https://api.wink.travel/mcp/link-manager

    Нажмите Continue.

  3. Claude обнаружит вход Wink. Оставьте Authentication: Sign in now и OAuth client: Register automatically, затем нажмите Add.

  4. Нажмите Connect. Откроется страница входа Wink на https://iam.wink.travel. Войдите в Wink и подтвердите разрешения на экране согласия.

  5. Инструменты коннектора теперь доступны в ваших чатах. Повторите для каждого набора инструментов, который нужен для вашей работы; каждый — отдельный коннектор.


При подтверждении экрана согласия вы увидите список запрашиваемых агентом разрешений. Клиенты MCP используют тот же словарь разрешений, что и остальная платформа — смотрите полный справочник областей доступа на странице аутентификации.

Три особенности MCP:

  • Области mcp.read, mcp.write, mcp.remove дополнительно требуются для открытия транспорта MCP. Клиент с областью mcp.* допускается к любой конечной точке Wink MCP, но каждый вызываемый инструмент всё равно проверяет область конечной точки, которую он оборачивает (например, booking.read).
  • MCP всегда действует от имени вошедшего пользователя. AI-клиент получает области mcp.* через ваш вход, а не через Приложение, которое вы создаёте. Машинные токены (client-credentials) не могут открыть транспорт MCP; для сервер-сервер работы используйте REST API.
  • AI-клиент запрашивает только необходимые области. Вы можете отказать в отдельных разрешениях на экране согласия — инструменты, требующие отказанных областей, вернут ошибку при вызове.

Наборы инструментов этого не меняют. Конечная точка, к которой вы подключаетесь, решает, какие инструменты перечислены, а не что им разрешено делать. Подключение к /mcp/payment не даёт финансовых прав, которых у вас не было, а подключение к /mcp/reference не мешает инструментам там проверять свои области. Авторизация решается для каждого вызова инструмента на основе вашего токена и прав аккаунта.


Вкладка браузера не открывается

Ваш AI-клиент может ещё не поддерживать интерактивный поток PKCE. Проверьте, что у вас последняя версия:

  • Claude Code: npm install -g @anthropic-ai/claude-code
  • Codex CLI: npm install -g @openai/codex
  • Claude Desktop / ChatGPT desktop: обновитесь через встроенный обновлятор приложения

401 Unauthorized после входа

Ваш кэшированный токен мог устареть. Удалите и добавьте сервер заново, чтобы инициировать новый вход:

Окно терминала
# Claude Code
claude mcp remove wink-rates
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Для Claude Desktop и ChatGPT удалите запись сервера из настроек, перезапустите приложение и добавьте снова.

403 Forbidden при вызове конкретного инструмента

Инструмент требует область, которую вы не одобрили на экране согласия, или разрешение, которого нет у вашего аккаунта. Переподключите сервер — экран согласия появится снова, и вы сможете одобрить недостающие разрешения. Если ошибка сохраняется, инструмент требует прав аккаунта, которых у вас нет; подключение к другому набору инструментов не поможет, так как наборы не дают прав.

Инструмент, который мне нужен, отсутствует в списке

Вероятно, вы подключены к набору инструментов, который не охватывает эту задачу. Проверьте каталог конечных точек и добавьте нужный набор — подключения независимы, добавление одного не влияет на другие. Если не уверены, где он есть, временно подключитесь к https://api.wink.travel/mcp, найдите инструмент и посмотрите, в каком наборе он есть.

404 Not Found на конечной точке набора инструментов

Проверьте путь внимательно — вложенные наборы имеют два сегмента (/mcp/extranet/rates, а не /mcp/extranet-rates), а плоские — один (/mcp/link-manager). Обратите внимание, что неаутентифицированный запрос к любому пути под /mcp возвращает 401, а не 404, поэтому один только 401 не говорит, существует ли конечная точка.

Я подключился к api.wink.travel/mcp/channel-manager и ничего не получил

Такой конечной точки нет. Интеграция channel manager обслуживается только с https://integrations.wink.travel/mcp/channel-manager. Если вам нужно читать или менять собственные тарифы объекта вручную, это отдельная задача на отдельной конечной точке — смотрите /mcp/extranet/rates.

Сервер появился, но вызовы инструментов возвращают “account not found”

Вы вошли в аккаунт Wink, у которого нет управляющей организации. Перейдите в Wink Portal и убедитесь, что ваш аккаунт настроен перед использованием сервера MCP.

Токен истекает в середине сессии

Токены действуют 3 часа. Claude Code и Claude Desktop обновляют токены в фоне без прерывания сессии. Если после длительного простоя появляются ошибки аутентификации, отправьте новое сообщение — клиент автоматически повторно аутентифицируется.

Codex CLI показывает “MCP server unreachable”

Проверьте, что ваш ~/.codex/config.json — валидный JSON (без завершающих запятых) и что "type": "http" установлен. Codex требует HTTP-транспорт для удалённых серверов; stdio-транспорт предназначен только для локальных бинарников.

В меню ChatGPT отсутствует пункт “Connectors”

Поддержка MCP требует версии настольного приложения ChatGPT 1.2024.352 или выше и активной подписки Plus, Pro, Team или Enterprise. Обновите приложение и проверьте план в Settings → Account.

Сервер Cursor показывает красный статус / “Failed to connect”

Проверьте, что ваш ~/.cursor/mcp.json — валидный JSON и содержит "type": "http". Затем перейдите в Settings → Cursor Settings → MCP и нажмите Refresh. Если ошибка сохраняется, полностью перезапустите Cursor — изменения конфигурации не всегда применяются без перезапуска.

Серверы MCP Windsurf не отображаются в настройках

Windsurf требует полного перезапуска (не только перезагрузки окна) для применения изменений в mcp_config.json. Используйте File → Quit и запустите заново. Если серверы всё ещё не отображаются, убедитесь, что у вас версия Windsurf 1.4+ через Help → About Windsurf.

В Cline отсутствует опция “Add Server”

Менеджер серверов MCP требует Cline версии 2.0 или выше. Откройте панель расширений VS Code, найдите Cline и нажмите Update, если доступно обновление. После обновления перезагрузите VS Code (Ctrl+Shift+P → “Developer: Reload Window”).


Открыть Wink Portal Wink на GitHub