IT
Cursor · Server MCP

Server MCP per Cursor: messaggistica ed email nel suo IDE

Un URL e un header aggiungono il Server MCP Unipile a Cursor. Il suo agente 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.
Cursor · crm-app
Unipile MCP connesso
Sarah
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.
3 file modificati · testato sull'app Development
Descriva la prossima funzionalità…
Caso d'uso

Aggiunga LinkedIn, WhatsApp ed email al suo prodotto da Cursor

Aggiunga LinkedIn, WhatsApp, email o calendario al suo prodotto. Tramite il Server MCP Unipile, Cursor legge il riferimento API, scrive il codice nel suo stack e testa ogni richiesta.
Connettere il server MCP Unipile a CursorUnipile MCP connesso
Selezioni i canali da connetteredeveloper.unipile.com/mcp
Connetti tutti i canali10 canali
LinkedInLinkedIn/v2/{account_id}/chats
WhatsAppWhatsApp/v2/{account_id}/chats
InstagramInstagram/v2/{account_id}/chats
TelegramTelegram/v2/{account_id}/chats
GmailGmail/v2/{account_id}/emails
OutlookOutlook/v2/{account_id}/emails
IMAPIMAP/v2/{account_id}/emails
Google CalendarGoogle Calendar/v2/{account_id}/calendars
Outlook CalendarOutlook Calendar/v2/{account_id}/calendars
↑↓naviga spazioseleziona ↵connettiun URL, un header
mcp.json, globale o di progetto

Aggiungere il server MCP Unipile a Cursor

Il server è remoto: un URL in streamable HTTP e un header, nulla da eseguire in locale. Scelga globale o progetto, incolli il blocco, salvi, e Cursor lo carica.
Prima di iniziare: Cursor aggiornato, un'applicazione Development nella dashboard Unipile con una scoped Account API key e un account di test collegato tramite Hosted Auth.
G
Configurazione globale~/.cursor/mcp.json
P
Configurazione di progetto.cursor/mcp.json (radice del repository)
E
Chiave da una variabile d'ambiente${env:UNIPILE_API_KEY}
?
Globale o progetto?Progetto quando ogni repository ha bisogno della propria chiave scoped. Cursor legge prima il progetto, poi la configurazione globale.
~/.cursor/mcp.json
{ "mcpServers": { "unipile": { "url": "https://developer.unipile.com/mcp?branch=v2.0", "headers": { "X-API-KEY": "your-scoped-api-key" } } } }
{ "mcpServers": { "unipile": { "url": "https://developer.unipile.com/mcp?branch=v2.0", "headers": { "X-API-KEY": "your-scoped-api-key" } } } }
{ "mcpServers": { "unipile": { "url": "https://developer.unipile.com/mcp?branch=v2.0", "headers": { "X-API-KEY": "${env:UNIPILE_API_KEY}" } } } }
Salvi il file e Cursor carica il server. ${env:NAME} funziona in url e headers, così la chiave non resta mai nel file.

Verificare la connessione

  1. 1Apra Customize nella barra laterale: il server unipile è elencato e abilitato.
  2. 2Nella CLI di Cursor, esegua agent mcp list, oppure /mcp list dentro una sessione.
  3. 3In una chat, chieda Usando l'MCP di Unipile, elenca gli endpoint per la ricerca di persone su LinkedIn e i loro parametri obbligatori e si aspetti route reali in risposta.
Facoltativo: installazione in un clic Incolli la sua scoped Account API key per ottenere un link che apre Cursor con il server già compilato. La chiave non lascia mai il suo browser.
Aggiungere Unipile a Cursor
Prompt, non codice di collegamento

Dia il prompt al suo agente

Tre integrazioni, ciascuna con il prompt da incollare in Cursor, gli endpoint che l'agente esegue su https://api.unipile.com con la sua X-API-KEY e ciò che arriva nel suo progetto.
Cursor · ats-appApp Development
Aggiungi la messaggistica LinkedIn al mio ATS: sincronizza la inbox di ogni recruiter e permettigli di rispondere dalla pagina del candidato.
Ricerca endpoint"chats messages send"3 risultati
Esecuzione richiestaGET /v2/{account_id}/chats12 chat
Creati linkedin/inbox-sync.ts (chat e messaggi salvati sul candidato, paginazione a cursore) e POST /candidates/:id/reply, che chiama la route di invio con l'account ID della chat stessa. Sync eseguita sull'app Development: 12 chat, 87 messaggi.3 file modificati · testato sull'app Development

Incolli il prompt, riveda il diff

Cursor 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. WhatsApp, Instagram, Facebook e Telegram usano le stesse route di chat.
Endpoint usati dall'agente
GET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
Costruire un'integrazione LinkedIn
Cursor · crm-appApp Development
Implementa Unipile Hosted Auth in questa app React e Fastify, così gli utenti collegano il proprio account LinkedIn da Settings.
Lettura endpointPOST /v2/auth/linkschema caricato
Esecuzione richiestaPOST /v2/auth/link201 · link
Aggiunta POST /api/accounts/connect in Fastify: crea il link di autenticazione lato server e restituisce l'URL ospitato. La pagina Settings in React lo apre e, al ritorno, salva il nuovo account_id nel workspace. Verificato sull'app Development con un account LinkedIn di test.4 file modificati · flusso di connessione testato end to end

