MCP GATEWAY
Genel bakış
Servisleriniz, araçlarınız ve son işlemleriniz bir arada.
BİR SONRAKİ ADIM
İhtiyacınız olan araca ulaşın.
İşi tarif ederek katalogda arama yapın.
Araç şemasını inceleyin ve çağrıyı kontrollü
başlatın.
Bağlantı özeti
Son hareketler
Servis kataloğu
Eski MCP paket arşivi
Gateway içinde program çalıştırma kapalıdır. ZIP arşivini uzak sunucuya aktarın ve SSH stdio MCP bağlantısı ekleyin. HTTP MCP sunucularına doğrudan bağlanabilirsiniz.
Python örnek ZIP indirMevcut paketleri sürüm arşivi olarak saklayabilir ve indirebilirsiniz. Çalıştırılacak dosyaları SSH sunucusuna ayrıca aktarın; servis kaydına uzak programın yolunu girin.
+ ZIP arşivi ekle (çalıştırılmaz)
Yeni MCP kaynağı bul
Bu dizin kayıtlı araçlardan bağımsızdır. Sonuçlar otomatik kurulmaz; servis olarak kaydetmeden önce bağlantıyı ve kimlik doğrulama koşullarını inceleyin. Resmî Registry sunucu adında arar ve API anahtarı gerektirmez.
Dizin bağlantı ayarları
Konuya göre MCP arama
Yapmak istediğiniz işi açıklayın. Önce kısa aday listesi gelir; yalnız seçtiğiniz aracın şeması yüklenir. Seçim çağrı başlatmaz.
Bağlantı bekleniyor.
Araç denemesi
Keşfedilmiş tüm izinli araçlar servislerine göre listelenir. Seçtiğiniz aracın girdileri şemadan hazırlanır; çağrı sonrası seçim ve taslak korunur.
Araç açıklaması burada gösterilir.
Araç şemasını göster
Araç şeması burada gösterilir.
İstek parametreleri
JSON girdilerini düzenle · gelişmiş
Son çağrı sonucu
Sonuç bekleniyor.
Tam MCP yanıtı (JSON)
Son işlemler
Bu tablo işlem metaverisini gösterir. Maskeli istek ve yanıt içerikleri, kayıt etkinse İstekler ve cevaplar sayfasından okunur.
| Zaman | Kimlik | Hedef / araç | Durum |
|---|
Günlük kullanım
UTC günü için istemci, araç ve katalog sayaçları ayrı tutulur.
| Gün / kapsam | Kimlik / hedef | Toplam | Başarılı / hata / ret / bekleyen / iptal | Süre (ms) |
|---|
İstekler ve cevaplar
PostgreSQL’deki kayıtları bulun; aynı çağrının istemci ve MCP istek/yanıtını birlikte inceleyin.
İçerik kayıt durumu yükleniyor…
| Zaman / istek kimliği | Yön | Kimlik / hedef | Metot / sonuç | Giriş / çıkış bayt | İçerik / inceleme |
|---|
Bu filtrelerle kayıt bulunamadı. Yeni bir araç çağırın veya filtreleri genişletin. Eski kayıtlar için sayfalama yapabilirsiniz.
Sayfa 1
İstek / yanıt içerik kayıt ayarları
İçerik kaydı açıldıktan sonraki çağrılar saklanır; daha önce içeriksiz saklanmış kayıtların gövdeleri geri oluşturulamaz.
API anahtarları
Önce agent veya uygulama için kullanıcı kimliği oluşturun, ardından o kullanıcıya API anahtarı tanımlayın. Kullanıcı kaydı panel parolası oluşturmaz.
| Anahtar / kullanıcı | Durum | Yetki kapsamı | Geçerlilik bitişi | İşlemler |
|---|
Kullanıcılar
Kullanıcı pasifleştirildiğinde ona bağlı tüm anahtarlar erişimi kaybeder.
| Kullanıcı adı | Rol | Durum | İşlemler |
|---|
Oturum ve güvenlik
30 dakika boşta kalma süresi · En fazla 8 saat oturum · Şifre değişikliğinde tüm oturumlar kapanır.
Model destekli araç araması
İsteğe bağlı. Kapalıyken arama anahtar kelimeyle yapılır ve hiçbir yere istek gitmez. Açılırsa
arama metni buradaki OpenAI uyumlu sunucuya gönderilir: LM Studio, Ollama, vLLM/SGLang ya da
ai.memnundemir.com (gömme modeli olarak örneğin gomme). Bağlantı kontrolü yalnız
model listesini sorgular; araç çalıştırmaz.
Sağlayıcı kontrolü henüz yapılmadı.
AGENT BAĞLANTISI
Gateway’i MCP olarak ekleyin
Agentınız gateway’e tek bağlantı kurar. Servisleri ve araçları bu bağlantı üzerinden, API anahtarının izinleriyle keşfeder.
Streamable HTTP · Bearer API anahtarı
Agent bu bilgisayarda çalışıyorsa bu adresi kullanın. Uzak agent için aşağıdaki ağ bağlantısı bölümünü okuyun.
- Agent için anahtar oluşturun. Kullanıcılar ve erişim bölümünde bir kullanıcı seçin, API anahtarı oluşturun; servis ve araç izinlerini belirleyin. Yeni anahtarı yalnız bir kez görebilirsiniz.
- İstemci ayarını ekleyin. Aşağıdan agentınıza uygun örneği seçin. Anahtarı
istemcinin güvenli girdisine veya
MCP_GATEWAY_API_KEYortam değişkenine kaydedin. - MCP bağlantısını yeniden başlatın. İstemcide gateway’i etkinleştirin, dört keşif/çağrı aracının geldiğini kontrol edin.
- İzinli kataloğu doğrulayın. Agenta “MCP Gateway üzerinden list_mcps çağır ve izinli servisleri göster” deyin.
Panel parolanız MCP anahtarı yerine geçmez. Yönetim görevi olan agent için yönetici kullanıcıya bağlı tam yetkili anahtar gerekir; bu anahtar yönetim API’sinin tamamını ve etkin servislerdeki tüm araçları açar.
Yönetici agent ile panel olmadan yönetim
Yönetici kullanıcıya bağlı tam yetkili API anahtarı, agentın yönetim API’sine doğrudan bağlanmasını sağlar. Tarayıcı oturumu veya panel parolası gerekmez.
- Sözleşmeyi keşfedin. MCP üzerinden
get_management_apiçağırın veyaGET /api/discoveryveGET /api/openapi.jsonokuyun. - İşlemi API ile yapın. Aynı gateway adresine
Authorization: Bearer <yönetici API anahtarı>ile, OpenAPI’deki metot ve şemaya uygun istek gönderin. - Sonucu doğrulayın. Kaydı yeniden okuyun; MCP çağrısında
isErrordurumunu kontrol edin.X-Request-IDile audit ve trafik kayıtlarını inceleyin.
Mevcut API servis CRUD, açıklama/ayarlar, servis anahtarları, kullanıcı
oluşturma/pasifleştirme, API anahtarı/izin/parametre kuralı yönetimi ve trafik/arama
ayarlarını sunar. Kullanıcı rolü düzenleme, yönetici parola sıfırlama ve işletim işleri henüz
ürün geliştirme kapsamındadır; keşif yanıtındaki prototype_gaps bunları
belirtir.
Gerçek üründe tüm yönetim işlemleri bu API ile yapılabilmelidir. Panelde bulunup agent API’sinde bulunmayan bir yönetim işlevi kabul edilmez.
İstemci ayar örnekleri
Ortam değişkenindeki anahtar nasıl kullanılacak?
Codex ve Cursor örnekleri değişkenin adını içerir; gerçek anahtar içermez. İstemciyi
başlatan süreç MCP_GATEWAY_API_KEY değerini görmelidir. Terminalde tanımlanan
değişken, daha önce açılmış masaüstü uygulamasına aktarılmaz. Değişkeni güvenli yerel ayarda
tanımlayıp istemciyi yeniden başlatın. Anahtarı proje deposuna, agent talimatına veya sohbet
mesajına yazmayın. VS Code örneği parola olarak gizlenen etkileşimli girdi kullanır.
Agenta kullanım talimatı
Agentın talimat dosyasına veya skill’ine aşağıdaki akışı ekleyebilirsiniz. Bu talimat bağlantı ayarının yerini almaz.
MCP Gateway'i kullanırken: 1. list_mcps ile erişebildiğin servisleri öğren. 2. search_tools ile ihtiyaca uygun aracı bul; kullanım ve kaçınma açıklamalarını oku. 3. describe_tool ile seçilen aracın şemasını incele. 4. call_tool ile aracı, şemasına uygun girdilerle çağır. İzinli katalog dışındaki araçları tahmin ederek çağırma. API anahtarını veya panel parolasını talimatlara ve loglara ekleme.
Alttaki bütün araçların istemcide ayrı ayrı görünmesi gerekmez. Gateway dört araç üzerinden
izinli katalog keşfi ve çağrı sağlar. Servis ekleme, kullanıcı/anahtar yönetimi gibi idari
işlemler /api/* yönetim API’sindedir; MCP’nin bu dört aracı idari CRUD sağlamaz.
Yönetim skill’i API’ye tam yetkili Bearer anahtarıyla ayrıca bağlanır.
Uzak agent ve ağ bağlantısı
127.0.0.1 agentın çalıştığı bilgisayardır. Mac mini, container veya buluttaki
agent bu adresle kendi ortamına bağlanır. Mevcut Docker prototipi gateway’i yalnız bu
bilgisayarın loopback adresinde yayımlar.
SSH ile güvenli bağlantı
Gateway bilgisayarında erişilebilir bir SSH sunucusu varsa agentın bilgisayarında aşağıdaki
tüneli açın. GATEWAY_SSH_KULLANICISI@GATEWAY_HOST kısmını kendi bağlantınızla
değiştirin. Tünel açıkken istemci URL’si http://127.0.0.1:18787/mcp olur; API
anahtarı yine gereklidir.
ssh -N -L 127.0.0.1:18787:127.0.0.1:8787 GATEWAY_SSH_KULLANICISI@GATEWAY_HOST
Buradaki 8787 gateway’in yayımlanan portudur. Gateway’in Mac mini üzerindeki bir MCP servisine SSH ile bağlanması, Mac mini’nin gateway’e erişmesini otomatik olarak sağlamaz.
Uzak HTTPS erişimi için TLS, güvenilen proxy ve ağ erişim politikası ayrıca yapılandırılmalıdır. Doğrudan portu herkese açmayın. Sadece stdio destekleyen istemciler için HTTP–stdio köprüsü ayrıca gerekir; gateway istemci tarafında stdio sunmaz.
Bağlantı sorunlarını çözme
- 401 · Kimlik doğrulama başarısız
Authorization: Bearer …başlığını ve anahtarın geçerlilik/iptal durumunu kontrol edin. Kullanıcının pasif olması da erişimi keser.- 403 · Yönetim yetkisi yok
- Normal anahtar yönetim API’sine erişemez. Tam yetki için hem kullanıcı hem anahtar yönetici olmalıdır.
- Arama boş veya araç reddediliyor
- Anahtarın servis ve araç izinlerini, servisin etkin durumunu ve katalog bağlantısını kontrol edin. Araç seçimi boş listeyse bütün araçlar kapalıdır.
- Bağlantı reddedildi / timeout
- Docker gateway’in çalıştığını, URL’nin
/mcpile bittiğini ve adresin agentın ortamından erişilebilir olduğunu kontrol edin. - Chrome izin penceresi
- Kişisel Chrome oturumunun yerel kullanıcı onayı gerekir. Gateway anahtarı bu onayın yerine geçmez.
- İzinler değiştiği hâlde eski liste görünüyor
- Gateway yeni istekte güncel politikayı uygular. İstemci katalog önbelleğini yenileyin veya MCP bağlantısını yeniden başlatın.
Örnekler 8 Ekim 2026’da resmî belgelerle karşılaştırıldı. İstemci ayar biçimi sürüme göre değişebilir; kurulum örneği her istemcide canlı bağlantı testi yapılmış olduğu anlamına gelmez.