Guide all'integrazione
Guida all'API di LinkedIn
Guida all'API email
Guida all'API di WhatsApp
Contatta le vendite
Claude Code · Server MCP
Server MCP per Claude Code: messaggistica ed email nella sua app
Un solo comando claude mcp add collega il Server MCP Unipile. Claude Code costruisce poi funzionalità LinkedIn, WhatsApp ed email nel suo progetto e testa ogni chiamata sulla sua applicazione Development. Niente da installare o avviare in locale.
Prova gratuita di 7 giorni, senza carta di credito.
Claude Code · crm-app
Unipile MCP connesso
Aggiungi la connessione dell'account LinkedIn al mio CRM.
Lettura endpointPOST /v2/auth/linkschema caricato
Aggiunti la route di connessione e il pulsante Settings. L'account ID viene salvato sull'utente.
Descriva la prossima funzionalità…
Caso d'uso
Aggiunga LinkedIn, WhatsApp ed email al suo prodotto da Claude Code
Aggiunga LinkedIn, WhatsApp, email o calendario al suo prodotto. Tramite il Server MCP Unipile, Claude Code legge il riferimento API, scrive il codice nel suo stack e testa ogni richiesta.
Connettere il server MCP Unipile a Claude CodeUnipile MCP connesso
Selezioni i canali da connettere
developer.unipile.com/mcpConnetti tutti i canali10 canali
↑↓naviga spazioseleziona ↵connettiun URL, un header
claude mcp add, tre scope
Aggiungere il server MCP Unipile a Claude Code
Il server è remoto: un URL in streamable HTTP e un header, nulla da eseguire in locale. Un solo comando lo registra; lo scope scelto decide dove viene caricato.
Prima di iniziare: Claude Code installato e con accesso effettuato, un'applicazione Development nella dashboard Unipile con una scoped Account API key e un account di test collegato tramite Hosted Auth.
Scope user--scope user · tutti i progetti, privato
Scope project.mcp.json nella radice del repository, condiviso
Scope local (predefinito)solo questo progetto, privato, in ~/.claude.json
?
Quale scope?User per tutti i progetti, project per condividere .mcp.json con il team, local per una prova una tantum.
# Scope user: tutti i progetti su questa macchina, privato
claude mcp add --transport http --scope user \
unipile "https://developer.unipile.com/mcp?branch=v2.0" \
--header "X-API-KEY: your-scoped-api-key"
# Claude Code stampa "Added …", poi: claude mcp list
// Scope project: committato nella radice del repository, condiviso con il team
{
"mcpServers": {
"unipile": {
"type": "http",
"url": "https://developer.unipile.com/mcp?branch=v2.0",
"headers": {
"X-API-KEY": "${UNIPILE_API_KEY}"
}
}
}
}
// "type": "http" è obbligatorio; ogni sviluppatore esporta UNIPILE_API_KEY
# Scope local (predefinito): solo questo progetto, privato, salvato in ~/.claude.json
claude mcp add --transport http \
unipile "https://developer.unipile.com/mcp?branch=v2.0" \
--header "X-API-KEY: your-scoped-api-key"
Verificato su Claude Code 2.1. Metta l'URL tra virgolette (zsh interpreta il ? come pattern) e lasci --header per ultimo.
Verificare la connessione
- 1Dal terminale,
claude mcp listmostra ✔ Connected eclaude mcp get unipilei dettagli. - 2Dentro una sessione,
/mcpmostra lo stato e approva la prima volta un .mcp.json con scope project. - 3In una chat, chieda
Usando l'MCP di Unipile, elenca gli endpoint per la ricerca di persone su LinkedIn e i loro parametri obbligatorie si aspetti route reali in risposta.
Prompt, non codice di collegamento
Dia il prompt al suo agente
Tre integrazioni, ciascuna con il prompt da incollare in Claude Code, gli endpoint che l'agente esegue su
https://api.unipile.com con la sua X-API-KEY e ciò che arriva nel suo progetto.Aggiungi la messaggistica WhatsApp alla nostra console di assistenza: sincronizza le conversazioni di ogni operatore e permettigli di rispondere dal ticket.
Ricerca endpoint"chats messages send"3 risultati
Esecuzione richiestaGET /v2/{account_id}/chats9 chat
Creati
whatsapp/chat-sync.ts (chat e messaggi salvati sul ticket, paginazione a cursore) e POST /tickets/:id/reply che chiama la route di invio sull'account della chat stessa. Sync eseguita sull'app Development: 9 chat, 41 messaggi.Una inbox WhatsApp nel suo prodotto, con un solo prompt
Claude Code legge i contratti di chat e messaggi, scrive il job di sincronizzazione e l'endpoint di risposta ed esegue le prime richieste sulla sua applicazione Development. LinkedIn, Instagram, Facebook e Telegram usano le stesse route di chat.
Endpoint usati dall'agente
API WhatsApp
GET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
Permetti agli utenti di inviare email dalla pagina del contatto tramite la propria casella Gmail o Outlook, e raggruppa le risposte in thread sul contatto.
Lettura endpointPOST /v2/{account_id}/emails/sendschema caricato
Esecuzione richiestaGET /v2/{account_id}/emails200 OK
Aggiunta
POST /contacts/:id/email che chiama la route di invio sull'account della casella dell'utente, l'opzione di risposta nel thread tramite il thread ID e la sincronizzazione in entrata che collega le risposte al contatto. Inviata un'email di test dalla casella dell'app Development e verificata la risposta nel thread.Email dalla casella dell'utente, in thread nel suo CRM
Gmail, Outlook e IMAP condividono un unico schema email. L'agente collega l'azione di invio alla casella che l'utente ha connesso e conserva il thread ID, così le risposte arrivano sul contatto giusto.
Endpoint usati dall'agente
API Email
POST/v2/{account_id}/emails/sendGET/v2/{account_id}/emailsGET/v2/{account_id}/threads/{thread_id}
Ogni workspace del mio SaaS ha diversi utenti con i propri account LinkedIn ed email. Isolali: uno Scope e una chiave scoped per workspace.
Ricerca endpoint"scopes api-keys"4 risultati
Esecuzione richiestaPOST /v2/scopes/201 · scope
Alla creazione di un workspace il backend ora crea uno Scope e una chiave API Account scoped salvata cifrata sul workspace, e ogni account collegato da un membro viene assegnato a quello Scope. Tutte le chiamate sugli account usano la chiave del workspace. Testato con due workspace sull'app Development.
Molti utenti, molti account, un perimetro per tenant
Una chiave scoped vede solo gli account assegnati al proprio Scope. L'agente trasforma questo confine nel suo modello di tenant, così la logica multi-account vive nell'API, non nel suo codice.
Endpoint usati dall'agente
Account, Scope e chiavi
POST/v2/scopes/POST/v2/api-keys/GET/v2/accounts/
Prima un'applicazione Development Dia a Claude Code una chiave scoped di un'applicazione Development, separata da quella di Produzione.
Account di test, richieste reali L'agente esegue richieste su account di test, per conto dell'utente autenticato che li ha collegati, nei limiti di ogni provider.
Validare ogni flusso Controlli il flusso di connessione, una lettura e una scrittura per funzionalità e una consegna webhook.
Poi passare alla Produzione Nulla tocca gli account dei suoi utenti finché non cambia la chiave. Veda sicurezza e conformità.
Troubleshooting
Errori frequenti e cosa significano
Gli stati che claude mcp list e /mcp mostrano quando una voce non è corretta, e come risolverli.
✘ Failed to connect
Usi esattamente https://developer.unipile.com/mcp?branch=v2.0 con --transport http, poi verifichi con claude mcp get unipile.
⏸ Pending approval
Esegua claude nella cartella, accetti la finestra di attendibilità del workspace, poi approvi il server da /mcp.
401 sulle richieste
Invii una scoped Account API key della sua applicazione Development, con il nome di header esatto X-API-KEY.
Avviso di variabile mancante
Esporti UNIPILE_API_KEY nella shell che avvia Claude Code, oppure imposti un valore predefinito con ${UNIPILE_API_KEY:-}.
Spazi nascosti in headers.X-API-KEY
Aggiunga di nuovo il server con la chiave senza spazi: Claude Code usa i valori esattamente come sono scritti.
Stesso nome in più di uno scope
Tenga una sola definizione, ad esempio con claude mcp remove unipile --scope user: local prevale su project, poi su user.
MCP endpoint not found at <origin>
Usi l'URL completo https://developer.unipile.com/mcp?branch=v2.0, lo verifichi con curl -I, poi esegua claude mcp get unipile.
/mcp mostra No MCP servers configured
Usi ~/.claude.json o .mcp.json nella radice del progetto, mai ~/.claude/mcp.json, poi riavvii la sessione.
La shell rifiuta l'URL, oppure manca branch
Metta sempre l'URL tra virgolette in claude mcp add, altrimenti zsh risponde "no matches found" e bash può perdere il parametro.
Avvio lento o timeout
Alzi il limite per la sessione con MCP_TIMEOUT=60000 claude.
6000+
Aziende che innovano con Unipile
Fiducia da parte dei leader del settore
1 API
Semplificare le operazioni per tutti i principali canali di comunicazione
2 giorni
Integrazione rapida con una configurazione minima
30%
Riduzione dell'impegno e delle risorse per la manutenzione
Sicurezza e conformità integrate
Protezione di livello aziendale per i vostri dati e flussi di lavoro Per saperne di più sulla nostra sicurezza
SOC 2 Tipo II
Certificato
Controlli di sicurezza verificati in modo indipendente che garantiscono la protezione dei dati e l'integrità operativa.
GDPR
Conforme
Piena conformità alle normative europee sulla protezione dei dati per la privacy degli utenti.
99.9%
Uptime della piattaforma negli ultimi 24 mesi
24/7
Supporto globale con API ad alte prestazioni
FAQ server MCP Claude Code
Le domande che si pongono davvero: gli scope, dove vive la configurazione, come tenere le chiavi fuori dal repository, header personalizzati, Failed to connect, virgolette nell'URL, modifiche a .mcp.json e chiavi API.
Local è il valore predefinito: salvato in
~/.claude.json sotto il progetto corrente, privato e limitato a quel progetto. Project scrive .mcp.json nella radice del repository ed è condiviso tramite il controllo di versione. User scrive ~/.claude.json sotto la chiave radice mcpServers e vale per tutti i suoi progetti. La precedenza è local, poi project, poi user. Per Unipile: --scope user per la sua chiave di sviluppo personale, --scope project quando tutto il team lavora sulla stessa integrazione.In
~/.claude.json (su Windows %USERPROFILE%\.claude.json) per gli scope local e user, e in .mcp.json nella radice del progetto per lo scope project. Claude Code non legge ~/.claude/.mcp.json, ~/.claude/config/mcp.json, ~/.claude/mcp.json o %APPDATA%\Claude\mcp.json. claude mcp get unipile le indica in quale scope si trova una voce.Claude Code espande
${VAR} e ${VAR:-default} in command, args, env, url e headers. Scriva "X-API-KEY": "${UNIPILE_API_KEY}" in .mcp.json, committi il file, e ogni sviluppatore fornisce la propria chiave scoped tramite il proprio ambiente. Se la variabile non è impostata e non ha un valore predefinito, la configurazione si carica comunque e claude mcp list mostra un avviso.Sì:
--header "X-API-KEY: your-scoped-api-key", ripetibile per più header, forma breve -H. Lo metta dopo l'URL, perché il flag accetta più valori. Il server Unipile è un server HTTP remoto: niente da installare in locale, niente npx, nessuna versione di Node da gestire.Esegua
claude mcp get unipile per il dettaglio (stato HTTP e testo dell'errore), controlli gli avvisi su spazi iniziali o finali che claude mcp list stampa dopo una chiave incollata, e confermi che l'URL risponde dalla sua macchina con curl -I. Un 404 stampa MCP endpoint not found at <origin>: il percorso è sbagliato, l'URL completo è https://developer.unipile.com/mcp?branch=v2.0, parametro branch incluso.L'URL contiene un
?, che zsh legge come carattere di pattern. Metta sempre l'URL tra virgolette in claude mcp add. Senza virgolette, zsh risponde "no matches found" e bash può eliminare il parametro branch , il che la connette alla versione sbagliata del server.Claude Code legge
.mcp.json all'avvio della sessione: esca e riavvii. Una voce malformata viene ignorata in silenzio, e claude mcp list stampa l'avviso di parsing con il campo errato. Se ha rifiutato il server alla richiesta di approvazione del progetto, esegua claude mcp reset-project-choices.Il server risponde senza chiave quando l'agente si limita a leggere la specifica dell'API. Per eseguire richieste reali, crei uno Scope nella sua applicazione Development, vi assegni solo gli account interessati e generi una chiave API Account scoped per quello Scope. Non dia mai a un client MCP una chiave Service o una chiave Account globale.