Entegrasyon kılavuzları
LinkedIn API kılavuzu
E-posta API kılavuzu
WhatsApp API kılavuzu
Satış ekibiyle iletişime geçin
Codex · MCP Sunucusu
Codex MCP Sunucusu: ürününüzde mesajlaşma ve e-posta
Üç satırlık config.toml, Unipile MCP sunucusunu bağlar. Ardından Codex; CLI, IDE eklentisi veya masaüstü uygulamasından ürününüze LinkedIn, WhatsApp ve e-posta özellikleri ekler. Yerel olarak kurulacak veya çalıştırılacak bir şey yok.
7 gün ücretsiz deneme, kredi kartı gerekmez.
Codex · crm-app
Unipile MCP bağlı
CRM'ime LinkedIn kişi araması ekle.
Endpoint'i okuPOST /v2/{account_id}/linkedin/searchşema yüklendi
Arama route'u ve sonuç listesi eklendi. Her satır, profilin sağlayıcı ID'sini saklıyor.
Sonraki özelliği anlatın…
Kullanım senaryosu
Codex'ten ürününüze LinkedIn, WhatsApp ve e-posta ekleyin
Ürününüze LinkedIn, WhatsApp, e-posta veya takvim ekleyin. Unipile MCP sunucusu sayesinde Codex API referansını okur, kodu sizin stack'inizde yazar ve her isteği test eder.
Unipile MCP sunucusunu Codex'e bağlayınUnipile MCP bağlı
Bağlamak istediğiniz kanalları seçin
developer.unipile.com/mcpTüm kanalları bağla10 kanal
↑↓gezin boşlukseç ↵bağlatek URL, tek header
config.toml, CLI ve IDE
Unipile MCP sunucusunu ekleyin: Codex
Sunucu uzaktadır: streamable HTTP üzerinden tek bir URL ve tek bir header, yerelde çalıştırılacak hiçbir şey yok. config.toml'daki tek bir kayıt Codex CLI, IDE eklentisi ve ChatGPT masaüstü uygulaması için geçerlidir.
Başlamadan önce: Codex CLI veya IDE eklentisi kurulu ve oturum açılmış olmalı; Unipile dashboard içinde Scope'a bağlı bir Account API anahtarına sahip bir Development uygulaması ve Hosted Auth ile bağlanmış bir test hesabı gerekir.
codex mcp add, ardından headerURL'yi ~/.codex/config.toml içine kaydeder
Global yapılandırma~/.codex/config.toml
Proje yapılandırması.codex/config.toml (güvenilir proje)
Anahtar bir ortam değişkenindenenv_http_headers
?
CLI'da neden iki adım?codex mcp add özel header bayrağı sunmaz; bu yüzden X-API-KEY header'ı config.toml'a elle ya da env_http_headers ile eklenir.
# 1. Barındırılan Unipile MCP sunucusunu kaydedin (global yapılandırma)
codex mcp add unipile --url "https://developer.unipile.com/mcp?branch=v2.0"
# Added global MCP server 'unipile'.
# 2. X-API-KEY header'ını ~/.codex/config.toml içindeki kayda ekleyin
[mcp_servers.unipile]
url = "https://developer.unipile.com/mcp?branch=v2.0"
http_headers = { "X-API-KEY" = "your-scoped-api-key" }
# 3. Doğrulayın
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" }
# Yalnızca güvenilir bir projede okunur. Anahtarı git dışında tutun: env_http_headers tercih edin.
[mcp_servers.unipile]
url = "https://developer.unipile.com/mcp?branch=v2.0"
env_http_headers = { "X-API-KEY" = "UNIPILE_API_KEY" }
# codex'i başlatmadan önce: export UNIPILE_API_KEY=your-scoped-api-key
Dosyayı kaydedin ve Codex'i yeniden başlatın. codex-cli 0.154.0 ile doğrulandı.
API anahtarınızı config.toml dışında tutun. Paylaşılan bir dosyada
env_http_headers kullanın; böylece her geliştirici kendi UNIPILE_API_KEY değişkenini export eder. Ya da anahtarı bir kasadan okumak için http_headers_helper kullanın. Geliştirme sırasında her yazma işlemini onaylamak istiyorsanız default_tools_approval_mode değerini prompt olarak bırakın.Bağlantıyı doğrulayın
- 1CLI'da
codex mcp listunipile'ı etkin olarak gösterir,codex mcp get unipileise header'larını gösterir. - 2Bir oturumda
/mcpsunucuyu listeler; Auth Unsupported beklenen bir durumdur, çünkü OAuth değil header kullanılır. - 3Bir sohbette şunu sorun:
Unipile MCP'yi kullanarak LinkedIn kişi araması endpoint'lerini ve zorunlu parametrelerini listeleve yanıt olarak gerçek route'lar bekleyin.
Glue code değil, prompt'lar
Ajanınıza prompt'u verin
Üç entegrasyon görevi; her biri için Codex'e yapıştırılacak prompt, ajanın
https://api.unipile.com üzerinde X-API-KEY anahtarınızla çalıştırdığı endpoint'ler ve projenize eklenenler.CRM'ime LinkedIn kişi araması ekle, ardından kullanıcının seçilen profili açıp oradan bir konuşma başlatmasını sağla.
Endpoint ara"linkedin search people profile"3 eşleşme
İsteği çalıştırPOST /v2/{account_id}/linkedin/search10 sonuç
Eklenen route'lar:
GET /api/linkedin/search (anahtar kelimeler, sayfalama cursor'ı) ve GET /api/linkedin/profiles/:identifier. Sonuç listesi aramanın döndürdüğü sağlayıcı ID'sini saklar, profil route'u onu yeniden kullanır ve "Mesaj" butonu onu sohbet oluşturmaya iletir. İkisi de Development uygulamasında çalıştırıldı.Arama sonucundan konuşmaya tek bir tanımlayıcı
Zor olan, aynı tanımlayıcıyı arama satırından profile, ardından mesaja kadar korumaktır. Codex üç sözleşmeyi okur ve bunu hangi alanın taşıdığını görür; hiçbir şey tahmine bırakılmaz.
Ajanın kullandığı endpoint'ler
LinkedIn entegrasyonu geliştirin
POST/v2/{account_id}/linkedin/searchGET/v2/{account_id}/users/{identifier}POST/v2/{account_id}/chats
Kullandığımız Unipile chats ve emails route'ları için API şemalarından tipli bir Node.js ve Python istemcisi üret; 429'da yeniden deneme olsun.
Endpoint'i okuGET /v2/{account_id}/emailsşema yüklendi
İsteği çalıştırGET /v2/{account_id}/chats200 OK
Yazılanlar:
unipile-client.ts ve unipile_client.py (istek ve yanıt şemalarından): chats ve emails için tipli list ve send metotları, cursor sayfalama yardımcısı, 429'da Retry-After header'ıyla üstel geri çekilme. İki istemci de liste çağrılarını Development uygulamasında çalıştırdı.Bellekten değil, gerçek şemalardan tipli istemciler
Codex her route'un istek gövdesini ve yanıt şemasını okur, tipleri üretir ve Development uygulamanızda her metot için bir çağrı çalıştırır. Resmi Node.js ve Python SDK'ları referans olmaya devam eder.
Ajanın kullandığı endpoint'ler
Resmi SDK'lara bakın
GET/v2/{account_id}/chatsPOST/v2/{account_id}/chats/{chat_id}/messages/sendGET/v2/{account_id}/emailsPOST/v2/{account_id}/emails/send
SaaS'ımın her kullanıcısı için birden fazla bağlı hesabı destekle: birkaç LinkedIn ve e-posta hesabı bağlayabilsinler ve hangisinin göndereceğini seçebilsinler.
Endpoint'i okuGET /v2/accountsşema yüklendi
İsteği çalıştırGET /v2/accounts3 hesap
Eklenenler: bir
accounts tablosu (anahtarı kullanıcı ve account_id), composer'da bir hesap seçici ve POST /api/messages route'u; bu route seçilen hesap üzerinden gönderir. accounts route'undan gelen yeniden bağlanma durumları rozet olarak gösterilir. Development uygulamasında üç hesapla doğrulandı.Bir kullanıcı, birkaç hesap, workspace başına bir Scope
Kullanıcılarınızın Hosted Auth ile bağladığı her hesabın kendine ait bir kimliği vardır:
account_id. Ajan kullanıcılarınızı bu ID'lerle eşler, yeniden bağlanma ve checkpoint durumlarını gösterir ve her gönderimi kullanıcının seçtiği hesaba yönlendirir.Ajanın kullandığı endpoint'ler
Hosted Auth'u bir ajanla uygulayın
GET/v2/accountsGET/v2/accounts/{account_id}POST/v2/auth/linkPOST/v2/{account_id}/chats
Önce bir Development uygulaması
Codex'e, Production'dan ayrı tutulan bir Development uygulamasından Scope'a bağlı bir anahtar verin.
Test hesapları, gerçek istekler
Ajan, istekleri test hesapları üzerinde, onları bağlayan kimliği doğrulanmış kullanıcı adına ve her sağlayıcının sınırları içinde çalıştırır.
Her akışı doğrulayın
Bağlantı akışını, özellik başına bir okuma ve bir yazmayı ve bir webhook teslimatını kontrol edin.
Sonra Production'a geçin
Anahtarı değiştirene kadar kullanıcılarınızın hesaplarına hiçbir şey dokunmaz. Ayrıntılar: güvenlik ve uyumluluk.
Sorun giderme
Sık karşılaşılan hatalar ve anlamları
Bir Codex MCP kaydı doğru olmadığında gördükleriniz ve her birinin çözümü.
config.toml düzenlendikten sonra sunucu görünmüyor
Codex'i yeniden başlatın, ardından Codex'i başlattığınız kabukta CODEX_HOME değerini kontrol edin ve codex mcp list komutunu çalıştırın.
Proje yapılandırması yok sayılıyor
Projeyi güvenilir olarak işaretleyin: trust_level = "trusted" satırını şu tablonun altına ekleyin: [projects."/path/to/repo"]; ya da kaydı ~/.codex/config.toml dosyasına taşıyın.
Geçersiz TOML
Tabloyu tam olarak [mcp_servers.unipile] olarak adlandırın ve http_headers değerini bir tablo yapın; "X-API-KEY" tırnak içinde olmalı.
İsteklerde 401 Unauthorized
Adı env_http_headers içinde geçen değişkeni Codex'i başlatan kabukta export edin ve Scope'a bağlı bir Account API anahtarı kullanın.
Ayarlar sunucunun kullanılamadığını söylüyor
Değiştirilecek bir şey yok: bu kontrol resource arar, Unipile sunucusu ise action sunar; /mcp bunu doğrular.
Zaman aşımı
URL'yi (?branch=v2.0 dahil), ağı ve varsa proxy'yi kontrol edin; ancak bundan sonra startup_timeout_sec değerini artırın.
6000+
Unipile ile inovasyon yapan şirketler
Sektör liderlerinin güvendiği çözüm
1 API
Tüm büyük iletişim kanallarında operasyonları sadeleştirin
2 gün
Minimum kurulumla hızla canlı entegrasyon
30%
Bakım eforu ve kaynaklarında azalma
Yerleşik güvenlik ve uyumluluk
Verileriniz ve iş akışlarınız için kurumsal düzeyde koruma Güvenliğimiz hakkında daha fazla bilgi
SOC 2 Type II
Sertifikalı
Veri korumasını ve operasyonel bütünlüğü güvence altına alan, bağımsız olarak denetlenmiş güvenlik kontrolleri.
GDPR
Uyumlu
Kullanıcı gizliliği için Avrupa veri koruma düzenlemelerine tam uyum.
99.9%
Son 24 ayda platform çalışma süresi
24/7
Yüksek performanslı API ile küresel destek
Codex MCP sunucusu SSS
Gerçekten sorulan sorular: mcp.json yerine config.toml, dosyanın yeri, codex mcp add, anahtarı dosya dışında tutmak, üç arayüz, hiçbir şey görünmediğinde neye bakılacağı, zaman aşımları ve anahtarlar.
Hayır. Codex MCP yapılandırmasını şurada saklar:
~/.codex/config.toml, TOML biçiminde, sunucu başına bir tablo olarak; tablo adı: [mcp_servers.<name>]. Codex'te mcp.json yoktur ve dosya kurulumda oluşturulmaz: onu siz oluşturursunuz ya da codex mcp add sizin için oluşturur. Güvenilir bir proje, kökünde bir .codex/config.toml dosyası da taşıyabilir.~/.codex/config.toml kullanıcı yapılandırması içindir, .codex/config.toml ise depo kökünde, proje yapılandırması içindir. CODEX_HOME ortam değişkeni tüm yapılandırma dizinini taşır: bir sunucu bir terminalde görünüp diğerinde görünmüyorsa önce bunu kontrol edin. Codex CLI, IDE eklentisi ve masaüstü uygulaması aynı dosyayı okur.Kısmen.
codex mcp add unipile --url "https://developer.unipile.com/mcp?branch=v2.0" komutu streamable HTTP sunucusu için tabloyu yazar, --bearer-token-env-var ise Bearer token alan sunucuları kapsar. Unipile sunucusu kimlik doğrulamayı bir X-API-KEY header'ıyla yapar ve komut bunu ayarlayamaz; bu yüzden oluşturduğu kayda http_headers veya env_http_headers ekleyin. codex-cli 0.154.0 üzerinde doğrulandı.Şunu kullanın:
env_http_headers = { "X-API-KEY" = "UNIPILE_API_KEY" }; bu satır header adını bir değer yerine bir ortam değişkeninin adına eşler, böylece dosya gizli bilgi olmadan commit edilebilir ve her geliştirici kendi Scope'a bağlı Account API anahtarını export eder. http_headers statik değerler içindir, http_headers_helper ise yerel bir komutun header'ları JSON olarak üretmesini sağlar.Evet. Bir Codex kurulumunun üç arayüzü aynı yapılandırmayı okur; bir kez eklenen sunucu her yerde kullanılabilir. Masaüstü uygulamasında ve eklentide sunucuyu Settings, MCP servers, Add server yolundan Streamable HTTP seçerek de ekleyebilirsiniz. Dosyayı kaydettikten sonra istemciyi yeniden başlatın.
Sırasıyla dört neden: istemci yeniden başlatılmadı; dosya mevcut shell'inizden farklı bir
CODEX_HOME altında duruyor; tablo bir proje .codex/config.toml dosyasında ve proje şu şekilde işaretlenmemiş: trust_level = "trusted", bu durumda Codex proje katmanını tamamen atlar; ya da TOML geçersiz. Önce codex mcp list, ardından /mcp komutunu oturum içinde çalıştırın.startup_timeout_sec varsayılan 10 saniyelik başlangıç zaman aşımını, tool_timeout_sec ise araç başına varsayılan 60 saniyelik zaman aşımını geçersiz kılar; ikisi de sunucu tablosunun altında yer alır. Unipile sunucusu HTTP üzerinden uzaktadır ve başlatılacak yerel bir süreç yoktur; bu yüzden başlangıç zaman aşımı neredeyse her zaman sunucuya değil URL'ye, ağa ya da kurumsal bir proxy'ye işaret eder.Ajan yalnızca API spesifikasyonunu okuduğunda sunucu anahtarsız yanıt verir. Gerçek istekler çalıştırmak için Development uygulamanızda bir Scope oluşturun, test hesaplarını atayın ve bu Scope'a bağlı bir Account API anahtarı üretin. Bir MCP istemcisine asla Service anahtarı veya global Account anahtarı vermeyin.