Adapty Mail exécute un serveur MCP, ce qui permet à un assistant IA de travailler dans votre projet comme vous le faites dans le tableau de bord : générer et localiser des campagnes, lancer des flows, configurer un domaine d’envoi, rechercher des profils et consulter les analyses. L’assistant se connecte avec votre propre compte Adapty Mail et obtient vos permissions dès que vous approuvez la connexion dans le tableau de bord. Aucune clé API n’est nécessaire.

Server URL	https://api-mail.adapty.io/mcp
Protocol	MCP over Streamable HTTP, OAuth 2.1 sign-in
Works with	Claude (web and desktop), ChatGPT, Claude Code, Codex CLI, GitHub Copilot CLI, Gemini CLI, Cursor, Windsurf, and any client that supports remote MCP servers with OAuth

Ce que l’assistant peut faire

Les outils du serveur reflètent le tableau de bord :

Domaine	Exemples
Orientation	Retrouver vos entreprises et projets, identifier les étapes de configuration manquantes
Marque	Créer la marque à partir d’une fiche store, la réviser et la modifier
Domaines d’envoi	Ajouter un domaine, récupérer ses enregistrements DNS, vérifier la validation, consulter l’état du domaine
Destinations	Créer et mettre à jour les pages vers lesquelles pointent vos e-mails
Campagnes	Générer une campagne à partir d’un brief, modifier des e-mails, les traduire, envoyer un e-mail de test
Flows et segments	Créer des segments et lancer ou modifier des flows
Tests A/B	Créer, lancer et terminer des tests
Profils	Rechercher un profil et son parcours, désabonner un profil
Analytics	Métriques de campagne dans le temps, ventilations, entonnoirs de tests A/B
Paramètres	Nom d’expéditeur, adresse de réponse, double opt-in, téléchargements d’images

Trois workflows guidés sont disponibles sous forme de prompts dans les clients qui les prennent en charge. Dans Claude Code, ils apparaissent comme des commandes slash, par exemple /mcp__adaptymail__campaign_to_flow :

• campaign_to_flow : Générer une campagne à partir d’un brief, choisir une destination et un segment, puis lancer le flow.
• campaign_localization : Traduire une campagne enregistrée dans d’autres langues.
• domain_onboarding : Ajouter un domaine d’envoi, publier ses enregistrements DNS et le vérifier.

Certaines étapes de configuration se font uniquement depuis le tableau de bord : votre adresse d’entreprise, le paiement web, et l’activation de l’envoi des données.

Avant de commencer

• Appartenance au projet : Votre compte Adapty Mail est membre du projet sur lequel vous souhaitez travailler. L’assistant ne voit que les entreprises et les projets auxquels votre compte a accès.
• Support client : Votre client prend en charge les serveurs MCP distants avec OAuth.

Connectez votre assistant

Claude (claude.ai et Claude desktop)

1. Pour ajouter le serveur, ouvrez Settings → Connectors et cliquez sur Add custom connector.
2. Saisissez un nom, par exemple Adapty Mail, et l’URL https://api-mail.adapty.io/mcp.
3. Laissez Authentication sur Sign in now et le client OAuth sur la valeur détectée par défaut, puis cliquez sur Add.
4. Dans l’onglet Adapty Mail qui s’ouvre, connectez-vous si nécessaire, puis cliquez sur Approve.

Les administrateurs de l’espace de travail peuvent ajouter le connecteur une seule fois pour toute l’organisation. Chaque membre se connecte ensuite avec son propre compte Adapty Mail la première fois qu’il l’utilise.

ChatGPT

ChatGPT ajoute des serveurs MCP personnalisés depuis la page des connecteurs dans Settings. Le mode développeur doit être activé pour votre espace de travail.

1. Pour ajouter le serveur, cliquez sur Create.
2. Entrez un nom, par exemple Adapty Mail, et l’URL du serveur https://api-mail.adapty.io/mcp. Laissez Authentication sur OAuth.
3. Acceptez l’avertissement concernant le serveur MCP personnalisé et cliquez sur Create.
4. Quand ChatGPT vous le demande, connectez le serveur. Dans l’onglet Adapty Mail qui s’ouvre, connectez-vous si nécessaire, puis cliquez sur Approve.

