IT
Codex · Server MCP

Server MCP per Codex: messaggistica ed email nel suo prodotto

Tre righe di config.toml collegano il Server MCP Unipile. Codex costruisce poi funzionalità LinkedIn, WhatsApp ed email nel suo prodotto, dalla CLI, dall'estensione IDE o dall'app desktop. Niente da installare o avviare in locale.
Prova gratuita di 7 giorni, senza carta di credito.
Codex · crm-app
Unipile MCP connesso
Sarah
Aggiungi la ricerca di persone LinkedIn al mio CRM.
Lettura endpointPOST /v2/{account_id}/linkedin/searchschema caricato
Aggiunti la route di ricerca e la lista dei risultati. Ogni riga conserva il provider ID del profilo.
3 file modificati · testato sull'app Development
Descriva la prossima funzionalità…
Caso d'uso

Aggiunga LinkedIn, WhatsApp ed email al suo prodotto da Codex

Aggiunga LinkedIn, WhatsApp, email o calendario al suo prodotto. Tramite il Server MCP Unipile, Codex legge il riferimento API, scrive il codice nel suo stack e testa ogni richiesta.
Connettere il server MCP Unipile a CodexUnipile 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
config.toml, CLI e IDE

Aggiungere il server MCP Unipile a Codex

Il server è remoto: un URL in streamable HTTP e un header, nulla da eseguire in locale. Una sola voce in config.toml serve Codex CLI, l'estensione IDE e l'app desktop di ChatGPT.
Prima di iniziare: Codex CLI o l'estensione IDE con accesso effettuato, un'applicazione Development nella dashboard Unipile con una scoped Account API key e un account di test collegato tramite Hosted Auth.
1
codex mcp add, poi l'headerregistra l'URL in ~/.codex/config.toml
G
Configurazione globale~/.codex/config.toml
P
Configurazione di progetto.codex/config.toml (progetto attendibile)
E
Chiave da una variabile d'ambienteenv_http_headers
?
Perché due passaggi sulla CLI?codex mcp add non ha un flag per gli header personalizzati, quindi l'header X-API-KEY va in config.toml, a mano o con env_http_headers.
terminale
# 1. Registri il server MCP Unipile ospitato (configurazione globale) codex mcp add unipile --url "https://developer.unipile.com/mcp?branch=v2.0" # Added global MCP server 'unipile'. # 2. Aggiunga l'header X-API-KEY alla voce in ~/.codex/config.toml [mcp_servers.unipile] url = "https://developer.unipile.com/mcp?branch=v2.0" http_headers = { "X-API-KEY" = "your-scoped-api-key" } # 3. Verifichi codex mcp get unipile
[mcp_servers.unipile] url = "https://developer.unipile.com/mcp?branch=v2.0" http_headers = { "X-API-KEY" = "your-scoped-api-key" }
[mcp_servers.unipile] url = "https://developer.unipile.com/mcp?branch=v2.0" http_headers = { "X-API-KEY" = "your-scoped-api-key" } # Letta solo all'interno di un progetto attendibile. Tenga la chiave fuori da git: meglio env_http_headers.
[mcp_servers.unipile] url = "https://developer.unipile.com/mcp?branch=v2.0" env_http_headers = { "X-API-KEY" = "UNIPILE_API_KEY" } # export UNIPILE_API_KEY=your-scoped-api-key prima di avviare codex
Salvi il file e riavvii Codex. Verificato su codex-cli 0.154.0.
Tenga la chiave API fuori da config.toml. In un file condiviso, usi env_http_headers perché ogni sviluppatore esporti la propria UNIPILE_API_KEY, oppure http_headers_helper per leggerla da un vault. Lasci default_tools_approval_mode su prompt durante lo sviluppo se vuole confermare ogni scrittura.

Verificare la connessione

  1. 1Nella CLI, codex mcp list mostra unipile come abilitato e codex mcp get unipile i suoi header.
  2. 2Dentro una sessione, /mcp elenca il server; Auth Unsupported è normale, perché usa un header, non OAuth.
  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.
