Гид

Подключите ИИ-ассистента к MCP-серверу Atli eSIM

Подключите ChatGPT, Claude, Gemini или своего ИИ-агента к MCP-серверу Atli, чтобы искать тарифы eSIM, оформлять покупки и выдавать инструкции по установке.

ИИ-чат, в котором Atli предлагает тарифы для Японии и защищённую ссылку на оплату, рядом с крылатым синим талисманом Atli, который выходит из телефона

Atli предоставляет публичный MCP-сервер, через который ИИ-ассистенты могут продавать туристические eSIM. Благодаря этой интеграции ассистенты ищут тарифы, проверяют совместимость устройств, оформляют заказы и выдают инструкции по установке eSIM.

Открытый стандарт Model Context Protocol (MCP) позволяет ИИ-ассистентам работать с внешними инструментами и сервисами. MCP-сервер Atli даёт доступ к актуальному каталогу eSIM, поэтому сведения о тарифах и цены поступают напрямую от Atli, а не из собственных знаний ИИ-ассистента.

Ваш партнёрский код входит в адрес MCP-сервера. Новые клиенты, которые покупают как гости через ассистента, подключённого по этому адресу, привязываются к вашему партнёрскому аккаунту. Это касается как ИИ-ассистентов, которые разрабатываете вы, так и поддерживаемых сторонних ассистентов, в которых настроен ваш MCP-адрес.

Ваш MCP-адрес

Войдите на partners.heyatli.com и откройте MCP-сервер. Адрес там уже содержит ваш партнёрский код, и рядом есть кнопка копирования.

Блок «Ваш адрес» на странице «MCP-сервер» в partners.heyatli.com с адресом сервера, кнопкой копирования и кнопкой «Добавить реферальный код»

Чтобы составить адрес вручную, добавьте свой партнёрский код после /r/:

https://mcp.heyatli.com/r/YOUR_CODE

Новые клиенты, купившие как гости через ваш MCP-адрес, привязываются к вашему партнёрскому коду. Если ваш код даёт скидку, она применяется к их первому заказу.

Стандартный адрес https://mcp.heyatli.com тоже позволяет покупать, но не привязывает покупателей к партнёру. Чтобы подходящие продажи засчитывались вам, всегда используйте полный реферальный адрес.

Как подключить ChatGPT, Claude и Gemini

Меню настройки могут меняться, когда платформы ИИ обновляют свои интерфейсы. Названия меню и кнопок здесь взяты из английского интерфейса приложений, как и на картинках. Если инструкции расходятся с тем, что вы видите, обратитесь к документации платформы о пользовательских MCP-серверах или коннекторах.

ChatGPT. Откройте Plugins на боковой панели, выберите Add, а затем Add custom MCP server. Назовите сервер Atli eSIM, оставьте выбранным Server URL, вставьте адрес и в Authentication выберите No authentication. Отметьте I understand and want to continue и нажмите Create as a plugin, затем установите плагин и проверьте его в новом чате. Полную поддержку пользовательских MCP-серверов OpenAI даёт на тарифах Business, Enterprise и Edu, и там администраторы рабочего пространства решают, кто может их добавлять. На Pro разрешены только действия для чтения и получения данных, поэтому рассчитывайте, что поиск тарифов eSIM там заработает, а покупка нет. Если такого пункта в меню нет, ваш тариф или рабочее пространство его не предлагает.

Добавление Atli eSIM в ChatGPT: Plugins на боковой панели, Add, затем Add custom MCP server. В форме указаны имя Atli eSIM, адрес https://mcp.heyatli.com/r/YOUR_CODE и No authentication. Флажок с предупреждением о рисках отмечен до нажатия Create as a plugin

Claude. Откройте Customize, затем Connectors. Выберите + Add, затем Add custom connector. Назовите коннектор Atli eSIM, вставьте адрес и нажмите Continue, а затем ещё раз Continue на экране с настройками аутентификации, которые Claude обнаружил сам. В разделе Authentication выберите Sign in when needed, оставьте OAuth-клиент, который рекомендует Claude, и нажмите Add. Claude предлагает пользователю войти в Atli, только когда для операции нужен доступ к аккаунту. На тарифах Team и Enterprise коннектор добавляет владелец в Organization settings, а участники потом нажимают Connect. Claude на тарифе Free разрешает один пользовательский коннектор.

