Codex · Serwer MCP
Serwer MCP dla Codex: wiadomości i e-mail w produkcie
Trzy linie config.toml łączą serwer MCP Unipile. Codex buduje potem w Państwa produkcie funkcje LinkedIn, WhatsApp i e-mail, z CLI, rozszerzenia IDE lub aplikacji desktopowej. Nic do instalowania ani uruchamiania lokalnie.
7 dni za darmo, bez karty kredytowej.
Codex · crm-app
Unipile MCP połączony
Dodaj do mojego CRM wyszukiwanie osób na LinkedIn.
Odczyt endpointuPOST /v2/{account_id}/linkedin/searchschemat wczytany
Dodano endpoint wyszukiwania i listę wyników. Każdy wiersz przechowuje ID profilu u dostawcy.
Opisz kolejną funkcję…
Przypadek użycia
LinkedIn, WhatsApp i e-mail w Państwa produkcie, prosto z Codex
Dodaj do produktu LinkedIn, WhatsApp, e-mail lub kalendarz. Przez serwer MCP Unipile Codex czyta dokumentację API, pisze kod w używanym stacku i testuje każde zapytanie.
Podłącz serwer Unipile MCP do CodexUnipile MCP połączony
Wybierz kanały do podłączenia
developer.unipile.com/mcpPodłącz wszystkie kanały10 kanałów
↑↓nawigacja spacjawybór ↵połączjeden URL, jeden nagłówek
config.toml, CLI i IDE
Dodaj serwer Unipile MCP do Codex
Serwer jest zdalny: jeden URL przez streamable HTTP i jeden nagłówek, nic do uruchamiania lokalnie. Jeden wpis w config.toml obsługuje Codex CLI, rozszerzenie IDE i aplikację desktopową ChatGPT.
Przed startem: zalogowany Codex CLI lub rozszerzenie IDE, aplikacja Development w dashboardzie Unipile z kluczem Account API z zakresem oraz jedno konto testowe podłączone przez Hosted Auth.
codex mcp add, potem nagłówekrejestruje URL w ~/.codex/config.toml
Konfiguracja globalna~/.codex/config.toml
Konfiguracja projektu.codex/config.toml (zaufany projekt)
Klucz ze zmiennej środowiskowejenv_http_headers
?
Dlaczego w CLI są dwa kroki?codex mcp add nie ma flagi dla własnego nagłówka, więc nagłówek X-API-KEY trafia do config.toml, ręcznie lub przez env_http_headers.
# 1. Zarejestruj hostowany serwer Unipile MCP (konfiguracja globalna)
codex mcp add unipile --url "https://developer.unipile.com/mcp?branch=v2.0"
# Added global MCP server 'unipile'.
# 2. Dodaj nagłówek X-API-KEY do wpisu w ~/.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. Weryfikacja
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" }
# Czytany tylko w zaufanym projekcie. Klucz trzymaj poza git: lepiej użyć 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 przed uruchomieniem codex
Zapisz plik i zrestartuj Codex. Sprawdzone na codex-cli 0.154.0.
Klucz API poza config.toml. We współdzielonym pliku użyj
env_http_headers tak, aby każdy developer eksportował własny UNIPILE_API_KEY lub http_headers_helper do odczytu z sejfu. Zostaw default_tools_approval_mode na prompt na czas budowania, jeśli każdy zapis ma być potwierdzany.Sprawdzenie połączenia
- 1W CLI
codex mcp listpokazuje unipile jako enabled, acodex mcp get unipilejego nagłówki. - 2W sesji
/mcpwyświetla serwer; Auth Unsupported jest oczekiwane, bo serwer używa nagłówka, a nie OAuth. - 3Na czacie zapytaj:
Korzystając z Unipile MCP, wypisz endpointy wyszukiwania osób na LinkedIn i ich wymagane parametryi oczekuj w odpowiedzi prawdziwych tras.
Prompty zamiast kodu klejącego
Prompt dla agenta
Trzy zadania integracyjne, a przy każdym prompt do wklejenia w Codex, endpointy wywoływane przez agenta na
https://api.unipile.com z nagłówkiem X-API-KEY oraz to, co trafia do projektu.Dodaj do mojego CRM wyszukiwanie osób na LinkedIn, a potem pozwól użytkownikowi otworzyć wybrany profil i rozpocząć z niego rozmowę.
Wyszukiwanie endpointów"linkedin search people profile"3 wyniki
Wykonaj zapytaniePOST /v2/{account_id}/linkedin/search10 wyników
Dodano
GET /api/linkedin/search (słowa kluczowe, kursor paginacji) oraz GET /api/linkedin/profiles/:identifier. Lista wyników przechowuje ID dostawcy zwrócone przez wyszukiwanie, endpoint profilu używa go ponownie, a przycisk „Wiadomość” przekazuje je do utworzenia czatu. Oba uruchomione w aplikacji Development.Jeden identyfikator od wyniku wyszukiwania do rozmowy
Najtrudniej jest zachować ten sam identyfikator od wiersza wyszukiwania przez profil aż po wiadomość. Codex czyta trzy kontrakty i widzi, które pole go przenosi, więc nic nie jest zgadywane.
Endpointy używane przez agenta
Zbuduj integrację z LinkedIn
POST/v2/{account_id}/linkedin/searchGET/v2/{account_id}/users/{identifier}POST/v2/{account_id}/chats
Wygeneruj typowanego klienta Node.js i Python dla używanych przez nas endpointów czatów i e-maili Unipile, na podstawie schematów API, z ponawianiem przy 429.
Odczyt endpointuGET /v2/{account_id}/emailsschemat wczytany
Wykonaj zapytanieGET /v2/{account_id}/chats200 OK
Napisano
unipile-client.ts i unipile_client.py na podstawie schematów żądań i odpowiedzi: typowane metody list i send dla czatów i e-maili, helper paginacji kursorem, wykładniczy backoff przy 429 z nagłówkiem Retry-After. Oba klienty wykonały wywołania list w aplikacji Development.Typowane klienty z prawdziwych schematów, nie z pamięci
Codex czyta body zapytania i schemat odpowiedzi każdej trasy, generuje typy i wykonuje jedno wywołanie na metodę w aplikacji Development. Oficjalne SDK dla Node.js i Pythona pozostają punktem odniesienia.
Endpointy używane przez agenta
Zobacz oficjalne SDK
GET/v2/{account_id}/chatsPOST/v2/{account_id}/chats/{chat_id}/messages/sendGET/v2/{account_id}/emailsPOST/v2/{account_id}/emails/send
Obsłuż wiele podłączonych kont dla każdego użytkownika mojego SaaS: mogą podłączyć kilka kont LinkedIn i e-mail oraz wybrać, z którego wysyłają.
Odczyt endpointuGET /v2/accountsschemat wczytany
Wykonaj zapytanieGET /v2/accounts3 konta
Dodano tabelę
accounts z kluczem według użytkownika i account_id, selektor w oknie redagowania oraz POST /api/messages wysyłający z wybranego konta. Stany ponownego połączenia z endpointu kont są pokazywane jako etykieta. Sprawdzone na trzech kontach w aplikacji Development.Jeden użytkownik, kilka kont, jeden Scope na workspace
Każde konto, które użytkownicy podłączają przez Hosted Auth, dostaje własne
account_id. Agent mapuje użytkowników na te ID, pokazuje stany ponownego połączenia i checkpointów oraz kieruje każdą wysyłkę na konto wybrane przez użytkownika.Endpointy używane przez agenta
Hosted Auth wdrożony przez agenta
GET/v2/accountsGET/v2/accounts/{account_id}POST/v2/auth/linkPOST/v2/{account_id}/chats
Najpierw aplikacja Development
Codex dostaje klucz z zakresem z aplikacji Development, oddzielonej od Production.
Konta testowe, prawdziwe zapytania
Agent wykonuje zapytania na kontach testowych, w imieniu uwierzytelnionego użytkownika, który je podłączył, w granicach limitów każdego dostawcy.
Sprawdź każdy przepływ
Sprawdź przepływ połączenia, jeden odczyt i jeden zapis na funkcję oraz dostarczenie webhooka.
Potem przełączenie na Production
Nic nie dotyka kont użytkowników, dopóki klucz nie zostanie przełączony. Zobacz bezpieczeństwo i zgodność.
Rozwiązywanie problemów
Częste błędy i ich znaczenie
Co widać, gdy wpis MCP w Codex jest nieprawidłowy, i poprawka dla każdego przypadku.
Serwer nie pojawia się po edycji config.toml
Zrestartuj Codex, potem sprawdź CODEX_HOME i uruchom codex mcp list w powłoce, z której uruchamiany jest Codex.
Konfiguracja projektu jest ignorowana
Oznacz projekt jako zaufany przez trust_level = "trusted" w sekcji [projects."/path/to/repo"], ewentualnie przenieś wpis do ~/.codex/config.toml.
Niepoprawny TOML
Nazwij tabelę [mcp_servers.unipile] dokładnie w ten sposób, a http_headers zdefiniuj jako tabelę, z "X-API-KEY" w cudzysłowie.
401 Unauthorized przy żądaniach
Wyeksportuj zmienną wskazaną w env_http_headers w powłoce, która uruchomiła Codex, i użyj klucza Account API z zakresem.
Ustawienia pokazują, że serwer jest niedostępny
Nic nie trzeba zmieniać: ten test szuka zasobów, a serwer Unipile udostępnia akcje, co potwierdza /mcp w sesji.
Przekroczony czas
Sprawdź URL (?branch=v2.0 włącznie), sieć i ewentualne proxy, zanim zwiększysz startup_timeout_sec.
6000+
Firmy, które wprowadzają innowacje z Unipile
Zaufali nam liderzy branży
1 API
Usprawnij obsługę wszystkich głównych kanałów komunikacji
2 dni
Szybkie uruchomienie integracji przy minimalnej konfiguracji
30%
Mniej pracy i zasobów na utrzymanie
Wbudowane bezpieczeństwo i zgodność
Ochrona klasy enterprise dla danych i procesów Więcej o naszym bezpieczeństwie
SOC 2 Type II
Certyfikat
Niezależnie audytowane mechanizmy bezpieczeństwa, które zapewniają ochronę danych i ciągłość działania.
GDPR
Zgodność
Pełna zgodność z europejskimi przepisami o ochronie danych osobowych.
99.9%
Dostępności platformy w ciągu ostatnich 24 miesięcy
24/7
Globalne wsparcie i wydajne API
FAQ: serwer MCP w Codex
Pytania, które ludzie naprawdę wpisują: config.toml zamiast mcp.json, gdzie leży plik, codex mcp add, klucz poza plikiem, trzy interfejsy, co sprawdzić, gdy nic się nie pojawia, timeouty i klucze.
Nie. Codex przechowuje konfigurację MCP w
~/.codex/config.toml, w formacie TOML, po jednej tabeli na serwer o nazwie [mcp_servers.<name>]. W Codex nie ma pliku mcp.json, a plik nie powstaje przy instalacji: tworzy się go samodzielnie albo codex mcp add tworzy go automatycznie. Zaufany projekt może też mieć .codex/config.toml w swoim katalogu głównym.~/.codex/config.toml dla konfiguracji użytkownika, .codex/config.toml w katalogu głównym repozytorium dla konfiguracji projektu. Zmienna środowiskowa CODEX_HOME przenosi cały katalog konfiguracji: gdy serwer widać w jednym terminalu, a w innym nie, to ją należy sprawdzić najpierw. Codex CLI, rozszerzenie IDE i aplikacja desktopowa czytają ten sam plik.Częściowo.
codex mcp add unipile --url "https://developer.unipile.com/mcp?branch=v2.0" zapisuje tabelę dla serwera streamable HTTP, a --bearer-token-env-var obsługuje serwery przyjmujące token Bearer. Serwer Unipile uwierzytelnia się przez X-API-KEY jako nagłówek, a tego polecenie nie potrafi ustawić, więc do utworzonego wpisu trzeba dodać http_headers lub env_http_headers ręcznie. Sprawdzone na codex-cli 0.154.0.Używaj
env_http_headers = { "X-API-KEY" = "UNIPILE_API_KEY" }: mapuje nazwę nagłówka na nazwę zmiennej środowiskowej zamiast wartości, więc plik można zacommitować bez sekretu, a każdy developer eksportuje własny klucz Account API przypisany do Scope. http_headers służy do wartości statycznych, a http_headers_helper pozwala lokalnemu poleceniu wygenerować nagłówki jako JSON.Tak. Trzy interfejsy jednego hosta Codex czytają tę samą konfigurację, więc serwer dodany raz jest dostępny wszędzie. W aplikacji desktopowej i w rozszerzeniu można go też dodać przez Settings, MCP servers, Add server, wybierając Streamable HTTP. Po zapisaniu pliku należy zrestartować klienta.
Cztery przyczyny, po kolei: klient nie został zrestartowany; plik leży pod innym
CODEX_HOME niż bieżąca powłoka; tabela jest w projektowym .codex/config.toml a projekt nie jest oznaczony trust_level = "trusted", i wtedy Codex całkowicie pomija warstwę projektu; albo TOML jest niepoprawny. Uruchom codex mcp list, a potem /mcp w sesji.startup_timeout_sec nadpisuje domyślny 10-sekundowy timeout startu, a tool_timeout_sec domyślny 60-sekundowy timeout na narzędzie, oba w tabeli serwera. Serwer Unipile jest zdalny, działa przez HTTP i nie ma lokalnego procesu do uruchomienia, więc timeout startu prawie zawsze wskazuje na URL, sieć lub proxy firmowe, a nie na serwer.Serwer odpowiada bez klucza, gdy agent tylko czyta specyfikację API. Aby wykonywać prawdziwe żądania, należy utworzyć Scope w aplikacji Development, przypisać konta testowe i wygenerować dla tego Scope klucz Account API. Klientowi MCP nigdy nie należy dawać klucza Service ani globalnego klucza Account.