
A Atli oferece um servidor MCP público que permite a assistentes de IA vender eSIMs de viagem. Com essa integração, os assistentes podem buscar planos, verificar a compatibilidade do aparelho, processar pedidos e fornecer instruções de instalação do eSIM.
O Model Context Protocol (MCP) é um padrão aberto que permite a assistentes de IA interagir com ferramentas e serviços externos. O servidor MCP da Atli dá acesso ao catálogo de eSIMs ao vivo, o que garante que as informações dos planos e os preços venham diretamente da Atli e não do conhecimento prévio do assistente de IA.
O seu código de parceiro faz parte do endereço do servidor MCP. Clientes novos que compram como convidados por um assistente conectado a esse endereço são atribuídos à sua conta de parceiro. Isso vale tanto para os assistentes de IA que você desenvolve quanto para assistentes de terceiros compatíveis configurados com o seu endereço MCP.
O seu endereço MCP
Entre em partners.heyatli.com e abra Servidor MCP. O endereço que aparece lá já traz o seu código de parceiro e tem um botão de copiar.

Para montar o endereço você mesmo, acrescente o seu código de parceiro depois de /r/:
https://mcp.heyatli.com/r/YOUR_CODEOs clientes convidados novos que compram pelo seu endereço MCP são atribuídos ao seu código de parceiro. Se o seu código tiver desconto, ele vale no primeiro pedido desses clientes.
O endereço padrão https://mcp.heyatli.com também aceita compras, mas não atribui a venda a nenhum parceiro. Use sempre o seu endereço de indicação completo para que as vendas elegíveis sejam contabilizadas para você.
Como conectar o ChatGPT, o Claude e o Gemini
Os menus de configuração podem mudar quando as plataformas de IA atualizam a interface. Os nomes de menu e as imagens são os da interface em inglês de cada app. Se as instruções forem diferentes do que você vê, consulte a documentação da plataforma sobre servidores MCP personalizados ou conectores.
ChatGPT. Abra Plugins na barra lateral, escolha Add e depois Add custom MCP server. Dê o nome Atli eSIM, deixe Server URL selecionado, cole o endereço e defina Authentication como No authentication. Marque I understand and want to continue e escolha Create as a plugin. Depois, instale o plugin e teste numa conversa nova. A OpenAI dá suporte completo a servidores MCP personalizados nos planos Business, Enterprise e Edu, em que os administradores do workspace decidem quem pode adicioná-los. No Pro, ela só permite ações de leitura e de busca, então a consulta de planos deve funcionar ali, e a compra não. Se a opção não aparece no menu, o seu plano ou workspace não a oferece.

Claude. Abra Customize e depois Connectors. Escolha + Add e depois Add custom connector. Dê o nome Atli eSIM, cole o endereço e escolha Continue. Escolha Continue de novo para passar pelas configurações de autenticação que o Claude detecta. Em Authentication, escolha Sign in when needed, mantenha o cliente OAuth recomendado pelo Claude e escolha Add. O Claude só pede que o usuário entre na Atli quando uma operação exige acesso à conta. Nos planos Team e Enterprise, um proprietário adiciona o conector em Organization settings, e depois os membros escolhem Connect. No plano gratuito, o Claude permite um conector personalizado.

Gemini. Em gemini.google.com, abra Settings e depois Connected Apps. Se não encontrar essa opção, procure em Personal Intelligence. Em Custom apps, escolha Add a custom app, cole o endereço, escolha Next e siga os passos. O Gemini não pede nome, e o servidor da Atli se apresenta como Atli eSIM. O Gemini tem requisitos adicionais de uso. Os apps personalizados exigem uma conta pessoal do Google e History ativado. Eles só funcionam em inglês, e você precisa ter 18 anos ou mais e estar nos EUA. Depois de configurado pela interface web, o app personalizado também fica disponível no app do Gemini para celular.

Muse. Peça ao Muse com estas palavras: “Adicione o MCP Atli eSIM por este endereço: https://mcp.heyatli.com/r/YOUR_CODE”. Confirme se o Muse pedir.

