Guia

Conecte um assistente de IA ao servidor MCP de eSIM da Atli

Conecte ChatGPT, Claude, Gemini ou seu agente de IA ao servidor MCP da Atli para buscar planos de eSIM, processar compras e dar instruções de instalação.

Uma conversa com IA em que a Atli oferece planos para o Japão e um link de pagamento seguro, ao lado do mascote azul com asas da Atli saindo de um celular

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.

A caixa Seu endereço na página Servidor MCP de partners.heyatli.com, com o endereço do servidor, um botão de copiar e um botão Adicionar código de indicação

Para montar o endereço você mesmo, acrescente o seu código de parceiro depois de /r/:

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

Os 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.

Como adicionar o Atli eSIM ao ChatGPT: Plugins na barra lateral, Add e depois Add custom MCP server. O formulário tem o nome Atli eSIM, o endereço https://mcp.heyatli.com/r/YOUR_CODE e No authentication. A caixa de risco está marcada antes de Create as a plugin

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.

Como adicionar o Atli eSIM ao Claude: Connectors, + Add e Add custom connector, depois o nome Atli eSIM e o endereço e, por fim, Sign in when needed com o cliente OAuth recomendado pelo Claude e Add

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.

Como adicionar o Atli eSIM ao Gemini: Settings, Connected Apps, Add a custom app em Custom apps, depois o endereço https://mcp.heyatli.com/r/YOUR_CODE e Next

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.

Como adicionar o Atli eSIM ao Muse: uma conversa nova com a mensagem que pede para adicionar o MCP Atli eSIM por este endereço, seguida do endereço de parceiro e de uma confirmação quando o Muse pede

Claude Code. Um comando adiciona o servidor:

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

Cursor, 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_plans busca por destino, duração, quantidade de dados e moeda. get_plan traz mais detalhes do plano e as redes compatíveis. list_destinations lista os destinos disponíveis, e check_device_support verifica se um celular, tablet ou relógio é compatível com eSIM.
  • Comprar. get_quote obtém o preço final com os descontos aplicáveis. start_purchase cria um pedido e gera um link de pagamento. get_order_status verifica o andamento do pedido, e cancel_order e get_receipt cuidam de cancelamentos e recibos.
  • Depois da compra. get_install_instructions fornece 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_esims obtém os eSIMs do cliente, e refresh_usage atualiza 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:

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);

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.

Perguntas frequentes

O servidor MCP da Atli precisa de chave de API?
Não. O servidor MCP é de acesso público. Os clientes podem consultar planos sem conta, e as contas de convidado são criadas automaticamente quando necessárias para uma compra. Entrar na Atli é opcional.
O assistente pode gastar dinheiro sem perguntar?
Um link de pagamento só é pago quando o cliente conclui o pagamento na página de pagamento da Atli. Para um cartão salvo ou o cartão de um Atli Group, a Atli instrui o assistente a pedir a aprovação do cliente para o preço e o cartão ou o grupo antes de fazer a cobrança. O servidor não garante o cumprimento dessa exigência de forma independente.
Quais assistentes de IA funcionam com ele?
Qualquer um compatível com servidores MCP remotos via Streamable HTTP, incluindo plugins do ChatGPT, conectores personalizados do Claude, apps personalizados do Gemini, Muse, Claude Code, Cursor e VS Code.
Onde a pessoa encontra o eSIM depois?
Nos links de instalação que o assistente envia depois do pagamento. Um abre o eSIM no app da Atli, e o outro o abre em heyatli.com, que o instala e mostra os dados restantes sem conta. Qualquer pessoa com esses links consegue instalar o eSIM, então eles devem ir só para quem vai usá-lo. Clientes convidados também podem voltar à conversa original, e quem comprou com login feito pode acessar os eSIMs pela conta da Atli em outras conversas compatíveis.
Conectar o servidor custa alguma coisa?
Não. Adicionar a Atli a um assistente é grátis, e as pessoas pagam só pelo eSIM que escolherem. O plano do próprio assistente pode limitar quais conectores dá para adicionar.