ChatGPT Belgeleri
Türkçe
İletişim goolvyouyou@gmail.com

Model Context Protocol

Codex'e üçüncü taraf araçlarına ve bağlama erişim verin

Model Context Protocol (MCP), modelleri araçlara ve bağlama bağlar. ChatGPT veya Codex'e üçüncü taraf belgelerine erişim vermek ya da tarayıcınız veya Figma gibi geliştirici araçlarıyla etkileşim kurmasını sağlamak için bunu kullanın.

ChatGPT web, eklentiler tarafından sağlanan uzak MCP destekli araçları kullanabilir. Yerel Codex istemcileri de doğrudan MCP sunucularına bağlanabilir ve yapılandırmalarını paylaşabilir.

ChatGPT masaüstü uygulaması, Codex CLI ve IDE uzantısı MCP sunucularını destekler ve aynı Codex ana makinesi için MCP yapılandırmasını paylaşır.

Aşağıdaki desteklenen sunucu özellikleri, bir Codex ana makinesinde yapılandırılmış MCP sunucuları için geçerlidir. Barındırılan eklenti araçları farklı yeteneklere sahip olabilir.

Desteklenen MCP özellikleri

  • STDIO sunucuları: Yerel bir işlem olarak çalışan (bir komutla başlatılan) sunucular.
    • Ortam değişkenleri
  • Akış destekli HTTP sunucuları: Bir adres üzerinden eriştiğiniz sunucular.
    • Bearer belirteciyle kimlik doğrulama
    • OAuth kimlik doğrulaması
    • Güvenilir birinci taraf sunucular için ChatGPT oturumuyla kimlik doğrulama
  • Sunucu talimatları: Codex, başlatma sırasında döndürülen MCP instructions alanını okur ve sunucunun araçlarıyla birlikte sunucu genelinde geçerli yönlendirme olarak kullanır.

Codex için bir MCP sunucusu geliştiriyor veya bakımını yapıyorsanız sunucu genelinde geçerli araçlar arası iş akışları, kısıtlamalar ve hız sınırları için instructions kullanın. Codex sunucuyu nasıl kullanacağına karar verirken en önemli yönlendirmenin erişilebilir olması için ilk 512 karakteri kendi başına anlaşılır tutun.

Codex'i bir MCP sunucusuna bağlama

Codex, MCP yapılandırmasını diğer Codex yapılandırma ayarlarıyla birlikte config.toml içinde saklar. Bu konum varsayılan olarak ~/.codex/config.toml şeklindedir; ancak MCP sunucularının kapsamını .codex/config.toml ile bir projeyle de sınırlayabilirsiniz (yalnızca güvenilir projeler).

ChatGPT masaüstü uygulaması, Codex CLI ve IDE uzantısı bu yapılandırmayı paylaşır. MCP sunucularınızı yapılandırdıktan sonra kurulumu yeniden yapmadan bu istemciler arasında geçiş yapabilirsiniz.

ChatGPT masaüstü uygulamasında yapılandırma

  1. Ayarlar'ı açın, ardından MCP sunucuları'nı seçin.
  2. Sunucu ekle'yi seçin.
  3. Bir ad girin, STDIO veya Akış destekli HTTP seçeneğini belirleyin ve sunucunun komutunu ya da URL'sini sağlayın.
  4. Sunucuyu kaydedin, ardından Yeniden başlat'ı seçin.

Sunucu listesi, hangi sunucuların etkin olduğunu ve hangilerinin OAuth gerektirdiğini gösterir. Bir OAuth sunucusunda oturum açılması gerektiğinde Kimlik doğrula'yı seçin. Bağlı sunucuları görüntülemek için oluşturucuya /mcp yazın.

config.toml ile yapılandırma

Daha ayrıntılı denetim için ~/.codex/config.toml dosyasını veya proje kapsamlı bir .codex/config.toml dosyasını düzenleyin. Desteklenen tüm MCP seçeneklerinin aranabilir listesi için yapılandırma referansına bakın.