Claude Code. Um comando adiciona o servidor:
claude mcp add --transport http atli-esim https://mcp.heyatli.com/r/YOUR_CODECursor, VS Code e outros apps. Adicione um servidor MCP remoto, dê o nome Atli eSIM se o app pedir, cole o endereço e deixe o login em branco. Funciona com qualquer app compatível com servidores MCP remotos via Streamable HTTP.
Depois, pergunte o tipo de coisa que um viajante perguntaria: “planos de eSIM para o Japão por 10 dias, em euros”.
O que o assistente consegue fazer
A referência do MCP mostra ao vivo a lista das ferramentas disponíveis e dos parâmetros de entrada de cada uma.
- Encontrar um plano.
search_plansbusca por destino, duração, quantidade de dados e moeda.get_plantraz mais detalhes do plano e as redes compatíveis.list_destinationslista os destinos disponíveis, echeck_device_supportverifica se um celular, tablet ou relógio é compatível com eSIM. - Comprar.
get_quoteobtém o preço final com os descontos aplicáveis.start_purchasecria um pedido e gera um link de pagamento.get_order_statusverifica o andamento do pedido, ecancel_ordereget_receiptcuidam de cancelamentos e recibos. - Depois da compra.
get_install_instructionsfornece dois links para a pessoa que vai usar o eSIM. Um abre o eSIM no app da Atli, e o outro o instala pelo navegador e mostra os dados restantes sem conta da Atli. A ferramenta também fornece um código QR, links de instalação para iPhone e Android e instruções de instalação manual.list_my_esimsobtém os eSIMs do cliente, erefresh_usageatualiza as informações de consumo de dados. - Outros recursos. O servidor também permite compartilhar eSIMs, usar formas de pagamento salvas, vouchers e créditos Atli, consultar os artigos de ajuda e gerenciar um Atli Group.
Como funciona o pagamento numa conversa
Os dados do cartão de pagamento não são compartilhados com o assistente de IA nem com a empresa que o fornece. O cliente recebe um link para a página de pagamento segura da Atli, onde a Stripe processa o pagamento e mostra o total antes da confirmação.
Clientes com um cartão salvo também podem pagar dentro da conversa. O servidor da Atli instrui o assistente a cobrar esse cartão só depois que o cliente tiver conferido o preço e o cartão escolhido e aprovado os dois de forma explícita. Um pedido genérico para comprar um eSIM não conta como essa aprovação. O servidor não garante o cumprimento dessa exigência de forma independente.
Os clientes podem comprar eSIMs como convidados sem fazer login. O assistente mantém uma chave de convidado associada à conversa, o que permite ao cliente voltar à mesma conversa para acessar as instruções de instalação ou conferir os dados restantes. Os links de instalação também funcionam fora da conversa. Eles abrem o eSIM no app da Atli ou em heyatli.com, que mostra os dados restantes sem conta.
Os clientes que entram na Atli podem acessar os eSIMs da própria conta em qualquer conversa compatível. A autenticação acontece em heyatli.com, então senhas e códigos de verificação não passam pela conversa.
Como criar o seu próprio agente
Agentes próprios podem se conectar ao servidor MCP da Atli via Streamable HTTP. O exemplo abaixo usa o SDK oficial de TypeScript:
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);A primeira chamada a uma ferramenta de compra cria uma conta de convidado e devolve uma guest_key. Guarde essa chave com segurança na sessão de conversa do usuário e inclua-a nas requisições seguintes.
A guest_key identifica a conta de convidado e dá acesso aos eSIMs associados a ela.
Para testar, conecte-se ao servidor do Sandbox em https://staging.public.mcp.heyatli.com/r/YOUR_CODE. O Sandbox aceita pagamentos de teste com o cartão de teste da Stripe 4242 4242 4242 4242. Os eSIMs do Sandbox vêm de uma operadora de teste, então não podem ser instalados num celular, e as vendas no Sandbox nunca rendem comissão.
Quando a referência do MCP está no modo Sandbox, ela também oferece um botão Testar para experimentar cada ferramenta separadamente.
Como as vendas por MCP são creditadas
Os clientes convidados novos que compram pelo seu endereço MCP são atribuídos ao seu código de parceiro.
A Atli precisa ativar à parte a atribuição de clientes que entram com uma conta da Atli que já tinham. Depois que um cliente é atribuído à sua conta de parceiro, as compras futuras elegíveis desse cliente em todos os canais da Atli entram nos seus ganhos por indicação.
Para detalhes sobre comissões e pagamentos, veja o guia do programa de afiliados da Atli. O guia da API da Atli trata dos apps que precisam de uma interface própria.



