developer

adbtd via MCP

Aggiungi adbtd come server Model Context Protocol in Claude Code, Claude Desktop, Cursor o qualsiasi agente compatibile MCP. Il tuo agente può elencare caselle, inviare posta, leggere le metriche di deliverability — senza che tu debba incapsulare a mano l’API REST.

Un solo URL server: https://mcp.adbtd.com. Autorizzazione OAuth, revocabile dalla dashboard in qualsiasi momento.

passo 1

Aggiungi il server

Una riga nella configurazione MCP del tuo agente — vedi sotto per ogni client.

passo 2

Autorizza nel browser

Alla prima connessione verrai reindirizzato su adbtd per approvare. Generiamo automaticamente una chiave API nel tuo account con il nome dell’agente associato.

passo 3

Usa i tool

Il tuo agente può ora chiamare list_mailboxes, send_email, get_deliverability e altri.

Installazione

Claude Code

Dal terminale:

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

Il flag --transport http è obbligatorio — senza, Claude Code presume un server locale via stdio e non riesce a connettersi.

Al primo utilizzo, Claude Code apre il browser per completare il flusso OAuth. Approva nella tua dashboard adbtd e la connessione è pronta.

Se in precedenza hai eseguito il comando senza il flag, rimuovi prima la voce non funzionante: claude mcp remove adbtd.

Claude Desktop

Claude Desktop esegue i server MCP in locale. Usa il bridge mcp-remote perché possa parlare con un server HTTP remoto come il nostro. Modifica la configurazione (~/Library/Application Support/Claude/claude_desktop_config.json su macOS; %APPDATA%\Claude\claude_desktop_config.json su Windows):

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

Riavvia Claude Desktop. La prima conversazione che usa il server apre il browser per il flusso OAuth.

Cursor

In ~/.cursor/mcp.json (o l’equivalente per progetto):

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

Altri agenti compatibili MCP

Qualsiasi agente che supporta MCP su Streamable HTTP può usare https://mcp.adbtd.com. Il server parla OAuth 2.1 con Dynamic Client Registration — il tuo agente scoprirà l’auth server dai metadati standard /.well-known/oauth-protected-resource.

Gli agenti che non parlano MCP remoto nativamente possono usare il bridge mcp-remote mostrato sopra per Claude Desktop.

Tool

Tutti i tool sono limitati al workspace — il token OAuth del tuo agente lo lega a un solo workspace adbtd. L’accesso tra workspace è impossibile per costruzione. L’insieme rispecchia uno a uno l’API REST per i clienti — tutto ciò che puoi fare via /api/v1/* lo puoi fare via MCP.

tool	cosa fa
get_me	Info workspace + stato abbonamento — equivalente a GET /v1/me.
list_mailboxes	Elenca le caselle, con filtro opzionale per dominio o stato.
get_mailbox	Recupera una casella per id.
create_mailbox	Crea una casella su un dominio verificato. Restituisce i dettagli SMTP/IMAP pronti all’uso.
delete_mailbox	Elimina definitivamente una casella per id. Irreversibile — la maildir su disco viene cancellata.
send_email	Invia posta da una delle tue caselle via SMTP submission.
list_messages	Recupera i messaggi recenti di una casella via IMAP. Paginato.
get_message	Recupera corpo completo + allegati di un messaggio per UID IMAP.
list_domains	Elenca i domini del tuo workspace con stato SPF/DKIM/DMARC.
add_domain	Aggiunge un dominio (BYO) al tuo workspace. I record DNS da pubblicare sono restituiti da list_domains.
delete_domain	Rimuove un dominio e ogni casella su di esso. Irreversibile.
list_ips	Elenca gli IP dedicati e le loro listature RBL.
add_ips	Ordina N IP dedicati aggiuntivi. Può restituire un URL di checkout Stripe se serve un’azione.
release_ip	Rilascia un IP dedicato al pool. Rilasciare l’ultimo IP annulla l’abbonamento.
get_deliverability	Volume inviato a 7g, punteggio spam medio, simboli principali, stato RBL — gli stessi dati di /dashboard/deliverability.

Autorizzazione

Provisioning automatico. Non incolli mai una chiave API. La prima volta che il tuo agente si connette, il browser si apre su adbtd.com/oauth/authorize — approvi, e generiamo una chiave nel tuo account.
Visibile nella dashboard. Ogni connessione compare in /dashboard/api-keys sotto "connessioni mcp" con il nome dichiarato dall’agente (es. "Claude Code").
Revoca quando vuoi. "Disconnetti" cambia un flag — la chiamata MCP successiva di quell’agente riceve un 401. Nessun riavvio, nessun ritardo di propagazione.
Limitato al workspace. Il token è legato a un solo workspace. Un agente non può mai vedere, elencare o agire su dati di un altro workspace, nemmeno provandoci.
Basato su standard. OAuth 2.1 + Dynamic Client Registration + PKCE (solo S256). Vedi /.well-known/oauth-authorization-server.
Tratta l’access token come una password. Vive nella configurazione locale del tuo agente — non incollarlo mai in chat, issue tracker o script pubblici. Se trapela, disconnettilo dalla dashboard e riautorizza.

Prezzi

Nessun prezzo separato per MCP. L’abbonamento per casella + per IP del tuo workspace copre l’uso di MCP così come copre l’API REST e l’accesso IMAP/SMTP — vedi prezzi.