Codex · MCP Server
Codex MCP-server: messaging en e-mail in uw product
Drie regels config.toml koppelen de Unipile MCP-server. Daarna bouwt Codex LinkedIn-, WhatsApp- en e-mailfuncties in uw product, vanuit de CLI, de IDE-extensie of de desktop-app. Niets te installeren of lokaal te draaien.
7 dagen gratis proberen, geen creditcard nodig.
Codex · crm-app
Unipile MCP verbonden
Voeg zoeken naar personen op LinkedIn toe aan mijn CRM.
Endpoint lezenPOST /v2/{account_id}/linkedin/searchschema geladen
De zoekroute en de resultatenlijst toegevoegd. Elke regel bewaart de provider-ID van het profiel.
Beschrijf de volgende feature…
Use case
Voeg LinkedIn, WhatsApp en e-mail toe aan uw product vanuit Codex
Voeg LinkedIn, WhatsApp, e-mail of agenda toe aan uw product. Via de Unipile MCP-server leest Codex de API-referentie, schrijft de code in uw stack en test elke request.
Koppel de Unipile MCP-server aan CodexUnipile MCP verbonden
Selecteer de kanalen die u wilt koppelen
developer.unipile.com/mcpAlle kanalen koppelen10 kanalen
↑↓navigeren spatieselecteren ↵koppelenéén URL, één header
config.toml, CLI en IDE
Voeg de Unipile MCP-server toe aan Codex
De server draait remote: één URL via streamable HTTP en één header, niets om lokaal te draaien. Eén entry in config.toml bedient Codex CLI, de IDE-extensie en de ChatGPT-desktopapp.
Voordat u begint: Codex CLI of de IDE-extensie, ingelogd, een Development-applicatie in het Unipile-dashboard met een scoped Account API key, en één testaccount gekoppeld via Hosted Auth.
codex mcp add, daarna de headerregistreert de URL in ~/.codex/config.toml
Globale configuratie~/.codex/config.toml
Projectconfiguratie.codex/config.toml (vertrouwd project)
Key uit een omgevingsvariabeleenv_http_headers
?
Waarom twee stappen in de CLI?codex mcp add heeft geen flag voor een eigen header, dus de X-API-KEY-header gaat in config.toml, met de hand of met env_http_headers.
# 1. Registreer de gehoste Unipile MCP-server (globale config)
codex mcp add unipile --url "https://developer.unipile.com/mcp?branch=v2.0"
# Added global MCP server 'unipile'.
# 2. Voeg de X-API-KEY-header toe aan de entry 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. Verifiëren
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" }
# Wordt alleen gelezen in een vertrouwd project. Houd de key uit git: gebruik bij voorkeur 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 voordat u codex start
Sla het bestand op en herstart Codex. Geverifieerd op codex-cli 0.154.0.
Houd uw API key buiten config.toml. Gebruik in een gedeeld bestand
env_http_headers, zodat elke developer zijn eigen UNIPILE_API_KEY exporteert, of http_headers_helper om hem uit een vault te lezen. Laat default_tools_approval_mode tijdens het bouwen op prompt staan als u elke schrijfactie wilt bevestigen.De verbinding controleren
- 1In de CLI toont
codex mcp listunipile als enabled, encodex mcp get unipilede headers. - 2In een sessie toont
/mcpde server; Auth Unsupported is normaal, want hij gebruikt een header en geen OAuth. - 3Vraag in een chat
Using the Unipile MCP, list the endpoints for LinkedIn people search and their required parametersen verwacht echte routes terug.
Prompts, geen lijmcode
Geef uw agent de prompt
Drie integratietaken, elk met de prompt om in Codex te plakken, de endpoints die de agent aanroept op
https://api.unipile.com met uw X-API-KEY, en wat er in uw project terechtkomt.Voeg zoeken naar personen op LinkedIn toe aan mijn CRM, en laat de gebruiker daarna het geselecteerde profiel openen en van daaruit een gesprek starten.
Endpoints zoeken"linkedin search people profile"3 resultaten
Request uitvoerenPOST /v2/{account_id}/linkedin/search10 resultaten
Toegevoegd
GET /api/linkedin/search (trefwoorden, pagineringscursor) en GET /api/linkedin/profiles/:identifier. De resultatenlijst bewaart de provider-ID die de zoekopdracht teruggeeft, de profielroute hergebruikt die, en de knop "Bericht" geeft hem door bij het aanmaken van de chat. Beide uitgevoerd op de Development-app.Eén identifier van zoekresultaat tot gesprek
Het lastige is dezelfde identifier vast te houden van de zoekrij naar het profiel en daarna naar het bericht. Codex leest de drie contracten en ziet welk veld hem draagt, dus niets wordt gegokt.
Endpoints die de agent gebruikt
Bouw een LinkedIn-integratie
POST/v2/{account_id}/linkedin/searchGET/v2/{account_id}/users/{identifier}POST/v2/{account_id}/chats
Genereer uit de API-schema's een getypeerde Node.js- en Python-client voor de Unipile-routes voor chats en e-mails die we gebruiken, met retries bij 429.
Endpoint lezenGET /v2/{account_id}/emailsschema geladen
Request uitvoerenGET /v2/{account_id}/chats200 OK
Gegenereerd:
unipile-client.ts en unipile_client.py op basis van de request- en responseschema's: getypeerde list- en send-methodes voor chats en e-mails, een helper voor cursorpaginering, exponential backoff bij 429 met de Retry-After-header. Beide clients hebben de list-calls uitgevoerd op de Development-app.Getypeerde clients uit de echte schema's, niet uit het geheugen
Codex leest de request body en het responseschema van elke route, genereert de types en voert per methode één call uit op uw Development-applicatie. De officiële Node.js- en Python-SDK's blijven de referentie.
Endpoints die de agent gebruikt
Bekijk de officiële SDK's
GET/v2/{account_id}/chatsPOST/v2/{account_id}/chats/{chat_id}/messages/sendGET/v2/{account_id}/emailsPOST/v2/{account_id}/emails/send
Ondersteun meerdere gekoppelde accounts voor elke gebruiker van mijn SaaS: ze kunnen meerdere LinkedIn- en e-mailaccounts koppelen en kiezen welk account verstuurt.
Endpoint lezenGET /v2/accountsschema geladen
Request uitvoerenGET /v2/accounts3 accounts
Een tabel
accounts toegevoegd, met als sleutel de gebruiker en account_id, een keuzelijst in de composer, en POST /api/messages dat verstuurt via het geselecteerde account. Reconnect-statussen uit de accounts-route worden als badge getoond. Gecontroleerd met drie accounts op de Development-app.Eén gebruiker, meerdere accounts, één Scope per workspace
Elk account dat uw gebruikers via Hosted Auth koppelen, krijgt een eigen
account_id. De agent koppelt uw gebruikers aan die ID's, toont de statussen voor opnieuw verbinden en checkpoints, en stuurt elke verzending naar het account dat de gebruiker heeft gekozen.Endpoints die de agent gebruikt
Hosted Auth implementeren met een agent
GET/v2/accountsGET/v2/accounts/{account_id}POST/v2/auth/linkPOST/v2/{account_id}/chats
Eerst een Development-applicatie
Geef Codex een scoped key uit een Development-applicatie, gescheiden van Production.
Testaccounts, echte requests
De agent voert requests uit op testaccounts, namens de geauthenticeerde gebruiker die ze heeft gekoppeld, binnen de limieten van elke provider.
Valideer elke flow
Controleer de koppelingsflow, één lees- en één schrijfactie per feature, en een webhooklevering.
Zet daarna over naar Production
Niets raakt de accounts van uw gebruikers totdat u de sleutel omzet. Zie beveiliging en compliance.
Probleemoplossing
Veelvoorkomende fouten en wat ze betekenen
Wat u ziet als een MCP-entry in Codex niet klopt, en de oplossing voor elk.
De server verschijnt niet na het bewerken van config.toml
Herstart Codex, controleer daarna CODEX_HOME en voer codex mcp list uit in de shell van waaruit u Codex start.
De projectconfiguratie wordt genegeerd
Markeer het project als vertrouwd met trust_level = "trusted" onder [projects."/path/to/repo"], of verplaats de entry naar ~/.codex/config.toml.
Ongeldige TOML
Noem de tabel exact [mcp_servers.unipile] en maak van http_headers een tabel, met "X-API-KEY" tussen aanhalingstekens.
401 Unauthorized bij requests
Exporteer de variabele die in env_http_headers staat in de shell die Codex heeft gestart, en gebruik een scoped Account API key.
De instellingen melden dat de server niet beschikbaar is
Niets te wijzigen: die controle zoekt naar resources, en de Unipile-server biedt acties, zoals /mcp bevestigt.
Time-out
Controleer de URL (inclusief ?branch=v2.0), het netwerk en een eventuele proxy voordat u startup_timeout_sec verhoogt.
6000+
Bedrijven innoveren met Unipile
Vertrouwd door marktleiders
1 API
Activiteiten stroomlijnen voor alle belangrijke communicatiekanalen
2 dagen
Snel live integratie bereiken met minimale installatie
30%
Vermindering van onderhoudsinspanningen en -middelen
Ingebouwde beveiliging en compliance
Enterprise-bescherming voor uw gegevens en workflows Meer informatie over onze beveiliging
SOC 2 type II
Gecertificeerd
Onafhankelijk gecontroleerde beveiligingscontroles voor gegevensbescherming en operationele integriteit.
GDPR
Conform
Volledige naleving van de Europese regelgeving voor gegevensbescherming voor de privacy van gebruikers.
99.9%
Platform Uptime over de laatste 24 maanden
24/7
Wereldwijde ondersteuning met krachtige API
FAQ Codex MCP-server
De vragen die mensen echt intypen: config.toml in plaats van mcp.json, waar het bestand staat, codex mcp add, de key buiten het bestand houden, de drie omgevingen, wat u controleert als er niets verschijnt, time-outs en keys.
Nee. Codex slaat zijn MCP-configuratie op in
~/.codex/config.toml, in TOML, één tabel per server met de naam [mcp_servers.<name>]. Codex kent geen mcp.json, en het bestand wordt niet bij de installatie aangemaakt: u maakt het zelf aan, of codex mcp add maakt het voor u aan. Een vertrouwd project kan ook een .codex/config.toml in de root hebben.~/.codex/config.toml voor de gebruikersconfiguratie, .codex/config.toml in de root van de repository voor de projectconfiguratie. De variabele CODEX_HOME verplaatst de hele configuratiemap: als een server in de ene terminal verschijnt en in een andere niet, controleer die dan eerst. Codex CLI, de IDE-extensie en de desktopapp lezen hetzelfde bestand.Deels.
codex mcp add unipile --url "https://developer.unipile.com/mcp?branch=v2.0" schrijft de tabel voor een streamable HTTP-server, en --bearer-token-env-var dekt servers die een Bearer-token gebruiken. De Unipile-server authenticeert met een X-API-KEY header, die het commando niet kan instellen, dus voegt u http_headers of env_http_headers toe aan de entry die het heeft aangemaakt. Gecontroleerd op codex-cli 0.154.0.Gebruik
env_http_headers = { "X-API-KEY" = "UNIPILE_API_KEY" }: die koppelt de headernaam aan de naam van een omgevingsvariabele in plaats van aan een waarde, zodat het bestand zonder geheim kan worden gecommit en elke developer zijn eigen scoped Account API key exporteert. http_headers is voor statische waarden, en met http_headers_helper maakt een lokaal commando de headers aan als JSON.Ja. De drie omgevingen van één Codex-host lezen dezelfde configuratie, dus een server die u één keer toevoegt, is overal beschikbaar. In de desktopapp en in de extensie kunt u hem ook toevoegen via Settings, MCP servers, Add server, met Streamable HTTP als keuze. Herstart de client na het opslaan van het bestand.
Vier oorzaken, op volgorde: de client is niet herstart; het bestand staat onder een andere
CODEX_HOME dan uw huidige shell; de tabel staat in het projectbestand .codex/config.toml en het project is niet gemarkeerd met trust_level = "trusted", waardoor Codex de projectlaag volledig overslaat; of de TOML is ongeldig. Gebruik codex mcp list, en daarna /mcp binnen een sessie.startup_timeout_sec overschrijft de standaard opstarttime-out van 10 seconden en tool_timeout_sec de standaardtime-out van 60 seconden per tool, allebei onder de servertabel. De Unipile-server is remote via HTTP, zonder lokaal proces om te starten, dus een opstarttime-out wijst bijna altijd op de URL, het netwerk of een bedrijfsproxy, niet op de server.De server antwoordt zonder key zolang de agent alleen de API-specificatie leest. Om echte requests uit te voeren, maakt u een Scope aan in uw Development-applicatie, wijst u de testaccounts toe en genereert u een scoped Account API key voor die Scope. Geef een MCP-client nooit een Service key of een globale Account key.