Her MCP sunucusunu yapılandırma dosyasında bir [mcp_servers.<server-name>] tablosuyla yapılandırın.

STDIO sunucuları

  • command (gerekli): Sunucuyu başlatan komut.
  • args (isteğe bağlı): Sunucuya aktarılacak bağımsız değişkenler.
  • env (isteğe bağlı): Sunucu için ayarlanacak ortam değişkenleri.
  • env_vars (isteğe bağlı): İzin verilecek ve iletilecek ortam değişkenleri.
  • cwd (isteğe bağlı): Sunucunun başlatılacağı çalışma dizini.
  • experimental_environment (isteğe bağlı): Kullanılabilir olduğunda stdio sunucusunu uzak bir yürütücü ortamı üzerinden başlatmak için remote olarak ayarlayın.

env_vars, düz değişken adları veya kaynak içeren nesneler barındırabilir:

env_vars = ["LOCAL_TOKEN", { name = "REMOTE_TOKEN", source = "remote" }]

Dize girdileri ve source = "local", Codex'in yerel ortamından okunur. source = "remote", uzak yürütücü ortamından okunur ve uzak MCP stdio gerektirir.

Akış destekli HTTP sunucuları

  • url (gerekli): Sunucu adresi.
  • auth (isteğe bağlı): Yapılandırılmış bearer belirteçleri ve yetkilendirme üst bilgilerinden sonra denenecek kimlik doğrulama. Saklanan MCP OAuth kimlik bilgileri için oauth (varsayılan) kullanın. Güvenilir birinci taraf ChatGPT kaynağında geçerli ChatGPT oturumunu kullanmak ve saklanan OAuth'ı yedek seçenek yapmak için chatgpt kullanın.
  • bearer_token_env_var (isteğe bağlı): Authorization içinde gönderilecek bearer belirtecinin ortam değişkeni adı.
  • http_headers (isteğe bağlı): Üst bilgi adlarının statik değerlere eşlemesi.
  • env_http_headers (isteğe bağlı): Üst bilgi adlarının ortam değişkeni adlarına eşlemesi (değerler ortamdan alınır).

Hiçbir kimlik bilgisi kaynağı çözümlenemezse Codex sunucuya kimlik doğrulaması olmadan bağlanabilir. Bir MCP OAuth oturumu başlatmak için codex mcp login <server-name> komutunu ayrı olarak çalıştırın.

Diğer yapılandırma seçenekleri

  • startup_timeout_sec (isteğe bağlı): Sunucunun başlaması için zaman aşımı (saniye). Varsayılan: 10.
  • tool_timeout_sec (isteğe bağlı): Sunucunun bir aracı çalıştırması için zaman aşımı (saniye). Varsayılan: 60.
  • enabled (isteğe bağlı): Bir sunucuyu silmeden devre dışı bırakmak için false olarak ayarlayın.
  • required (isteğe bağlı): Etkin olan bu sunucu başlatılamazsa başlangıcın başarısız olması için true olarak ayarlayın.
  • enabled_tools (isteğe bağlı): Araç izin listesi.
  • disabled_tools (isteğe bağlı): Araç engelleme listesi (enabled_tools sonrasında uygulanır).
  • default_tools_approval_mode (isteğe bağlı): Bu sunucudaki araçlar için varsayılan onay davranışı. Desteklenen değerler auto, prompt, writes ve approve şeklindedir. writes modu, salt okunur olarak işaretlenmemiş araçlar için istem gösterir.
  • tools.<tool>.approval_mode (isteğe bağlı): Araç bazında onay davranışı geçersiz kılma ayarı.

OAuth sağlayıcınız sabit bir geri çağırma bağlantı noktası gerektiriyorsa config.toml içindeki üst düzey mcp_oauth_callback_port ayarını belirleyin. Ayarlanmazsa Codex geçici bir bağlantı noktasına bağlanır.