Prompt, non codice di collegamento

Dia il prompt al suo agente

Tre integrazioni, ciascuna con il prompt da incollare in Codex, gli endpoint che l'agente esegue su https://api.unipile.com con la sua X-API-KEY e ciò che arriva nel suo progetto.
Codex · crm-appApp Development
Aggiungi la ricerca di persone LinkedIn al mio CRM, poi permetti all'utente di aprire il profilo selezionato e di avviare una conversazione da lì.
Ricerca endpoint"linkedin search people profile"3 risultati
Esecuzione richiestaPOST /v2/{account_id}/linkedin/search10 risultati
Aggiunte GET /api/linkedin/search (parole chiave, cursore di paginazione) e GET /api/linkedin/profiles/:identifier. La lista dei risultati conserva il provider ID restituito dalla ricerca, la route del profilo lo riutilizza e il pulsante "Message" lo passa alla creazione della chat. Entrambe eseguite sull'app Development.4 file modificati · testato sull'app Development

Un solo identificatore dal risultato di ricerca alla conversazione

La parte difficile è mantenere lo stesso identificativo dalla riga di ricerca al profilo, poi al messaggio. Codex legge i tre contratti e vede quale campo lo contiene, così nulla è lasciato al caso.
Endpoint usati dall'agente
POST/v2/{account_id}/linkedin/searchGET/v2/{account_id}/users/{identifier}POST/v2/{account_id}/chats
Costruire un'integrazione LinkedIn
Codex · messaging-sdkApp Development
Genera un client tipizzato Node.js e Python per le route chats ed emails di Unipile che usiamo, a partire dagli schemi dell'API, con retry sui 429.
Lettura endpointGET /v2/{account_id}/emailsschema caricato
Esecuzione richiestaGET /v2/{account_id}/chats200 OK
Scritti unipile-client.ts e unipile_client.py a partire dagli schemi di richiesta e risposta: metodi tipizzati di lista e invio per chat ed email, helper di paginazione a cursore, backoff esponenziale sui 429 con l'header Retry-After. Entrambi i client hanno eseguito le chiamate di lista sull'app Development.2 client generati · schemi letti tramite il server

Client tipizzati dagli schemi reali, non dalla memoria

Codex legge il body della richiesta e lo schema di risposta di ogni route, genera i tipi ed esegue una chiamata per metodo sulla sua applicazione Development. Gli SDK ufficiali Node.js e Python restano il riferimento.
Endpoint usati dall'agente
GET/v2/{account_id}/chatsPOST/v2/{account_id}/chats/{chat_id}/messages/sendGET/v2/{account_id}/emailsPOST/v2/{account_id}/emails/send
Vedere gli SDK ufficiali
Codex · saas-backendApp Development
Supporta più account collegati per ogni utente del mio SaaS: possono collegare diversi account LinkedIn ed email e scegliere quale usare per inviare.
Lettura endpointGET /v2/accountsschema caricato
Esecuzione richiestaGET /v2/accounts3 account
Aggiunta una tabella accounts con chiave per utente e account_id, un selettore nel composer e POST /api/messages che invia dall'account selezionato. Gli stati di riconnessione restituiti dalla route accounts compaiono come badge. Verificato con tre account sull'app Development.5 file modificati · 3 account, un solo composer

Un utente, diversi account, uno Scope per workspace

Ogni account che i suoi utenti collegano tramite Hosted Auth riceve il proprio account_id. L'agente associa i suoi utenti a quegli ID, mostra gli stati di riconnessione e checkpoint e indirizza ogni invio all'account scelto dall'utente.
Endpoint usati dall'agente
GET/v2/accountsGET/v2/accounts/{account_id}POST/v2/auth/linkPOST/v2/{account_id}/chats
Implementare Hosted Auth con un agente
Prima un'applicazione Development Dia a Codex 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