Добавление Atli eSIM в Claude: Connectors, + Add и Add custom connector, затем имя Atli eSIM и адрес, после этого Sign in when needed с рекомендованным OAuth-клиентом Claude и Add

Gemini. На gemini.google.com откройте Settings, затем Connected Apps. Если этого пункта там нет, загляните в Personal Intelligence. В разделе Custom apps выберите Add a custom app, вставьте адрес, нажмите Next и следуйте шагам. Имя Gemini не спрашивает, а сервер Atli сам представляется как Atli eSIM. У Gemini есть дополнительные требования к пользователям. Для пользовательских приложений нужен личный аккаунт Google и включённая настройка History. Работают они только на английском, а пользоваться ими можно с 18 лет и только в США. После настройки в веб-версии пользовательское приложение становится доступно и в мобильном приложении Gemini.

Добавление Atli eSIM в Gemini: Settings, Connected Apps, Add a custom app в разделе Custom apps, затем адрес https://mcp.heyatli.com/r/YOUR_CODE и Next

Muse. Попросите Muse такими словами: «Добавь Atli eSIM MCP по этому адресу: https://mcp.heyatli.com/r/YOUR_CODE». Подтвердите, если Muse спросит.

Добавление Atli eSIM в Muse: новый чат с сообщением «Добавь Atli eSIM MCP по этому адресу» и партнёрским адресом, затем подтверждение, если Muse его попросит

Claude Code. Сервер добавляется одной командой:

Bash
claude mcp add --transport http atli-esim https://mcp.heyatli.com/r/YOUR_CODE

Cursor, VS Code и другие приложения. Добавьте удалённый MCP-сервер, назовите его Atli eSIM, если приложение спросит имя, вставьте адрес и оставьте вход пустым. Подойдёт любое приложение, которое поддерживает удалённые MCP-серверы через Streamable HTTP.

Затем спросите о том, о чём спросил бы путешественник: «Тарифы eSIM для Японии на 10 дней, в евро».

Что умеет ассистент

Справочник MCP показывает актуальный список доступных инструментов и их входных параметров.

  • Поиск тарифа. search_plans ищет тарифы по направлению, сроку, объёму трафика и валюте. get_plan даёт дополнительные сведения о тарифе, в том числе о поддерживаемых сетях. list_destinations возвращает доступные направления, а check_device_support проверяет совместимость телефонов, планшетов и часов с eSIM.
  • Покупка. get_quote возвращает итоговую цену с учётом действующих скидок. start_purchase создаёт заказ и формирует ссылку на оплату. get_order_status проверяет статус заказа, а cancel_order и get_receipt отвечают за отмену заказов и чеки.
  • После покупки. get_install_instructions выдаёт две ссылки для человека, который будет пользоваться eSIM. Одна открывает её в приложении Atli, а другая устанавливает её из браузера и показывает остаток трафика без аккаунта Atli. Кроме того, инструмент выдаёт QR-код, ссылки для установки на iPhone и Android и инструкции по ручной установке. list_my_esims возвращает список eSIM клиента, а refresh_usage обновляет данные о расходе трафика.
  • Другие возможности. Сервер также поддерживает передачу eSIM другим людям, сохранённые способы оплаты, ваучеры, кредиты Atli, доступ к справочным статьям и управление Atli Group.

Как проходит оплата в чате

Данные платёжной карты не передаются ни ИИ-ассистенту, ни компании, которая его предоставляет. Клиент получает ссылку на защищённую страницу оплаты Atli, где платёж обрабатывает Stripe и до подтверждения показывается итоговая сумма.

Клиенты с сохранённой картой могут оплатить покупку и прямо в чате. Сервер Atli даёт ассистенту указание списывать оплату с такой карты только после того, как клиент проверил цену и выбранную карту и явно подтвердил и то, и другое. Общая просьба купить eSIM таким подтверждением не считается. Сам сервер выполнение этого требования не контролирует.

