Серверы MCP

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

Сервер	URL	Что делает
Inventory API	https://api.wink.travel/mcp	Инвентарь, бронирования, тарифы, каналы продаж, аналитика и все операции платформы
Integrations	https://integrations.wink.travel/mcp	Интеграции с менеджерами каналов — синхронизация объектов, тарифов и доступности с 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-клиент обновляет их в фоновом режиме без повторного запроса.

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

---

Подключите ваш AI-клиент

Claude Code

1. Убедитесь, что Claude Code обновлен:

   npm install -g @anthropic-ai/claude-code

2. Добавьте сервер Wink Inventory MCP:

   claude mcp add wink-inventory https://api.wink.travel/mcp --transport http

3. Claude Code связывается с сервером, обнаруживает сервер авторизации и открывает ваш браузер по умолчанию.

4. Войдите в Wink и подтвердите запрос разрешений на экране согласия.

5. Claude Code подтверждает подключение. Введите /mcp, чтобы проверить, что сервер появился и его инструменты загружены.

Чтобы добавить также сервер Integrations:

claude mcp add wink-integrations https://integrations.wink.travel/mcp --transport http

Поделитесь с командой

Добавьте --scope project к команде claude mcp add, и Claude Code запишет URL сервера в .mcp.json в корне репозитория. Зафиксируйте этот файл — каждый участник команды выполнит вход через браузер при первом подключении.

Claude Desktop

1. Отредактируйте конфигурационный файл 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

2. Добавьте записи серверов MCP:

   claude_desktop_config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

3. Полностью закройте и перезапустите Claude Desktop (используйте Quit в меню — просто закрыть окно недостаточно).

4. Claude Desktop откроет вкладку браузера для каждого нового сервера. Войдите в Wink и подтвердите разрешения.

5. Значок вилки в нижней панели инструментов покажет оба сервера как подключенные.

OpenAI Codex

1. Убедитесь, что установлен Codex CLI:

   npm install -g @openai/codex

2. Откройте (или создайте) конфигурационный файл Codex:

   • macOS / Linux: ~/.codex/config.json
   • Windows: %USERPROFILE%\.codex\config.json

3. Добавьте записи серверов Wink MCP:

   ~/.codex/config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

4. Запустите Codex. При первом использовании Codex откроет вкладку браузера на https://iam.wink.travel.

5. Войдите в Wink и подтвердите запрошенные разрешения.

6. Codex подтвердит подключение. Запустите codex и попросите показать доступные инструменты, чтобы проверить активность серверов Wink.

Заметка

Поддержка MCP в Codex CLI требует версии 1.0 или выше. Проверьте с помощью codex --version и обновите через npm install -g @openai/codex.

ChatGPT

Поддержка серверов MCP доступна в настольном приложении ChatGPT для подписчиков Plus, Pro, Team и Enterprise.

1. Скачайте и установите настольное приложение ChatGPT, если еще не сделали этого.

2. Откройте приложение и нажмите иконку профиля в правом верхнем углу, затем выберите Настройки.

3. Перейдите в раздел Connectors (или MCP Servers в зависимости от версии приложения) и нажмите Добавить.

4. Введите URL сервера Wink Inventory:

   https://api.wink.travel/mcp

   Затем нажмите Подключить.

5. ChatGPT откроет вкладку браузера на https://iam.wink.travel. Войдите в Wink и подтвердите разрешения.

6. Повторите шаги 4–5 для сервера Integrations:

   https://integrations.wink.travel/mcp

7. Оба сервера появятся в списке Connectors. Начните новый чат — инструменты Wink будут доступны автоматически.

Ограничение веб-приложения

Серверы MCP можно настроить только в настольном приложении. Веб-интерфейс ChatGPT на chatgpt.com не поддерживает пользовательские серверы MCP.

Cursor

1. Откройте (или создайте) конфигурационный файл Cursor MCP:

   • macOS / Linux: ~/.cursor/mcp.json
   • Windows: %USERPROFILE%\.cursor\mcp.json

2. Добавьте записи серверов Wink MCP:

   ~/.cursor/mcp.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

3. Откройте Cursor. Перейдите в Settings → Cursor Settings → MCP и убедитесь, что оба сервера отображаются с зеленым индикатором статуса. Если индикатор красный, нажмите Refresh.

4. Cursor откроет вкладку браузера на https://iam.wink.travel. Войдите в Wink и подтвердите разрешения.

5. Откройте чат (Ctrl+L / Cmd+L) и попросите Cursor показать доступные инструменты Wink, чтобы подтвердить подключение.

Конфигурация на уровне проекта

Вы также можете разместить файл mcp.json в корне вашего проекта вместо ~/.cursor/. Конфигурация на уровне проекта имеет приоритет и делает серверы доступными для каждого члена команды, открывающего проект в Cursor.

Windsurf

1. Откройте (или создайте) конфигурационный файл Windsurf MCP:

   • macOS / Linux: ~/.codeium/windsurf/mcp_config.json
   • Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

2. Добавьте записи серверов Wink MCP:

   ~/.codeium/windsurf/mcp_config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

3. Полностью перезапустите Windsurf (Файл → Выход, затем откройте заново).

4. Перейдите в Settings → MCP Servers и убедитесь, что оба сервера отображаются как подключенные. Windsurf откроет вкладку браузера на https://iam.wink.travel при первом использовании.

5. Войдите в Wink и подтвердите разрешения. Серверы станут зелеными в панели настроек после аутентификации.

Заметка

Поддержка MCP в Windsurf требует версии 1.4 или выше. Проверьте через Help → About Windsurf и обновите с сайта Windsurf при необходимости.

Cline (VS Code)

Cline — это расширение VS Code с встроенным менеджером серверов MCP. Ручное редактирование JSON не требуется.

1. Установите Cline из Marketplace VS Code:

   • Откройте VS Code и нажмите Ctrl+Shift+X / Cmd+Shift+X
   • Найдите Cline и нажмите Установить

2. Нажмите на иконку Cline в панели активности (левая боковая панель), чтобы открыть панель Cline.

3. Нажмите на иконку MCP Servers (значок вилки) в панели инструментов Cline, затем выберите Edit MCP Settings.

4. VS Code откроет cline_mcp_settings.json. Добавьте записи Wink:

   cline_mcp_settings.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

5. Сохраните файл. Cline автоматически перезагрузится и откроет вкладку браузера на https://iam.wink.travel.

6. Войдите в Wink и подтвердите разрешения. Оба сервера появятся как активные в панели MCP Servers.

Альтернатива: добавление по URL

В панели MCP Servers нажмите Add Server и вставьте https://api.wink.travel/mcp напрямую. Cline автоматически заполнит конфигурацию и выполнит аутентификацию без ручного редактирования JSON.

---

Области доступа (Scopes)

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

Два момента специфичны для MCP:

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

---

Устранение неполадок

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

Ваш 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-inventory
claude mcp add wink-inventory https://api.wink.travel/mcp --transport http

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

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

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

Сервер отображается, но вызовы инструментов возвращают “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. Обновите приложение и проверьте план в Настройках → Аккаунт.

Сервер Cursor отображается красным / “Failed to connect”

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

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

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

Опция “Add Server” в Cline не видна

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

---

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