Bir yapay zeka asistanı, kuruluşunuzun MCP sunucularına iki yoldan biriyle erişir: bir API anahtarıyla ya da oturum açarak bağladığınız bir uygulama olarak. Bu sayfa, her birinin nasıl güvenli biçimde kurulacağını ve erişimin nasıl sonlandırılacağını gösterir. Bağlantı adımları Bir yapay zeka asistanı bağlayın bölümündedir.
MCP anahtarları
Ayrı bir MCP anahtarı türü yoktur. MCP anahtarı, diğer tüm API anahtarları gibi API Anahtarları üzerinden oluşturulan ve MCP istemcilerini bağla (mcp_server.connect) iznine sahip sıradan bir API anahtarıdır. Bkz. Kimlik doğrulama.
Neyi işaretlemeli
| İzin | Gereken yer |
|---|---|
| MCP istemcilerini bağla (grup MCP) | Herhangi bir MCP sunucusuna erişim |
Cihazları görüntüle (iot_device.devices.read) | list_devices, get_device |
Telemetri okuma (telemetry.read) | get_latest_readings, get_reading_series |
Modüllerin Yalnızca okuma ön ayarlarını kullanın; başka bir şey gerekmez. MCP istemcilerini bağla iznine sahip ancak bir aracın iznine sahip olmayan bir anahtar, o aracı görmez. MCP istemcilerini bağla iznine sahip olmayan bir anahtar, sahip olduğu diğer izinlerden bağımsız olarak her MCP sunucusu tarafından reddedilir.
Her araç yalnızca hem anahtar hem de sahibi o aracın iznine sahip olduğunda çalışır. Sahip bir izni kaybederse, asistan bir sonraki çağrısında o aracı kaybeder.
İyi uygulamalar
- Asistan ve kişi başına bir anahtar. Kimin kullandığını anlayabilmeniz için adlandırın: “Masaüstü asistan – Alex”.
- Kısa son kullanma tarihi. 30 ila 90 gün, ardından yenileyin.
- IP izin listesi, asistan sabit bir sunucuda çalıştığında.
- Başka izin yok. Ek izinleri olan bir MCP anahtarı, bu izinlerle REST API üzerinde de çalışır.
- Anahtarı paylaşılan dosyalardan uzak tutun. Asistan yapılandırma dosyaları genellikle eşitlenir ya da depoya eklenir; izin verildiği yerlerde anahtarı asistanın gizli depolama alanında ya da bir ortam değişkeninde saklayın.
Anahtarı izleme ve sonlandırma
- Anahtarın sayfasında Son kullanım, Son kullanım IP’si ve Toplam doğrulama görünür.
- Her araç çağrısı, denetim günlüğünde
mcp_server.tool.called(veyamcp_server.tool.refused) olarak yer alır; işlemi yapan olarak anahtar, araç, sonuç ve süre bilgileriyle birlikte. - Anahtarın sayfasındaki Devre dışı bırak, İptal et veya Anahtarı yenile seçenekleri erişimi hemen sonlandırır ya da değiştirir. Bkz. Kimlik doğrulama.
- AI firewall, hatalı davranan anahtarlarla ilgili olayları kaydeder ve böyle bir anahtarı kısıtlayabilir veya iptal edebilir.
Bağlı uygulamalar
Oturum açarak bağladığınız bir uygulama, Bağlı uygulamalar sayfasında listelenir (menünün Geliştirici bölümünde): “Bu çalışma alanına oturum açarak bağladığınız yapay zeka uygulamaları. Birini bağlantısını kesmek onu hemen durdurur.”
| Sütun | Gösterir |
|---|---|
| Uygulama | Uygulamanın adı ve sunucusu |
| Erişim | Okuma ya da Okuma ve değiştirme |
| Durum | Bağlı, Bağlantı kesildi veya Yapay zeka güvenlik duvarı tarafından duraklatıldı |
| Bağlı | Onayladığınız zaman |
| Son kullanım | Son çağrısı |
Bir uygulamayı bulmak için Uygulama veya sunucu ara… alanını kullanın. MCP ayarlarını yönet iznine sahip yöneticiler, her üyenin uygulamalarını görmek için Benim ile Herkes (yöneticiler) arasında geçiş yapabilir.
Bir uygulamanın bağlantısını kesin
- Bağlı uygulamalar sayfasını açın.
- Uygulamanın satırında Bağlantıyı kes seçeneğini seçin.
- Bu uygulamanın bağlantısını kes? onayını verin: “Uygulama adı bu çalışma alanına erişimini hemen kaybedecek. Tekrar kullanmak için yeniden bağlayın.”
Uygulamanın bir sonraki çağrısı 401 ile reddedilir. Üyeler kendi uygulamalarının bağlantısını kesebilir; yöneticiler herkesinkini kesebilir. Bağlantıyı kesmek oturum açmış bir kişi gerektirir: bir API anahtarı bunu yapamaz.
Bir bağlantı şu durumlarda da sona erer:
- 90 gün sonra (yeniden bağlayın),
- yenileme belirteci iki kez kullanıldığında; bu, kopyalanmış olduğu anlamına gelebilir (bağlantı iptal edilir ve olay yüksek önem derecesiyle denetlenir),
- bağlayan kişi artık etkin bir üye olmadığında.
HTTP üzerinden
| Yöntem | Yol | Kim | İşlevi |
|---|---|---|---|
| GET | /api/mcp/grants | MCP istemcilerini bağla iznine sahip oturum açmış herhangi bir üye | Bağlı uygulamalarınız: { data, total } |
| GET | /api/mcp/grants/all | MCP ayarlarını yönet | Herkesinkiler |
| DELETE | /api/mcp/grants/{grantId} | Uygulamanın sahibi ya da bir yönetici | Bağlantıyı kesme: { "revoked": true } |
Listeler page (0’dan başlar), pageSize (varsayılan 20, en fazla 100), search (uygulama adı veya sunucu), sort ve status (active, suspended, revoked) parametrelerini alır. Yollar https://<sunucunuz>/tenant/<tenantId> altındadır.
Hangi yolu seçmeli
| Durum | Kullanın |
|---|---|
| Kendi bilgisayarınızdaki bir asistan | Bir API anahtarı ya da asistan sunuyorsa oturum açma |
| Bağlayıcıları adresle ekleyen barındırılmış bir asistan | Oturum açma |
| Bir kişi olmadan çalışan zamanlanmış bir ajan ya da betik | Oluşturanından uzun süre yaşaması gerekiyorsa servis anahtarı olarak işaretlenmiş bir API anahtarı |
| Paylaşılan bir ekip asistanı | Asistan başına, yalnızca okuma izinli bir API anahtarı; asla bir kişinin oturum açma bilgisi değil |

