Bir yapay zeka asistanı, kuruluşunuzun MCP sunucularına iki yoldan biriyle erişir: bir API anahtarıyla ya da oturum açmanızla bağladığınız bir uygulama olarak. Bu sayfa her birinin nasıl güvenle 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ı, API Keys bölümünde diğer her anahtar gibi oluşturulan ve Connect MCP clients (mcp_server.connect) iznini taşıyan sıradan bir API anahtarıdır. Bkz. Authentication.
Neyi işaretlemeli
| İzin | Gereken yer |
|---|---|
| Connect MCP clients (grup MCP) | Herhangi bir MCP sunucusuna erişim |
View devices (iot_device.devices.read) | list_devices, get_device |
Telemetri okuma (telemetry.read) | get_latest_readings, get_reading_series |
Modüllerin Read only ön ayarlarını kullanın; başka bir şey gerekmez. Connect MCP clients iznine sahip ama bir aracın iznine sahip olmayan bir anahtar o aracı görmez. Connect MCP clients izni olmayan bir anahtar, başka ne taşırsa taşısın 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 geçerlilik süresi. 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ı, o izinlerle REST API üzerinde de çalışır.
- Anahtarı paylaşılan dosyalardan uzak tutun. Asistan yapılandırma dosyaları sıklıkla senkronize edilir veya commit edilir; izin veriliyorsa 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 Last used, Last used IP ve Total verifications görünür.
- Her araç çağrısı denetim günlüğünde
mcp_server.tool.called(ya damcp_server.tool.refused) olarak yer alır; işlemi yapan olarak anahtar, araç, sonuç ve süre ile birlikte. - Anahtarın sayfasındaki Deactivate, Revoke ya da Rotate key işlemleri erişimi hemen sonlandırır ya da değiştirir. Bkz. Authentication.
- AI güvenlik duvarı, hatalı davranan anahtarlarla ilgili olayları kaydeder. Eylemleri (bir anahtarı kısıtlama ya da kapatma) geliştirme aşamasındadır.
Bağlı uygulamalar
Oturum açmanızla bağladığınız bir uygulama Connected apps sayfasında listelenir (menünün Developer bölümünde): “Bu çalışma alanına oturum açmanızla bağladığınız yapay zeka uygulamaları. Birini bağlantısını kesmek onu hemen durdurur.”
| Sütun | Gösterir |
|---|---|
| App | Uygulamanın adı ve sunucusu |
| Access | Read ya da Read and change |
| Status | Connected, Disconnected ya da Paused by the AI firewall |
| Connected | Onayladığınız zaman |
| Last used | Son çağrısı |
Birini bulmak için Search app or host… alanını kullanın. Manage MCP settings iznine sahip yöneticiler, her üyenin uygulamalarını görmek için Mine ve Everyone (admins) arasında geçiş yapabilir.
Bir uygulamanın bağlantısını kesme
- Connected apps bölümünü açın.
- Uygulamanın satırındaki Disconnect seçeneğini seçin.
- Disconnect this app? onayını verin: “
bu çalışma alanına erişimi hemen kaybedecek. Yeniden 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ı kesme 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ış olabileceği anlamına gelir (bağlantı iptal edilir ve olay yüksek önemde denetlenir),
- bağlantıyı kuran kişi artık aktif bir üye olmadığında.
AI güvenlik duvarı tarafından duraklatıldı
Geliştirme aşamasında: Bağlı bir uygulamayı duraklatmak da dahil olmak üzere AI güvenlik duvarının eylemleri geliştirme aşamasındadır. Bugün güvenlik duvarı yalnızca olayları kaydeder; bkz. AI firewall.
Bu eylem yayınlandığında, duraklatılmış bir uygulama her çağrıda en fazla 7 gün boyunca reddedilir ve durumu Paused by the AI firewall olarak görünür. Bu durumu görür ve beklemiyorsanız, uygulamayı yeniden bağlamadan önce bağlantısını kesin ve denetim günlüğünü kontrol edin.
HTTP üzerinden
| Yöntem | Yol | Kim | Yapar |
|---|---|---|---|
| GET | /api/mcp/grants | Connect MCP clients iznine sahip, oturum açmış herhangi bir üye | Bağlı uygulamalarınız: { data, total } |
| GET | /api/mcp/grants/all | Manage MCP settings | 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ı ya da sunucu), sort ve status (active, suspended, revoked) parametrelerini alır. Yollar https://<your host>/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çması değil |