Come collegare Smartlead a Microsoft Copilot via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Smartlead, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Smartlead + Microsoft Copilot

Cold email outreach con Smartlead da qualsiasi agente AI: crea e gestisci campagne con sequenze e programmazioni, aggiungi e gestisci i lead e le loro categorie, leggi e rispondi alle risposte nella master inbox, confronta le statistiche di campagne e account e controlla caselle mittenti e warmup. Funziona con una chiave API di Smartlead; disiscrizioni definitive ed eliminazioni sono disattivate all'installazione.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

SMARTLEAD_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. L'accesso API richiede un piano Smartlead a pagamento.

1. In Smartlead apri Settings e la sezione API Keys (in alcuni piani si trova in Settings, Integrations).
2. Copia la chiave API in SMARTLEAD_API_KEY. Il connettore la aggiunge a ogni richiesta come parametro di query api_key, quindi incolla solo la chiave.
3. Installa il connettore ed esegui smartlead_list_campaigns: elenca le tue campagne e conferma la chiave.

La chiave dà accesso completo all'account: trattala come una password.

Campagne: si parte da smartlead_list_campaigns, perché l'id di ogni campagna è il campaign_id di tutti gli altri strumenti. smartlead_get_campaign, smartlead_get_campaign_sequences e smartlead_list_campaign_email_accounts ne mostrano la configurazione. Per crearne una l'AI concatena smartlead_create_campaign (una campagna vuota in stato DRAFTED), smartlead_save_campaign_sequences, smartlead_update_campaign_schedule (fuso orario, giorni della settimana, finestra di invio, minuti tra un'email e l'altra, nuovi lead al giorno, ora di inizio), smartlead_update_campaign_settings (nome, tracciamento di aperture e clic, quando smettere di scrivere a un lead, solo testo, percentuale di follow-up, abbinamento AI delle caselle, testo di disiscrizione), smartlead_add_email_accounts_to_campaign e smartlead_add_leads_to_campaign, poi smartlead_update_campaign_status con START. Gli stati sono START (non ACTIVE), PAUSED, STOPPED (definitivo; per una pausa usa PAUSED) e ARCHIVED. Avviare una campagna invia email vere, quindi fatti mostrare prima sequenza, programmazione e numero di lead.

Sequenze: smartlead_save_campaign_sequences sostituisce l'intera sequenza: i passaggi omessi vengono rimossi. L'AI la legge prima con smartlead_get_campaign_sequences, mantiene gli id dei passaggi esistenti e invia tutti i passaggi. Si personalizza con {{first_name}}, {{company_name}} e i nomi dei tuoi campi personalizzati.

Lead:

• smartlead_list_campaign_leads elenca i lead di una campagna. Ogni riga ha l'id della mappa campagna-lead (l'id della riga, usato da smartlead_create_lead_note) e il lead stesso (lead.id, usato come lead_id).
• smartlead_get_lead_by_email trova un lead in tutte le campagne, smartlead_get_lead lo legge per id, smartlead_get_lead_campaign_overview mostra tutte le campagne in cui si trova.
• smartlead_add_leads_to_campaign accetta al massimo 400 lead per chiamata. I lead nella block list globale, disiscritti o già in altre campagne vengono saltati, salvo diversa impostazione; la risposta conta i lead caricati, duplicati e bloccati.
• Modifiche: smartlead_update_lead (l'API vuole l'email anche se non cambia; fino a 200 campi personalizzati), smartlead_update_lead_category (id da smartlead_list_lead_categories, con pausa opzionale), smartlead_pause_lead, smartlead_resume_lead (subito o dopo alcuni giorni) e smartlead_unsubscribe_lead_from_campaign per una sola campagna.

