mailinapp
Documentation menu

Server MCP

MailInApp espone un server MCP così che un client IA esterno — Claude Desktop, Claude Code, o qualsiasi altro strumento compatibile con MCP — possa costruire e modificare i progetti email del tuo account direttamente, nello stesso modo in cui fa il copilota IA integrato nello Studio. È lo stesso nucleo di utilizzo degli strumenti in entrambi i casi: un client MCP e il pannello dello Studio sono semplicemente due porte d'ingresso diverse verso lo stesso identico insieme di modifiche.

Questa pagina copre il percorso per sviluppatori: il tuo stesso backend o strumenti da riga di comando che si autenticano con una Chiave API che generi tu stesso, la stessa credenziale usata dalla Send API.

Endpoint e autenticazione

https://mailinapp.com/api/mcp

Autenticati con la stessa intestazione Authorization: Bearer <apiKey> della Send API — genera o riusa una chiave da Sviluppatori nella dashboard. Non c'è alcuna credenziale separata specifica per MCP da gestire per questo percorso; una chiave rappresenta già "il backend di questo stesso account", quindi qui viene considerata attendibile allo stesso livello, con ogni strumento documentato di seguito disponibile indipendentemente dallo scope.

L'endpoint è stateless: ogni richiesta è una chiamata MCP autonoma, quindi non c'è nulla da mantenere attivo tra un messaggio e l'altro né alcun passaggio separato di connessione/disconnessione oltre alla normale configurazione del tuo client MCP.

Connettere Claude Code

claude mcp add --transport http mailinapp https://mailinapp.com/api/mcp \
  --header "Authorization: Bearer mia_live_..."

Claude Desktop e altri client MCP che supportano un server HTTP remoto usano lo stesso URL e la stessa intestazione — consulta la documentazione del tuo client per sapere dove incollarli.

Strumenti

Una Chiave API è considerata attendibile al pieno livello di proprietario dell'account, quindi vede ogni strumento disponibile — progettazione dei progetti, contatti e soppressioni, risultati delle campagne e ordini, invio (compresi invii reali di campagne, non solo test), risposte a mailbox e ticket, e utilizzo del piano.

Gli strumenti di modifica dell'albero (add_block/update_block/remove_block/move_block/set_theme, e simili) prendono tutti un projectId iniziale (da list_projects/create_project) — un client MCP non ha una scheda dello Studio aperta da cui dedurlo. Ogni tipo di blocco valido, i suoi genitori accettati e il suo elenco di campi sono descritti al modello come parte del set di strumenti tramite list_block_types, così resta sincronizzato con qualsiasi tipo di blocco lo Studio offra attualmente; non è necessario dirgli cosa è disponibile.

Come vengono applicate le modifiche

Ogni chiamata di strumento che modifica dati è una propria scrittura atomica diretta sul progetto — non c'è alcun passaggio di "applica" come nel pannello integrato nello Studio, poiché non c'è alcuna tela aperta a cui applicare le modifiche. Se hai il progetto aperto nello Studio nello stesso momento in cui un client MCP lo modifica, il tuo prossimo salvataggio automatico mostra il normale banner di conflitto "Modificato altrove", esattamente come se un collega del team lo avesse modificato — ricarica per recuperare la modifica proveniente da MCP, oppure salva come copia per conservare le tue modifiche in corso.

Ogni modifica MCP viene anche registrata nel thread di chat del copilota del progetto (contrassegnata come proveniente da MCP, non dal pannello dello Studio), così compare nella stessa cronologia mostrata dal pannello del Copilota IA integrato nello Studio.

Limiti di velocità e disponibilità per piano

  • Per Chiave API: 60 richieste/minuto, indipendentemente dalle altre chiavi sullo stesso account.
  • Per account: ogni chiamata di strumento attinge da un unico contatore mensile (plan.connectorCallsMonthly, separato dall'assegnazione mensile di turni del copilota IA integrato nello Studio, poiché una chiamata MCP non invoca mai un modello IA lato MailInApp). Disponibile con una quota reale su ogni piano, Free incluso — vedi i prezzi per i numeri esatti, oppure chiama get_plan_usage per leggere l'utilizzo del mese corrente del tuo account.
  • Inviare campagne reali tramite questo percorso è misurato allo stesso modo di confirm_send, con lo stesso flusso di conferma e lo stesso limite di volume.