Entwickler

adbtd über MCP

Fügen Sie adbtd als Model-Context-Protocol-Server in Claude Code, Claude Desktop, Cursor oder jedem MCP-kompatiblen Agenten hinzu. Ihr Agent kann Postfächer auflisten, E-Mails senden, Zustellbarkeitsmetriken lesen — ohne dass Sie die REST-API von Hand kapseln.

Eine Server-URL: https://mcp.adbtd.com. OAuth-basierte Autorisierung, jederzeit im Dashboard widerrufbar.

Schritt 1

Server hinzufügen

Eine Zeile in der MCP-Konfiguration Ihres Agenten — siehe unten pro Client.

Schritt 2

Im Browser autorisieren

Beim ersten Verbinden werden Sie zur Freigabe zu adbtd geschickt. Wir erzeugen automatisch einen API-Schlüssel unter Ihrem Konto, versehen mit dem Namen des Agenten.

Schritt 3

Tools verwenden

Ihr Agent kann jetzt list_mailboxes, send_email, get_deliverability und mehr aufrufen.

Installation

Claude Code

Aus Ihrem Terminal:

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

Das Flag --transport http ist erforderlich — ohne es geht Claude Code von einem lokalen stdio-Server aus und kann sich nicht verbinden.

Bei der ersten Verwendung öffnet Claude Code Ihren Browser, um den OAuth-Flow abzuschließen. Bestätigen Sie in Ihrem adbtd-Dashboard, und die Verbindung steht.

Falls Sie den Befehl zuvor ohne das Flag ausgeführt haben, entfernen Sie zuerst den defekten Eintrag: claude mcp remove adbtd.

Claude Desktop

Claude Desktop führt MCP-Server lokal aus. Verwenden Sie die mcp-remote-Brücke, damit es mit einem entfernten HTTP-Server wie unserem sprechen kann. Bearbeiten Sie Ihre Konfiguration (~/Library/Application Support/Claude/claude_desktop_config.json unter macOS; %APPDATA%\Claude\claude_desktop_config.json unter Windows):

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

Starten Sie Claude Desktop neu. Die erste Unterhaltung, die den Server berührt, öffnet Ihren Browser für den OAuth-Flow.

Cursor

In ~/.cursor/mcp.json (oder dem projektbezogenen Gegenstück):

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

Andere MCP-kompatible Agenten

Jeder Agent, der MCP über Streamable HTTP unterstützt, kann https://mcp.adbtd.com verwenden. Der Server spricht OAuth 2.1 mit Dynamic Client Registration — Ihr Agent findet den Auth-Server über die Standard-Metadaten unter /.well-known/oauth-protected-resource.

Agenten, die entferntes MCP nicht nativ sprechen, können die oben für Claude Desktop gezeigte mcp-remote-Brücke verwenden.

Tools

Alle Tools sind auf den Workspace beschränkt — das OAuth-Token Ihres Agenten bindet ihn an einen adbtd-Workspace. Workspace-übergreifender Zugriff ist konstruktionsbedingt unmöglich. Der Satz spiegelt die kundenseitige REST-API eins zu eins — alles, was über /api/v1/* geht, geht auch über MCP.

Tool	was es tut
get_me	Workspace-Infos + Abonnementstatus — entspricht GET /v1/me.
list_mailboxes	Postfächer auflisten, optional nach Domain oder Status gefiltert.
get_mailbox	Ein Postfach per ID abrufen.
create_mailbox	Ein Postfach auf einer verifizierten Domain bereitstellen. Liefert sofort nutzbare SMTP-/IMAP-Details.
delete_mailbox	Ein Postfach per ID endgültig löschen. Unwiderruflich — das Maildir auf der Festplatte wird entfernt.
send_email	E-Mail über eines Ihrer Postfächer per SMTP-Submission senden.
list_messages	Aktuelle Nachrichten eines Postfachs über IMAP abrufen. Paginiert.
get_message	Vollständigen Text + Anhänge einer Nachricht per IMAP-UID abrufen.
list_domains	Domains Ihres Workspace mit SPF-/DKIM-/DMARC-Status auflisten.
add_domain	Eine (eigene) Domain zum Workspace hinzufügen. Die zu veröffentlichenden DNS-Einträge liefert list_domains.
delete_domain	Eine Domain und jedes Postfach darauf entfernen. Unwiderruflich.
list_ips	Dedizierte IPs und ihre RBL-Listungen auflisten.
add_ips	N zusätzliche dedizierte IPs bestellen. Kann eine Stripe-Checkout-URL zurückgeben, wenn eine Aktion nötig ist.
release_ip	Eine dedizierte IP an den Pool zurückgeben. Die Freigabe der letzten IP kündigt das Abonnement.
get_deliverability	Versandvolumen 7d, Ø Spam-Score, Top-Symbole, RBL-Status — dieselben Daten wie /dashboard/deliverability.

Autorisierung

Automatisch bereitgestellt. Sie fügen nie einen API-Schlüssel von Hand ein. Beim ersten Verbinden Ihres Agenten öffnet sich Ihr Browser auf adbtd.com/oauth/authorize — Sie bestätigen, und wir erzeugen einen Schlüssel unter Ihrem Konto.
Sichtbar in Ihrem Dashboard. Jede Verbindung erscheint in /dashboard/api-keys unter "MCP-Verbindungen" mit dem selbst gemeldeten Namen des Agenten (z. B. "Claude Code").
Jederzeit widerrufbar. "Trennen" setzt ein Flag — der nächste MCP-Aufruf dieses Agenten liefert 401. Kein Neustart, keine Verzögerung durch Propagation.
Auf den Workspace beschränkt. Das Token ist an einen Workspace gebunden. Ein Agent kann nie Daten eines anderen Workspace sehen, auflisten oder verändern — auch nicht, wenn er es versucht.
Standardbasiert. OAuth 2.1 + Dynamic Client Registration + PKCE (nur S256). Siehe /.well-known/oauth-authorization-server.
Behandeln Sie das Access-Token wie ein Passwort. Es liegt in der lokalen Konfiguration Ihres Agenten — fügen Sie es nie in Chatfenster, Issue-Tracker oder öffentliche Skripte ein. Falls es durchsickert, trennen Sie die Verbindung im Dashboard und autorisieren Sie neu.

Preise

Kein separater Preis für MCP. Das bestehende Abonnement Ihres Workspace pro Postfach + pro IP deckt die MCP-Nutzung genauso ab wie den Zugriff über REST-API und IMAP/SMTP — siehe Preise.