Che cosa si vede quando una voce MCP di Codex non è corretta, e come risolverla.
Il server non compare dopo aver modificato config.toml
Riavvii Codex, poi controlli CODEX_HOME ed esegua codex mcp list nella shell da cui avvia Codex.
La configurazione di progetto viene ignorata
Marchi il progetto come attendibile con trust_level = "trusted" sotto [projects."/path/to/repo"], oppure sposti la voce in ~/.codex/config.toml.
TOML non valido
Chiami la tabella esattamente [mcp_servers.unipile] e faccia di http_headers una tabella, con "X-API-KEY" tra virgolette.
401 Unauthorized sulle richieste
Esporti la variabile indicata in env_http_headers nella shell che ha avviato Codex e usi una scoped Account API key.
Le impostazioni dicono che il server non è disponibile
Nulla da cambiare: quel controllo cerca risorse, mentre il server Unipile espone azioni, come conferma /mcp.
Timed out
Controlli l'URL (?branch=v2.0 compreso), la rete ed eventuali proxy prima di alzare startup_timeout_sec.
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 Codex

Le domande che si pongono davvero: config.toml invece di mcp.json, dove si trova, codex mcp add, come tenere la chiave fuori dal file, le tre superfici, cosa controllare quando non compare nulla, timeout e chiavi.
No. Codex salva la sua configurazione MCP in ~/.codex/config.toml, in TOML, con una tabella per server chiamata [mcp_servers.<name>]. In Codex non esiste alcun mcp.json, e il file non viene creato all'installazione: lo crea lei, oppure lo crea codex mcp add per lei. Un progetto attendibile può anche avere un .codex/config.toml nella propria radice.
~/.codex/config.toml per la configurazione utente, .codex/config.toml nella radice del repository per la configurazione di progetto. La variabile d'ambiente CODEX_HOME sposta l'intera cartella di configurazione: quando un server compare in un terminale e non in un altro, la controlli per prima. Codex CLI, l'estensione per l'IDE e l'app desktop leggono lo stesso file.
In parte. codex mcp add unipile --url "https://developer.unipile.com/mcp?branch=v2.0" scrive la tabella per un server streamable HTTP, e --bearer-token-env-var copre i server che accettano un token Bearer. Il server Unipile si autentica con un header X-API-KEY , che il comando non può impostare, quindi aggiunge http_headers o env_http_headers alla voce che ha creato. Verificato su codex-cli 0.154.0.
Usare env_http_headers = { "X-API-KEY" = "UNIPILE_API_KEY" }: associa il nome dell'header al nome di una variabile d'ambiente invece che a un valore, così il file può essere committato senza segreti e ogni sviluppatore esporta la propria chiave API Account scoped. http_headers serve per i valori statici, e http_headers_helper permette a un comando locale di produrre gli header in JSON.
Sì. Le tre superfici di uno stesso host Codex leggono la stessa configurazione, quindi un server aggiunto una volta è disponibile ovunque. Nell'app desktop e nell'estensione può anche aggiungerlo da Settings, MCP servers, Add server, scegliendo Streamable HTTP. Riavvii il client dopo aver salvato il file.
Quattro cause, in ordine: il client non è stato riavviato; il file si trova sotto un CODEX_HOME diverso da quello della shell corrente; la tabella è in un .codex/config.toml di progetto e il progetto non è marcato trust_level = "trusted", nel qual caso Codex salta del tutto il livello di progetto; oppure il TOML non è valido. Esegua codex mcp list, poi /mcp all'interno di una sessione.
startup_timeout_sec sostituisce il timeout di avvio predefinito di 10 secondi e tool_timeout_sec quello per tool di 60 secondi, entrambi sotto la tabella del server. Il server Unipile è remoto su HTTP e non ha alcun processo locale da avviare, quindi un timeout di avvio indica quasi sempre l'URL, la rete o un proxy aziendale, non il server.
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.