développeur

adbtd via MCP

Ajoutez adbtd comme serveur Model Context Protocol dans Claude Code, Claude Desktop, Cursor ou tout agent compatible MCP. Votre agent peut lister les boîtes mail, envoyer des e-mails, lire les métriques de délivrabilité — sans que vous ayez à envelopper l’API REST à la main.

Une seule URL de serveur : https://mcp.adbtd.com. Autorisation OAuth, révocable à tout moment depuis votre tableau de bord.

étape 1

Ajoutez le serveur

Une ligne dans la config MCP de votre agent — voir ci-dessous par client.

étape 2

Autorisez dans le navigateur

À la première connexion, vous serez envoyé sur adbtd pour approuver. Nous créons automatiquement une clé API sous votre compte, avec le nom de l’agent attaché.

étape 3

Utilisez les outils

Votre agent peut maintenant appeler list_mailboxes, send_email, get_deliverability et plus encore.

Installation

Claude Code

Depuis votre terminal :

claude mcp add --transport http adbtd https://mcp.adbtd.com

L’option --transport http est obligatoire — sans elle, Claude Code suppose un serveur local en stdio et échoue à se connecter.

À la première utilisation, Claude Code ouvre votre navigateur pour compléter le flux OAuth. Approuvez dans votre tableau de bord adbtd, et la connexion est prête.

Si vous avez déjà lancé la commande sans l’option, supprimez d’abord l’entrée cassée : claude mcp remove adbtd.

Claude Desktop

Claude Desktop exécute les serveurs MCP en local. Utilisez le pont mcp-remote pour qu’il puisse parler à un serveur HTTP distant comme le nôtre. Modifiez votre config (~/Library/Application Support/Claude/claude_desktop_config.json sur macOS ; %APPDATA%\Claude\claude_desktop_config.json sur Windows) :

{
  "mcpServers": {
    "adbtd": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.adbtd.com"]
    }
  }
}

Redémarrez Claude Desktop. La première conversation qui touche le serveur ouvre votre navigateur pour le flux OAuth.

Cursor

Dans ~/.cursor/mcp.json (ou l’équivalent par projet) :

{
  "mcpServers": {
    "adbtd": {
      "url": "https://mcp.adbtd.com"
    }
  }
}

Autres agents compatibles MCP

Tout agent prenant en charge MCP sur Streamable HTTP peut utiliser https://mcp.adbtd.com. Le serveur parle OAuth 2.1 avec Dynamic Client Registration — votre agent découvrira le serveur d’autorisation via les métadonnées standard /.well-known/oauth-protected-resource.

Les agents qui ne parlent pas MCP distant nativement peuvent utiliser le pont mcp-remote montré ci-dessus pour Claude Desktop.

Outils

Tous les outils sont limités à un espace de travail — le jeton OAuth détenu par votre agent le lie à un seul espace de travail adbtd. L’accès inter-espaces est impossible par construction. L’ensemble reflète un pour un l’API REST client — tout ce que vous pouvez faire via /api/v1/*, vous pouvez le faire via MCP.

outil	ce qu’il fait
get_me	Infos de l’espace de travail + état de l’abonnement — équivalent de GET /v1/me.
list_mailboxes	Liste les boîtes mail, avec filtre optionnel par domaine ou statut.
get_mailbox	Récupère une boîte mail par id.
create_mailbox	Provisionne une boîte mail sur un domaine vérifié. Renvoie les détails SMTP/IMAP prêts à l’emploi.
delete_mailbox	Supprime définitivement une boîte mail par id. Irréversible — le maildir sur disque est effacé.
send_email	Envoie un e-mail via l’une de vos boîtes mail, par soumission SMTP.
list_messages	Récupère les messages récents d’une boîte mail via IMAP. Paginé.
get_message	Récupère le corps complet + les pièces jointes d’un message par UID IMAP.
list_domains	Liste les domaines de votre espace de travail avec le statut SPF/DKIM/DMARC.
add_domain	Ajoute un domaine (le vôtre) à votre espace de travail. Les enregistrements DNS à publier sont renvoyés par list_domains.
delete_domain	Supprime un domaine et toutes ses boîtes mail. Irréversible.
list_ips	Liste les IP dédiées et leurs listages RBL.
add_ips	Commande N IP dédiées supplémentaires. Peut renvoyer une URL de paiement Stripe si une action est requise.
release_ip	Libère une IP dédiée vers le pool. Libérer la dernière IP annule l’abonnement.
get_deliverability	Volume envoyé sur 7j, score de spam moyen, principaux symboles, statut RBL — les mêmes données que /dashboard/deliverability.

Autorisation

Auto-provisionnée. Vous ne collez jamais de clé API. La première fois que votre agent se connecte, votre navigateur s’ouvre sur adbtd.com/oauth/authorize — vous approuvez, et nous créons une clé sous votre compte.
Visible dans votre tableau de bord. Chaque connexion apparaît dans /dashboard/api-keys sous “connexions mcp” avec le nom que l’agent déclare lui-même (ex. “Claude Code”).
Révocable à tout moment. “Déconnecter” bascule un drapeau — le tout prochain appel MCP de cet agent renvoie 401. Pas de redémarrage, pas de délai de propagation.
Limitée à l’espace de travail. Le jeton est lié à un seul espace de travail. Un agent ne peut jamais voir, lister ou manipuler les données d’un autre espace de travail, même en essayant.
Basée sur des standards. OAuth 2.1 + Dynamic Client Registration + PKCE (S256 uniquement). Voir /.well-known/oauth-authorization-server.
Traitez le jeton d’accès comme un mot de passe. Il vit dans la config locale de votre agent — ne le collez jamais dans une fenêtre de chat, un gestionnaire de tickets ou un script public. S’il fuit, déconnectez-le depuis le tableau de bord et réautorisez.

Tarifs

Pas de tarif séparé pour MCP. L’abonnement existant de votre espace de travail (par boîte mail + par IP) couvre l’usage MCP de la même façon qu’il couvre l’accès à l’API REST et à IMAP/SMTP — voir tarifs.