Серверы MCP
Инструменты MCP Wink публикуются как наборы инструментов — специализированные конечные точки, каждая из которых охватывает одну задачу. Вы подключаете ваш AI-клиент к одной или двум, которые соответствуют вашей работе, а не ко всем сразу.
Каждая конечная точка использует интерактивный вход OAuth2 (PKCE authorization code flow): ваш AI-агент открывает вкладку браузера, вы входите в систему с помощью аккаунта Wink, и всё. Нет необходимости управлять секретами клиента.
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport httpclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpПочему инструменты разделены по конечным точкам
Заголовок раздела «Почему инструменты разделены по конечным точкам»Wink предоставляет около 500 инструментов. Передавать их все агенту одновременно технически возможно — но это плохая идея.
Определения инструментов занимают контекст. Каждый инструмент, который сервер MCP рекламирует, загружается в контекстное окно модели перед выполнением работы, вместе с описанием и полной схемой параметров. Пятьсот таких инструментов занимают значительную часть бюджета, который требуется для вашей задачи, при каждом запросе.
Качество выбора падает с ростом списка. Агент, выбирающий из 500 инструментов с похожими названиями, делает худший выбор, чем агент, выбирающий из 40. Если вы интегрируете channel manager, примерно двадцать инструментов релевантны для вас; остальные 480 — это шум, который затрудняет поиск нужного инструмента.
Работа действительно разделима. Кто-то синхронизирует доступность из PMS, а кто-то курирует страницы аффилиатов — у них почти нет общих инструментов. Разделение по задачам означает, что каждое подключение содержит словарь одной задачи.
Каталог конечных точек
Заголовок раздела «Каталог конечных точек»Два хоста обслуживают наборы инструментов. Количество инструментов приблизительное и со временем растёт.
https://api.wink.travel — платформа
Заголовок раздела «https://api.wink.travel — платформа»| Конечная точка | Инструменты | Что охватывает |
|---|---|---|
/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 | Бронирования через агента от имени путешественников и отчёты агента |
https://integrations.wink.travel — интеграции channel manager
Заголовок раздела «https://integrations.wink.travel — интеграции channel manager»Одна конечная точка, так как этот хост существует для одной задачи.
| Конечная точка | Инструменты | Что охватывает |
|---|---|---|
/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 или CRS | integrations.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). Вот что происходит при первом подключении:
- Ваш AI-клиент обнаруживает сервер авторизации из метаданных
/.well-known/oauth-protected-resourceконечной точки MCP. - Клиент регистрируется самостоятельно через Dynamic Client Registration — ручная настройка приложения не требуется.
- Клиент открывает вкладку браузера на
https://iam.wink.travel. Вы входите в систему с аккаунтом Wink и подтверждаете запрошенные разрешения на экране согласия. - Wink выдаёт токен доступа, привязанный к вашему аккаунту и идентичности.
- AI-клиент прикрепляет токен к каждому запросу MCP. Все результаты инструментов автоматически ограничены вашей управляющей организацией.
- Токены действуют 3 часа. Ваш AI-клиент обновляет их в фоне без повторного запроса.
Каждый вызов инструмента выполняется от вашего имени — те же правила контроля доступа, что и в веб-портале, применяются к AI-агенту.
Подключите ваш AI-клиент
Заголовок раздела «Подключите ваш AI-клиент»Добавьте каждый набор инструментов в Claude как пользовательский коннектор. Не нужно редактировать конфигурационные файлы или создавать приложения и секреты.
-
В Claude откройте Customize › Connectors, нажмите Add, затем Add custom connector.
-
Введите Name (например Wink Link manager) и в поле MCP server URL вставьте набор инструментов из каталога выше, например:
https://api.wink.travel/mcp/link-managerНажмите Continue.
-
Claude обнаружит вход Wink. Оставьте Authentication: Sign in now и OAuth client: Register automatically, затем нажмите Add.
-
Нажмите Connect. Откроется страница входа Wink на
https://iam.wink.travel. Войдите в Wink и подтвердите разрешения на экране согласия. -
Инструменты коннектора теперь доступны в ваших чатах. Повторите для каждого набора инструментов, который нужен для вашей работы; каждый — отдельный коннектор.
-
Убедитесь, что Claude Code обновлён:
Окно терминала npm install -g @anthropic-ai/claude-code -
Выберите набор инструментов из каталога выше и добавьте его. Например, цены и доступность:
Окно терминала claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http -
Claude Code связывается с сервером, обнаруживает сервер авторизации и открывает ваш браузер по умолчанию.
-
Войдите в Wink и подтвердите запрос разрешений на экране согласия.
-
Claude Code подтверждает подключение. Введите
/mcp, чтобы проверить, что сервер появился и инструменты загружены.
Добавляйте столько наборов инструментов, сколько нужно для работы — каждый это отдельная запись сервера с собственным именем:
claude mcp add wink-operations https://api.wink.travel/mcp/extranet/operations --transport httpclaude mcp add wink-analytics https://api.wink.travel/mcp/analytics --transport httpВход выполняется один раз. После первого подтверждения в браузере Claude Code повторно использует вашу сессию Wink для дополнительных конечных точек Wink.
-
Отредактируйте конфигурационный файл Claude Desktop:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
- macOS:
-
Добавьте записи серверов MCP:
claude_desktop_config.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Полностью закройте и перезапустите Claude Desktop (используйте Quit в меню — закрытие окна недостаточно).
-
Claude Desktop откроет вкладку браузера для каждого нового сервера. Войдите в Wink и подтвердите разрешения.
-
Значок вилки в нижней панели показывает оба сервера как подключённые.
-
Убедитесь, что установлен Codex CLI:
Окно терминала npm install -g @openai/codex -
Откройте (или создайте) конфигурационный файл Codex:
- macOS / Linux:
~/.codex/config.json - Windows:
%USERPROFILE%\.codex\config.json
- macOS / Linux:
-
Добавьте записи серверов MCP Wink:
~/.codex/config.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Запустите Codex. При первом использовании Codex откроет вкладку браузера на
https://iam.wink.travel. -
Войдите в Wink и подтвердите запрошенные разрешения.
-
Codex подтвердит подключение. Запустите
codexи попросите показать список доступных инструментов, чтобы проверить активность серверов Wink.
Поддержка серверов MCP доступна в настольном приложении ChatGPT для подписчиков Plus, Pro, Team и Enterprise.
-
Скачайте и установите настольное приложение ChatGPT, если ещё не сделали этого.
-
Откройте приложение и нажмите иконку профиля в правом верхнем углу, затем выберите Settings.
-
Перейдите в раздел Connectors (или MCP Servers в зависимости от версии приложения) и нажмите Add.
-
Введите URL набора инструментов из каталога выше, например:
https://api.wink.travel/mcp/extranet/ratesЗатем нажмите Connect.
-
ChatGPT откроет вкладку браузера на
https://iam.wink.travel. Войдите в Wink и подтвердите разрешения. -
Повторите шаги 4–5 для других наборов инструментов, которые нужны для вашей работы, например:
https://api.wink.travel/mcp/extranet/operations -
Каждый набор инструментов появится в списке Connectors. Начните новый чат — инструменты Wink будут доступны автоматически.
-
Откройте (или создайте) конфигурационный файл MCP Cursor:
- macOS / Linux:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
- macOS / Linux:
-
Добавьте записи серверов MCP Wink:
~/.cursor/mcp.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Откройте Cursor. Перейдите в Settings → Cursor Settings → MCP и убедитесь, что оба сервера отображаются с зелёным статусом. Если статус красный, нажмите Refresh.
-
Cursor откроет вкладку браузера на
https://iam.wink.travel. Войдите в Wink и подтвердите разрешения. -
Откройте чат (
Ctrl+L/Cmd+L) и попросите Cursor показать доступные инструменты Wink, чтобы подтвердить подключение.
-
Откройте (или создайте) конфигурационный файл MCP Windsurf:
- macOS / Linux:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS / Linux:
-
Добавьте записи серверов MCP Wink:
~/.codeium/windsurf/mcp_config.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Полностью перезапустите Windsurf (Файл → Выход, затем откройте снова).
-
Перейдите в Settings → MCP Servers и убедитесь, что оба сервера отображаются как подключённые. Windsurf откроет вкладку браузера на
https://iam.wink.travelпри первом использовании. -
Войдите в Wink и подтвердите разрешения. Серверы станут зелёными в панели настроек после аутентификации.
Cline — расширение VS Code с встроенным менеджером серверов MCP. Ручное редактирование JSON не требуется.
-
Установите Cline из Marketplace VS Code:
- Откройте VS Code и нажмите
Ctrl+Shift+X/Cmd+Shift+X - Найдите Cline и нажмите Install
- Откройте VS Code и нажмите
-
Нажмите иконку Cline в панели активности (левая боковая панель), чтобы открыть панель Cline.
-
Нажмите иконку MCP Servers (значок вилки) на панели инструментов Cline, затем выберите Edit MCP Settings.
-
VS Code откроет
cline_mcp_settings.json. Добавьте записи Wink:cline_mcp_settings.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Сохраните файл. Cline автоматически перезагрузится и откроет вкладку браузера на
https://iam.wink.travel. -
Войдите в Wink и подтвердите разрешения. Оба сервера появятся активными в панели MCP Servers.
Области доступа (Scopes)
Заголовок раздела «Области доступа (Scopes)»При подтверждении экрана согласия вы увидите список запрашиваемых агентом разрешений. Клиенты 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 Codeclaude mcp remove wink-ratesclaude 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