Клиенты могут покупать eSIM как гости, не входя в аккаунт. Ассистент хранит гостевой ключ, связанный с разговором, поэтому клиент может вернуться в тот же чат, чтобы открыть инструкции по установке или проверить остаток трафика. Ссылки для установки работают и вне чата. Они открывают eSIM в приложении Atli или на heyatli.com, где остаток трафика виден без аккаунта.

Клиенты, которые вошли в Atli, получают доступ к eSIM своего аккаунта в любых поддерживаемых чатах. Вход выполняется на heyatli.com, поэтому пароли и коды подтверждения через чат не передаются.

Как собрать собственного агента

Собственные агенты подключаются к MCP-серверу Atli через Streamable HTTP. В примере ниже используется официальный TypeScript SDK:

JavaScript
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const client = new Client({ name: 'my-travel-agent', version: '1.0.0' });
await client.connect(
  new StreamableHTTPClientTransport(new URL('https://mcp.heyatli.com/r/YOUR_CODE'))
);

const result = await client.callTool({
  name: 'search_plans',
  arguments: { destination: 'Japan', days: 10, currency: 'EUR' },
});
console.log(result.content[0].text);

Первый вызов инструмента, связанного с покупкой, создаёт гостевой аккаунт и возвращает guest_key. Надёжно храните этот ключ в сессии разговора с пользователем и передавайте его в последующих запросах.

Ключ guest_key идентифицирует гостевой аккаунт и даёт доступ к связанным с ним eSIM.

Для тестирования подключитесь к серверу Sandbox по адресу https://staging.public.mcp.heyatli.com/r/YOUR_CODE. В Sandbox платежи проводятся тестовой картой Stripe с номером 4242 4242 4242 4242. eSIM в Sandbox выпускает тестовый оператор, поэтому установить их на телефон нельзя, а продажи в Sandbox никогда не приносят комиссии.

Если переключить справочник MCP на Sandbox, в нём появится кнопка Попробовать для проверки отдельных инструментов.

Как засчитываются продажи через MCP

Новые клиенты, купившие как гости через ваш MCP-адрес, привязываются к вашему партнёрскому коду.

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

Подробнее о комиссиях и выплатах рассказано в гиде по партнёрской программе Atli. Гид по API Atli описывает приложения, которым нужен собственный интерфейс.

Частые вопросы

Нужен ли MCP-серверу Atli API-ключ?
Нет. MCP-сервер общедоступен. Клиенты могут просматривать тарифы без аккаунта, а гостевой аккаунт создаётся автоматически, когда он нужен для покупки. Входить в Atli необязательно.
Может ли ассистент потратить деньги, не спросив?
Платёж по ссылке проходит, только если клиент сам завершит оплату на странице оплаты Atli. Если оплата идёт с сохранённой карты или карты Atli Group, Atli даёт ассистенту указание перед списанием запросить у клиента подтверждение цены и карты или группы. Сам сервер выполнение этого требования не контролирует.
Какие ИИ-ассистенты с ним работают?
Любые, которые поддерживают удалённые MCP-серверы через Streamable HTTP. Среди них плагины ChatGPT, пользовательские коннекторы Claude, пользовательские приложения Gemini, Muse, Claude Code, Cursor и VS Code.
Где человек потом найдёт свою eSIM?
По ссылкам для установки, которые ассистент присылает после оплаты. Одна открывает eSIM в приложении Atli, а другая открывает её на heyatli.com, где eSIM можно установить и увидеть остаток трафика без аккаунта. Установить eSIM может любой, у кого есть эти ссылки, поэтому передавать их следует только тому, кто будет ею пользоваться. Гости также могут вернуться в исходный чат, а клиенты, которые покупали после входа в аккаунт, видят свои eSIM через аккаунт Atli и в других поддерживаемых чатах.
Нужно ли платить за подключение сервера?
Нет. Добавить Atli в ассистента можно бесплатно, а люди платят только за выбранную eSIM. Тариф самого ассистента может ограничивать, какие коннекторы можно добавить.