I suoi utenti collegano i propri account, la sua app riceve un account ID

Hosted Auth è la pagina servita da Unipile con cui i suoi utenti collegano i propri account. L'agente collega il link nel suo backend, il redirect nel suo frontend e il salvataggio dell'account ID.
Endpoint usati dall'agente
POST/v2/auth/linkPOST/v2/auth/intentGET/v2/accounts/{account_id}
Implementare Hosted Auth con un agente
Cursor · support-consoleApp Development
Iscriviti ai webhook dei nuovi messaggi e costruisci una inbox unificata LinkedIn, WhatsApp ed email, con una sola lista di thread e il canale come badge.
Lettura endpointPOST /v2/webhooks/endpoints/schema caricato
Esecuzione richiestaGET /v2/{account_id}/emails200 OK
Registrato un endpoint webhook per gli eventi dei messaggi sull'app Development, aggiunta POST /webhooks/unipile che risponde subito 200 e mette l'evento in coda, un modello Thread che riporta chat e thread email a un'unica forma, e la lista dei thread con i badge di canale. Inviato un messaggio di test: la lista si è aggiornata in meno di un secondo.6 file modificati · 3 canali in una sola lista

Tempo reale senza polling, una sola lista per messaggistica ed email

L'agente legge i contratti di chat ed email, progetta un unico modello di thread e scrive la sincronizzazione e il ricevitore webhook. Poi controlla il log di consegna tramite la route delle conversazioni webhook.
Endpoint usati dall'agente
POST/v2/webhooks/endpoints/GET/v2/{account_id}/chatsGET/v2/{account_id}/emailsGET/v2/webhooks/conversations/
Costruire una inbox unificata con un agente
Prima un'applicazione Development Dia a Cursor 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

I messaggi che Cursor mostra quando una voce MCP non è corretta, e come risolverli.
Nessun tool o prompt
Controlli il file modificato (~/.cursor/mcp.json o .cursor/mcp.json), rimuova eventuali virgole finali, poi ricarichi il server da Customize.
No server info found
Usi una voce remota con url impostato esattamente su https://developer.unipile.com/mcp?branch=v2.0 e headers, senza command né type: "stdio".
Connection failed
Cerchi un refuso nell'host e in ?branch=v2.0, oppure un proxy aziendale: l'URL deve rispondere in un browser, non con un 404.
401 Unauthorized sulle richieste
Invii una scoped Account API key della sua applicazione Development in headers, con il nome esatto X-API-KEY.
La configurazione di progetto viene ignorata
Metta .cursor/mcp.json nella radice della cartella aperta in Cursor, non in una sottocartella.
Dove leggere i log
Apra il pannello Output (Cmd+Shift+U su macOS, Ctrl+Shift+U su Windows e Linux) e selezioni MCP Logs nel menu a tendina.
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
SOC 2 Tipo II
Certificato
Controlli di sicurezza verificati in modo indipendente che garantiscono la protezione dei dati e l'integrità operativa.
GDPR
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 per Cursor

Le domande che si fanno davvero: dove si trova mcp.json, globale o di progetto, server remoti e header, cosa controllare quando non appare nulla, chiavi, installazione in un clic e CLI.
In due posizioni. ~/.cursor/mcp.json nella sua cartella home è la configurazione globale, disponibile in tutti i progetti. .cursor/mcp.json nella radice della cartella aperta in Cursor è la configurazione di progetto. Cursor legge prima il file di progetto, poi quello globale, poi le cartelle superiori. Entrambi usano lo stesso blocco mcpServers di configurazione.
A livello globale quando costruisce diverse integrazioni Unipile dalla stessa macchina e con una sola applicazione Development. Per progetto quando ogni repository richiede la propria chiave scoped, la scelta giusta quando le integrazioni Development e Production vivono in repository diversi. In entrambi i casi la chiave è una chiave API Account scoped, mai una chiave Service o globale.
Sì. Una voce remota in mcp.json accetta un campo url e un headers di tipo oggetto, e Cursor risolve ${env:NAME} in entrambi. Il server Unipile è esattamente questo: streamable HTTP su https://developer.unipile.com/mcp?branch=v2.0 , con l'header X-API-KEY . Niente npx, nessun processo locale, nessuna versione di Node da gestire.
In questo ordine: il file modificato (globale o di progetto, nella radice del repository), la validità del JSON, un ricaricamento del server da Customize o un riavvio di Cursor, poi gli MCP Logs nel pannello Output (Cmd+Shift+U, selezioni MCP Logs). Se il server si connette ma le richieste falliscono con un 401, la chiave manca nell'header oppure non è una chiave API Account scoped.
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 gli account di test 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.
Sì. Il link di installazione in questa pagina codifica la configurazione del server; apre Cursor con la voce unipile già compilata, e lei sostituisce il segnaposto con la sua chiave scoped. Il generatore facoltativo qui sopra crea lo stesso link con la sua chiave già inserita, interamente nel suo browser.
Sì. La CLI condivide la configurazione dell'editor, prima quella di progetto, poi quella globale. agent mcp list mostra i server configurati e il loro stato, e /mcp list fa lo stesso in una sessione interattiva. L'agente usa poi il server Unipile quando una richiesta lo rende necessario.