Claude Code

claude mcp add --transport http --scope user adaptymail https://api-mail.adapty.io/mcp

Pour vous connecter, exécutez /mcp dans Claude Code, sélectionnez adaptymail, puis choisissez Authenticate. Connectez-vous ensuite au tableau de bord Adapty Mail dans votre navigateur et cliquez sur Approve.

Codex CLI

codex mcp add adaptymail --url https://api-mail.adapty.io/mcp
codex mcp login adaptymail

La commande de connexion ouvre votre navigateur, où vous approuvez la connexion. Pour configurer le serveur manuellement, ajoutez-le dans ~/.codex/config.toml, puis exécutez la commande de connexion :

[mcp_servers.adaptymail]
url = "https://api-mail.adapty.io/mcp"

GitHub Copilot CLI

copilot mcp add --transport http adaptymail https://api-mail.adapty.io/mcp

La première fois que le serveur se connecte, votre navigateur s’ouvre pour la connexion.

Gemini CLI

gemini mcp add --transport http --scope user adaptymail https://api-mail.adapty.io/mcp

Démarrez une nouvelle session, puis exécutez /mcp auth adaptymail et approuvez la connexion dans votre navigateur.

Cursor, Windsurf et autres clients

Ajoutez le serveur dans le fichier de configuration MCP du client, par exemple ~/.cursor/mcp.json :

{
  "mcpServers": {
    "adaptymail": {
      "url": "https://api-mail.adapty.io/mcp"
    }
  }
}

Le client ouvre votre navigateur pour vous connecter lors de la première connexion. Les clients qui ne prennent pas en charge OAuth pour les serveurs distants ne peuvent pas se connecter à Adapty Mail.

Approuver la connexion

Chaque client se termine sur le même écran dans le tableau de bord Adapty Mail. Il indique l’application qui demande l’accès et l’adresse à laquelle elle reçoit cet accès. Pour les outils de bureau, cette adresse se trouve sur votre propre ordinateur (localhost), donc n’approuvez que la connexion que vous avez vous-même initiée. Pour terminer, cliquez sur Approve.

La demande de connexion expire après 10 minutes. Si l’écran affiche This request has expired, recommencez depuis le client.

Commencer à travailler

Demandez à l’assistant de lister vos projets, puis nommez celui sur lequel vous souhaitez travailler. Quelques exemples de requêtes :

• « Montre-moi le statut d’onboarding de mon projet et dis-moi ce qui manque. »
• « Génère une campagne de reconquête pour les utilisateurs dont l’essai a expiré, en anglais, et montre-moi le premier e-mail. »
• « Traduis la campagne Trial expired en allemand et en français. »
• « Ajoute mail.example.com comme domaine d’envoi et donne-moi les enregistrements DNS. »
• « Compare les taux d’ouverture et de clic de mes campagnes en ligne sur les 30 derniers jours. »

Déconnexion

Pour vous déconnecter, supprimez le connecteur dans les paramètres du client. Dans Claude, rendez-vous dans Settings → Connectors ; dans ChatGPT, sur la page du connecteur ; dans Claude Code, exécutez claude mcp remove adaptymail.

Le token d’accès du client expire en moins d’une heure. Le token de rafraîchissement est révoqué lors de la déconnexion du client ; un token inutilisé expire au bout de 90 jours. Pour vous reconnecter, ajoutez à nouveau le serveur et approuvez la connexion.

Résolution des problèmes

Problème	Solution
Le tableau de bord indique que la demande de connexion a expiré	Relancez la connexion depuis le client et approuvez-la dans les 10 minutes.
L’assistant indique que le projet est introuvable	Votre compte n’est pas membre de ce projet. Demandez l’accès au propriétaire de la société.
L’assistant a été déconnecté	L’accès expire après une longue période d’inactivité ou après une déconnexion. Reconnectez-vous depuis le client.
Le client n’affiche aucun outil	Le client s’est connecté sans être authentifié. Lancez l’étape de connexion, par exemple /mcp dans Claude Code.