MCP OAuth akışınızın belirli bir geri çağırma URL'si kullanması gerekiyorsa (örneğin uzak bir Devbox giriş URL'si veya özel bir geri çağırma yolu), mcp_oauth_callback_url ayarını belirleyin. Codex bu değeri temel geri çağırma URL'si olarak kullanır, ardından oturum açma sırasında gönderdiği OAuth redirect_uri değerini oluşturmak için sunucuya özgü bir geri çağırma kimliği ekler. OAuth sağlayıcınıza yalnızca temel ana makineyi veya bu sonek olmadan yolu kaydetmek yerine eklenmiş geri çağırma kimliği ile yapılandırılmış tüm yol, sorgu veya bağlantı noktalarını içeren türetilmiş redirect_uri değerinin tamamını kaydedin. Yerel geri çağırma URL'leri (örneğin localhost) yerel arayüze bağlanır; yerel olmayan geri çağırma URL'leri ise geri çağırmanın ana makineye ulaşabilmesi için 0.0.0.0 üzerine bağlanır.

MCP sunucusu scopes_supported duyuruyorsa Codex, OAuth oturumu açılırken sunucunun duyurduğu bu kapsamları tercih eder. Aksi durumda Codex, config.toml içinde yapılandırılan kapsamlara geri döner.

config.toml örnekleri

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]
env_vars = ["LOCAL_TOKEN"]

[mcp_servers.context7.env]
MY_ENV_VAR = "MY_ENV_VALUE"
# Optional MCP OAuth callback overrides (used by `codex mcp login`)
mcp_oauth_callback_port = 5555
mcp_oauth_callback_url = "https://devbox.example.internal/callback"
[mcp_servers.figma]
url = "https://mcp.figma.com/mcp"
bearer_token_env_var = "FIGMA_OAUTH_TOKEN"
http_headers = { "X-Figma-Region" = "us-east-1" }
[mcp_servers.chrome_devtools]
url = "http://localhost:3000/mcp"
enabled_tools = ["open", "screenshot"]
disabled_tools = ["screenshot"] # applied after enabled_tools
default_tools_approval_mode = "prompt"
startup_timeout_sec = 20
tool_timeout_sec = 45
enabled = true

[mcp_servers.chrome_devtools.tools.open]
approval_mode = "approve"

Eklentiler tarafından sağlanan MCP sunucuları

Yüklü eklentiler, eklenti manifestlerinde MCP sunucuları barındırabilir. Bu sunucular eklentiden başlatıldığı için kullanıcı yapılandırması bunların aktarım komutunu belirlemez. Kullanıcı yapılandırması, plugins.<plugin>.mcp_servers.<server> altında açma/kapatma durumunu ve araç politikasını yine de denetleyebilir.

[plugins."sample@test".mcp_servers.sample]
enabled = true
default_tools_approval_mode = "prompt"
enabled_tools = ["read", "search"]

[plugins."sample@test".mcp_servers.sample.tools.search]
approval_mode = "approve"

Yararlı MCP sunucusu örnekleri

MCP sunucularının listesi büyümeye devam ediyor. Yaygın örneklerden bazıları şunlardır:

  • OpenAI Docs MCP: OpenAI geliştirici belgelerinde arama yapın ve belgeleri okuyun.
  • Context7: Güncel geliştirici belgelerine bağlanın.
  • Figma Yerel ve Uzak: Figma tasarımlarınıza erişin.
  • Playwright: Playwright kullanarak bir tarayıcıyı denetleyin ve inceleyin.
  • Chrome Geliştirici Araçları: Chrome'u denetleyin ve inceleyin.
  • Sentry: Sentry günlüklerine erişin.
  • GitHub: GitHub'ı git tarafından desteklenenlerin ötesinde yönetin (örneğin çekme istekleri ve sorunlar).