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 Mia AI 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, lo Studio lo tratta come la modifica di un collega: le modifiche ad altri blocchi vengono unite al salvataggio e, se avete cambiato entrambi lo stesso blocco, il salvataggio automatico si ferma e propone Mostra il blocco, Ricarica la versione più recente o Salva come copia.
Ogni modifica MCP viene anche registrata nel thread di chat di Mia AI del progetto (contrassegnata come proveniente da MCP, non dal pannello dello Studio), così compare nella stessa cronologia mostrata dal pannello di Mia AI 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 di Mia AI 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 chiamaget_plan_usageper 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.