Integrationsleitfäden
LinkedIn-API-Leitfaden
E-Mail-API-Leitfaden
WhatsApp-API-Leitfaden
Vertrieb kontaktieren
Codex · MCP Server
Codex MCP Server: Messaging und E-Mail in Ihrem Produkt
Drei Zeilen config.toml verbinden den Unipile MCP-Server. Codex baut dann LinkedIn-, WhatsApp- und E-Mail-Features in Ihr Produkt ein, aus der CLI, der IDE-Erweiterung oder der Desktop-App. Nichts zu installieren oder lokal zu starten.
7 Tage kostenlos testen, ohne Kreditkarte.
Codex · crm-app
Unipile MCP verbunden
Ergänze mein CRM um die LinkedIn-Personensuche.
Endpoint lesenPOST /v2/{account_id}/linkedin/searchSchema geladen
Such-Route und Ergebnisliste ergänzt. Jede Zeile behält die Provider-ID für das Profil.
Nächstes Feature beschreiben…
Anwendungsfall
LinkedIn, WhatsApp und E-Mail aus Codex in Ihr Produkt bringen
Bringen Sie LinkedIn, WhatsApp, E-Mail oder Kalender in Ihr Produkt. Über den Unipile MCP-Server liest Codex die API-Referenz, schreibt den Code in Ihrem Stack und testet jede Anfrage.
Den Unipile MCP-Server mit Codex verbindenUnipile MCP verbunden
Wählen Sie die Kanäle, die Sie verbinden möchten
developer.unipile.com/mcpAlle Kanäle verbinden10 Kanäle
↑↓navigieren Leertasteauswählen ↵verbindeneine URL, ein Header
config.toml, CLI und IDE
Unipile MCP-Server für Codex
Der Server ist remote: eine URL über streamable HTTP und ein Header, lokal läuft nichts. Ein Eintrag in config.toml gilt für Codex CLI, die IDE-Erweiterung und die ChatGPT-Desktop-App.
Vorab: Codex CLI oder die IDE-Erweiterung, angemeldet, eine Development-Anwendung im Unipile-Dashboard mit einem Scoped Account API Key und ein Testkonto, das über Hosted Auth verknüpft ist.
codex mcp add, dann der Headerregistriert die URL in ~/.codex/config.toml
Globale Konfiguration~/.codex/config.toml
Projektkonfiguration.codex/config.toml (vertrauenswürdiges Projekt)
Key aus einer Umgebungsvariablenenv_http_headers
?
Warum zwei Schritte in der CLI?codex mcp add hat kein Flag für eigene Header, der X-API-KEY-Header kommt also in config.toml, von Hand oder über env_http_headers.
# 1. Den gehosteten Unipile MCP-Server registrieren (globale Konfiguration)
codex mcp add unipile --url "https://developer.unipile.com/mcp?branch=v2.0"
# Added global MCP server 'unipile'.
# 2. Den X-API-KEY-Header im Eintrag in ~/.codex/config.toml ergänzen
[mcp_servers.unipile]
url = "https://developer.unipile.com/mcp?branch=v2.0"
http_headers = { "X-API-KEY" = "your-scoped-api-key" }
# 3. Prüfen
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" }
# Wird nur in einem vertrauenswürdigen Projekt gelesen. Halten Sie den Key aus git: besser 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 vor dem Start von codex
Speichern Sie die Datei und starten Sie Codex neu. Geprüft mit codex-cli 0.154.0.
Halten Sie Ihren API Key aus config.toml heraus. In einer geteilten Datei nutzen Sie
env_http_headers, damit jeder Entwickler seinen eigenen UNIPILE_API_KEY exportiert, oder http_headers_helper, um ihn aus einem Vault zu lesen. Lassen Sie default_tools_approval_mode während der Entwicklung auf prompt, wenn Sie jeden Schreibvorgang bestätigen möchten.Die Verbindung prüfen
- 1In der CLI zeigt
codex mcp listunipile als enabled an undcodex mcp get unipileseine Header. - 2In einer Session listet
/mcpden Server auf; Auth Unsupported ist normal, da er einen Header nutzt, kein OAuth. - 3Fragen Sie im Chat
Liste über den Unipile MCP die Endpoints für die LinkedIn-Personensuche und ihre Pflichtparameter auf: Zurück kommen echte Routen.
Prompts statt Glue Code
Geben Sie Ihrem Agenten den Prompt
Drei Integrationsaufgaben, jeweils mit dem Prompt für Codex, den Endpoints, die der Agent auf
https://api.unipile.com mit Ihrem X-API-KEY aufruft, und dem, was in Ihrem Projekt landet.Ergänze mein CRM um die LinkedIn-Personensuche und lass den Nutzer danach das ausgewählte Profil öffnen und von dort eine Konversation starten.
Endpoints suchen"linkedin search people profile"3 Treffer
Anfrage ausführenPOST /v2/{account_id}/linkedin/search10 Ergebnisse
Ergänzt
GET /api/linkedin/search (Keywords, Pagination-Cursor) und GET /api/linkedin/profiles/:identifier. Die Ergebnisliste behält die Provider-ID aus der Such-Response, die Profil-Route nutzt sie erneut, und der Button „Nachricht“ übergibt sie an die Chat-Erstellung. Beide in der Development-App ausgeführt.Eine ID vom Suchergebnis bis zur Konversation
Das Schwierige ist, dieselbe ID von der Suchzeile über das Profil bis zur Nachricht zu behalten. Codex liest die drei Verträge und sieht, welches Feld sie trägt, damit nichts geraten wird.
Endpoints, die der Agent nutzt
Eine LinkedIn-Integration bauen
POST/v2/{account_id}/linkedin/searchGET/v2/{account_id}/users/{identifier}POST/v2/{account_id}/chats
Generiere aus den API-Schemas einen typisierten Node.js- und Python-Client für die Unipile-Routen zu Chats und E-Mails, die wir nutzen, mit Retries bei 429.
Endpoint lesenGET /v2/{account_id}/emailsSchema geladen
Anfrage ausführenGET /v2/{account_id}/chats200 OK
Geschrieben:
unipile-client.ts und unipile_client.py aus den Request- und Response-Schemas: typisierte Methoden zum Auflisten und Senden für Chats und E-Mails, ein Helper für Cursor-Pagination, exponentielles Backoff bei 429 mit dem Retry-After-Header. Beide Clients haben die Listen-Aufrufe in der Development-App ausgeführt.Typisierte Clients aus den echten Schemas, nicht aus dem Gedächtnis
Codex liest Request-Body und Response-Schema jeder Route, generiert die Typen und führt einen Aufruf pro Methode in Ihrer Development-Anwendung aus. Die offiziellen SDKs für Node.js und Python bleiben die Referenz.
Endpoints, die der Agent nutzt
Die offiziellen SDKs ansehen
GET/v2/{account_id}/chatsPOST/v2/{account_id}/chats/{chat_id}/messages/sendGET/v2/{account_id}/emailsPOST/v2/{account_id}/emails/send
Unterstütze mehrere verbundene Konten pro Nutzer meines SaaS: Sie können mehrere LinkedIn- und E-Mail-Konten verbinden und wählen, über welches gesendet wird.
Endpoint lesenGET /v2/accountsSchema geladen
Anfrage ausführenGET /v2/accounts3 Konten
Ergänzt: eine Tabelle
accounts , indiziert nach Nutzer und account_id, ein Auswahlfeld im Composer und POST /api/messages , das über das ausgewählte Konto sendet. Reconnect-Zustände aus der Accounts-Route werden als Badge angezeigt. Mit drei Konten in der Development-App verifiziert.Ein Nutzer, mehrere Konten, ein Scope pro Workspace
Jedes Konto, das Ihre Nutzer über Hosted Auth verbinden, erhält eine eigene
account_id. Der Agent ordnet Ihre Nutzer diesen IDs zu, zeigt Reconnect- und Checkpoint-Zustände an und leitet jeden Sendevorgang an das vom Nutzer gewählte Konto.Endpoints, die der Agent nutzt
Hosted Auth mit einem Agenten implementieren
GET/v2/accountsGET/v2/accounts/{account_id}POST/v2/auth/linkPOST/v2/{account_id}/chats
Zuerst eine Development-Anwendung
Geben Sie Codex einen Scoped Key aus einer Development-Anwendung, getrennt von Production.
Testkonten, echte Anfragen
Der Agent führt Anfragen auf Testkonten aus, im Namen des authentifizierten Nutzers, der sie verknüpft hat, innerhalb der Limits jedes Anbieters.
Jeden Ablauf prüfen
Prüfen Sie den Verbindungsablauf, je einen Lese- und Schreibvorgang pro Funktion und eine Webhook-Zustellung.
Dann auf Production umstellen
Nichts berührt die Konten Ihrer Nutzer, bevor Sie den Key umstellen. Siehe Sicherheit und Compliance.
Fehlerbehebung
Häufige Fehler und was sie bedeuten
Was Sie sehen, wenn ein MCP-Eintrag in Codex nicht stimmt, und die jeweilige Lösung.
Der Server erscheint nach dem Bearbeiten von config.toml nicht
Starten Sie Codex neu, prüfen Sie dann CODEX_HOME und führen Sie codex mcp list in der Shell aus, aus der Sie Codex starten.
Die Projektkonfiguration wird ignoriert
Markieren Sie das Projekt als vertrauenswürdig mit trust_level = "trusted" unter [projects."/path/to/repo"], oder verschieben Sie den Eintrag nach ~/.codex/config.toml.
Ungültiges TOML
Benennen Sie die Tabelle exakt [mcp_servers.unipile] und machen Sie http_headers zu einer Tabelle, mit "X-API-KEY" in Anführungszeichen.
401 Unauthorized bei Anfragen
Exportieren Sie die in env_http_headers genannte Variable in der Shell, die Codex gestartet hat, und verwenden Sie einen Scoped Account API Key.
Die Einstellungen melden den Server als nicht verfügbar
Nichts zu ändern: Diese Prüfung sucht nach Resources, und der Unipile-Server stellt Actions bereit, wie /mcp bestätigt.
Timed out
Prüfen Sie die URL (inklusive ?branch=v2.0), das Netzwerk und einen möglichen Proxy, bevor Sie startup_timeout_sec erhöhen.
6000+
Unternehmen, die mit Unipile innovieren
Vertrauen bei Branchenführern
1 API
Rationalisierung der Abläufe für alle wichtigen Kommunikationskanäle
2 Tage
Schnelle Live-Integration mit minimaler Einrichtung
30%
Verringerung des Wartungsaufwands und der Ressourcen
Integrierte Sicherheit und Compliance
Unternehmensgerechter Schutz für Ihre Daten und Arbeitsabläufe Erfahren Sie mehr über unsere Sicherheit
SOC 2 Typ II
Zertifiziert
Unabhängig geprüfte Sicherheitskontrollen zur Gewährleistung des Datenschutzes und der betrieblichen Integrität.
GDPR
Konform
Vollständige Einhaltung der europäischen Datenschutzbestimmungen zum Schutz der Privatsphäre der Nutzer.
99.9%
Betriebszeit der Plattform in den letzten 24 Monaten
24/7
Globaler Support mit leistungsstarker API
FAQ zum Codex MCP-Server
Die Fragen, die wirklich gestellt werden: config.toml statt mcp.json, wo sie liegt, codex mcp add, den Key aus der Datei halten, die drei Oberflächen, was zu prüfen ist, wenn nichts erscheint, Timeouts und Keys.
Nein. Codex speichert seine MCP-Konfiguration in
~/.codex/config.toml, in TOML, eine Tabelle pro Server mit dem Namen [mcp_servers.<name>]. Eine mcp.json gibt es in Codex nicht, und die Datei wird bei der Installation nicht angelegt: Sie erstellen sie, oder codex mcp add erstellt sie für Sie. Ein vertrauenswürdiges Projekt kann zusätzlich eine .codex/config.toml im Wurzelverzeichnis tragen.~/.codex/config.toml für die User-Konfiguration, .codex/config.toml im Wurzelverzeichnis des Repositories für die Projektkonfiguration. Die Umgebungsvariable CODEX_HOME verschiebt das gesamte Konfigurationsverzeichnis: Zeigt sich ein Server in einem Terminal und im anderen nicht, prüfen Sie das zuerst. Codex CLI, die IDE-Erweiterung und die Desktop-App lesen dieselbe Datei.Teilweise.
codex mcp add unipile --url "https://developer.unipile.com/mcp?branch=v2.0" schreibt die Tabelle für einen streamable-HTTP-Server, und --bearer-token-env-var deckt Server ab, die einen Bearer-Token nehmen. Der Unipile-Server authentifiziert über einen X-API-KEY Header, den der Befehl nicht setzen kann, Sie ergänzen den erzeugten Eintrag also um http_headers oder env_http_headers . Geprüft mit codex-cli 0.154.0.Nutzen Sie
env_http_headers = { "X-API-KEY" = "UNIPILE_API_KEY" }: Es ordnet dem Header-Namen den Namen einer Umgebungsvariablen zu statt eines Werts, die Datei lässt sich also ohne Secret einchecken, und jeder Entwickler exportiert seinen eigenen Scoped Account API Key. http_headers ist für statische Werte, und http_headers_helper lässt einen lokalen Befehl die Header als JSON erzeugen.Ja. Die drei Oberflächen eines Codex-Hosts lesen dieselbe Konfiguration, ein einmal hinzugefügter Server ist also überall verfügbar. In der Desktop-App und in der Erweiterung können Sie ihn auch über Settings, MCP servers, Add server hinzufügen und Streamable HTTP wählen. Starten Sie den Client nach dem Speichern der Datei neu.
Vier Ursachen, der Reihe nach: Der Client wurde nicht neu gestartet; die Datei liegt unter einem anderen
CODEX_HOME als Ihre aktuelle Shell; die Tabelle steht in einer projektbezogenen .codex/config.toml und das Projekt ist nicht als trust_level = "trusted"markiert, wodurch Codex die Projektebene komplett überspringt; oder das TOML ist ungültig. Führen Sie codex mcp listaus, danach /mcp in einer Session.startup_timeout_sec überschreibt den Standard-Startup-Timeout von 10 Sekunden und tool_timeout_sec den Standard-Timeout von 60 Sekunden pro Tool, beide unter der Server-Tabelle. Der Unipile-Server ist remote über HTTP und hat keinen lokalen Prozess zu starten, ein Startup-Timeout deutet also fast immer auf die URL, das Netzwerk oder einen Unternehmens-Proxy hin, nicht auf den Server.Der Server antwortet ohne Key, solange der Agent nur die API-Spezifikation liest. Für echte Anfragen erstellen Sie in Ihrer Development-Anwendung einen Scope, weisen die Testkonten zu und erzeugen einen Scoped Account API Key für diesen Scope. Geben Sie einem MCP-Client nie einen Service-Key oder einen globalen Account-Key.