Risposte: smartlead_list_inbox_replies elenca le risposte della master inbox su tutte le campagne, dalla più recente, filtrate per campagna, casella, categoria o ora della risposta; smartlead_get_inbox_item apre un thread. Per rispondere, smartlead_get_lead_message_history dà stats_id, message_id e time di ogni messaggio; l'AI li passa come email_stats_id, reply_message_id e reply_email_time a smartlead_reply_to_lead. La risposta parte dalla casella di quel thread, subito o a uno scheduled_time. smartlead_create_lead_note aggiunge una nota interna.

Statistiche: per campagna smartlead_get_campaign_analytics (totali complessivi e avanzamento dei lead), smartlead_get_campaign_analytics_by_date, smartlead_get_campaign_sequence_analytics (per passaggio e variante A/B) e smartlead_get_campaign_statistics (una riga per email inviata). smartlead_get_overall_analytics copre l'intero account, eventualmente limitato ad alcune campagne o clienti.

Caselle e warmup: smartlead_list_email_accounts mostra indirizzo, provider, limiti giornalieri, stato SMTP/IMAP e warmup; una connessione guasta ha isSmtpSuccess=false. Poi smartlead_get_email_account, smartlead_get_warmup_stats (ultimi 7 giorni: email di warmup inviate, finite in inbox, finite in spam, risposte), smartlead_update_email_account (limite giornaliero, nome mittente, firma, BCC, dominio di tracciamento personalizzato, minuti tra le email) e smartlead_update_warmup (attivo o no, volume giornaliero, crescita, tasso di risposta).

Webhook, agenzie e liste: smartlead_list_campaign_webhooks e smartlead_upsert_campaign_webhook (ne crea uno, o lo aggiorna se passi id) con gli eventi EMAIL_SENT, EMAIL_OPEN, EMAIL_LINK_CLICK, EMAIL_REPLY, EMAIL_BOUNCE, LEAD_UNSUBSCRIBED e LEAD_CATEGORY_UPDATED. smartlead_list_clients dà gli id dei clienti di un account agenzia (white label); smartlead_list_lead_lists elenca le liste di lead.

Disattivati all'installazione: smartlead_unsubscribe_lead_globally (disiscrive il lead da tutte le campagne e blocca le importazioni future dell'indirizzo), smartlead_delete_lead_from_campaign (rimuove il lead e il suo avanzamento da quella campagna) e smartlead_delete_campaign_webhook. Non si possono annullare, quindi un admin del workspace li attiva quando servono al team.

Formati dei dati: i conteggi sono numeri di email o di lead; i tassi sono percentuali. Le date delle statistiche sono YYYY-MM-DD, con un fuso IANA opzionale (predefinito UTC) per i confini del giorno. I timestamp sono ISO 8601 in UTC, salvo che si passi un fuso.

Paginazione: gli elenchi accettano offset (predefinito 0) e limit (predefinito 100; l'inbox 20). L'AI aumenta offset di limit finché tornano meno righe di limit; smartlead_list_campaign_leads restituisce anche total_leads.

Limiti ed errori comuni: Smartlead rallenta i picchi di richieste (circa 10 richieste ogni 2 secondi nei piani standard) e risponde 429; aspetta e riprova. 401 Invalid API Key indica una chiave errata, 404 un id errato o di un altro account, e 400 indica il campo non valido.

Il connettore non collega nuove caselle mittenti e non elimina campagne.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Microsoft Copilot

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.

1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
4. In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di Smartlead.
6. Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.

Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.

Tool disponibili

Esempi di prompt

• "Quale delle mie campagne attive ha il miglior tasso di risposta questo mese? Mostra per ognuna invii, risposte e bounce."
• "Mostrami le risposte delle ultime 24 ore classificate come Interested."
• "Rispondi all'ultima email di [email protected] nella campagna Q4 Outreach e proponi una chiamata la settimana prossima. Mostrami il testo prima di inviarlo."
• "Quali caselle mittenti hanno una connessione SMTP guasta o molte email di warmup finite in spam?"
• "Metti in pausa il lead [email protected] in tutte le campagne in cui si trova."

FAQ

Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.

Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.

L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse