Bu sayfa, MCP destekleyen bir yapay zeka asistanını Hermetry kuruluşunuza bağlar. Asistanın bundan sonra neler yapabileceği Yapay zeka asistanları (MCP) bölümünde açıklanmıştır.
Başlamadan önce
- Bir yönetici Ayarlar > MCP > MCP istemcilerinin bağlanmasına izin ver seçeneğini açmış olmalıdır. Bu kapalıyken her MCP çağrısı
403“MCP bu çalışma alanı için kapalıdır (Ayarlar → MCP)” yanıtını verir. - MCP istemcilerini bağla (
mcp_server.connect) yetkisine sahip olmalısınız. Her yerleşik rolde bu yetki vardır. - İstediğiniz araçların yetkilerine sahip olmalısınız: cihaz araçları için Cihazları görüntüle, telemetri araçları için ise telemetri okuma yetkisi.
Sunucu adresleriniz
Her modülün kendi MCP sunucusu vardır. Adresi, çalışma alanınızın adresi ardından /api/mcp/<server> eklenerek oluşturulur:
| Sunucu | Adres |
|---|---|
| Cihazlar | https://<your host>/tenant/<tenantId>/api/mcp/iot_device |
| Telemetri | https://<your host>/tenant/<tenantId>/api/mcp/telemetry |
Kuruluşunuzun kendi web adresi varsa (örneğin https://acme.<your host>), adres https://acme.<your host>/api/mcp/iot_device olur. Tarayıcınızda gördüğünüz adresle eşleşen biçimi kullanın.
Her iki sunucuyu da asistanınıza ekleyin: telemetri araçları, list_devices tarafından döndürülen cihaz kimliklerine ihtiyaç duyar.
Kullanabileceğiniz tüm sunucu ve araçları görmek için MCP istemcilerini bağla yetkisi olan bir API anahtarıyla dizini çağırın:
curl -s "https://<your host>/tenant/<tenantId>/api/mcp" -H "Authorization: Bearer sk_live_…"
{
"enabled": true,
"servers": [
{ "server": "iot_device", "path": "/api/mcp/iot_device", "tools": [
{ "name": "get_device", "title": "Get a device", "kind": "read" },
{ "name": "list_devices", "title": "List devices", "kind": "read" } ] },
{ "server": "telemetry", "path": "/api/mcp/telemetry", "tools": [
{ "name": "get_latest_readings", "title": "Get latest readings", "kind": "read" },
{ "name": "get_reading_series", "title": "Get a reading series", "kind": "read" } ] }
]
}
Seçenek 1: API anahtarıyla bağlanın
Bunu bilgisayarınızda ya da kendi sunucunuzda çalışan ve HTTP üstbilgisi ayarlamanıza izin veren asistanlar için kullanın.
- API Anahtarları > Yeni API Anahtarı seçeneğini açın.
- Anahtarı asistanın ve kişinin adına göre adlandırın, örneğin “Masaüstü asistan – Alex”.
- Modül yetkileri altında MCP grubundaki MCP istemcilerini bağla seçeneğini işaretleyin; ayrıca cihaz modülü ve telemetri için Yalnızca okuma hazır ayarını seçin.
- Kısa bir son kullanma süresi belirleyin ve asistan her zaman tek bir ağdan çalışıyorsa bir IP izin listesi ekleyin.
- Anahtarı oluşturun ve kopyalayın.
- Asistanın MCP ayarlarında, HTTP türünde (bazen “Streamable HTTP” olarak anılır) bir sunucu ekleyin; yukarıdaki adresi ve şu üstbilgiyi girin:
Authorization: Bearer sk_live_…
- İkinci sunucu için aynı anahtarla işlemi tekrarlayın.
Birçok asistan şuna benzer bir JSON yapılandırması kabul eder (kesin dosya ve alan adları asistana göre değişir):
{
"mcpServers": {
"hermetry-devices": {
"type": "http",
"url": "https://<your host>/tenant/<tenantId>/api/mcp/iot_device",
"headers": { "Authorization": "Bearer sk_live_…" }
},
"hermetry-telemetry": {
"type": "http",
"url": "https://<your host>/tenant/<tenantId>/api/mcp/telemetry",
"headers": { "Authorization": "Bearer sk_live_…" }
}
}
}
Soldaki adlar kendi etiketlerinizdir. Anahtar sizin adınıza hareket eder ve yalnızca işaretlediğiniz yetkilerle sınırlıdır. Bkz. MCP anahtarları ve bağlı uygulamalar.
Seçenek 2: oturum açarak (OAuth) bağlanın
Web üzerinde barındırılan ve adresle “özel bağlayıcı” veya “uzak MCP sunucusu” eklemenize izin veren asistanlar için kullanın.
- Asistanda, sunucu adresiyle bir bağlayıcı ekleyin, örneğin
https://<your host>/tenant/<tenantId>/api/mcp/iot_device. İstemci kimliği ve gizli anahtar alanlarını boş bırakın. - Asistan bir Hermetry sayfası açar. İstenirse oturum açın.
- Hermetry, Connect app name to this workspace? ifadesini, “Kimliği app host adresinde yayımlanır.” ve “Sizin adınıza hareket eder; bu çalışma alanındaki erişiminizden fazlasını hiçbir zaman kullanmaz.” metinleriyle gösterir. Yalnızca okuma bağlantısında ayrıca “Bu çalışma alanındaki yapay zeka araçları üzerinden okuyabildiklerinizi okuyabilir. Hiçbir şeyi değiştiremez.” ifadesi eklenir.
- Uygulama adını ve sunucusunu kontrol edin, ardından Connect seçeneğini seçin. Cancel seçeneği asistanı erişim verilmeden geri gönderir.
- Telemetri sunucusu için işlemi tekrarlayın. Her sunucu kendi adresiyle ayrı ayrı eklenir.
Uygulama Bağlı uygulamalar bölümünde görünür. “Bağlantıyı istediğiniz zaman Bağlı uygulamalar bölümünden kesebilirsiniz.”
Hermetry Bu uygulama bağlanamıyor mesajını gösterirse, uygulamanın sunucusu Hermetry’nin tanıdığı bir sunucu değildir. Hermetry, yerleşik bir bilinen yapay zeka uygulamaları listesini kabul eder; bir yönetici Ayarlar > MCP > Diğer yapay zeka uygulamaları altından başka sunucular ekleyebilir. Bkz. MCP ayarları ve güvenlik.
Oturum açma sırasında neler olur
Asistan tarafını yönetenler için:
- Sunucu, kimlik doğrulaması yapılmamış bir çağrıya
401veWWW-Authenticate: Bearer resource_metadata="<base>/api/mcp/oauth/protected-resource/<server>"ile yanıt verir. - Yetkilendirme sunucusu meta verileri
<base>/api/mcp/oauth/.well-known/oauth-authorization-serveradresindedir (ayrıcaopenid-configuration). - İstemciler, bir istemci meta veri belgesinin https adresi olan bir istemci kimliğiyle kendilerini tanıtır; dinamik istemci kaydı yoktur.
- Yalnızca PKCE (
S256) ile yetkilendirme kodu akışı kabul edilir; yönlendirme adresi tam olarak eşleşmelidir (https ya da masaüstü uygulamaları için yerel makinede http) veresourcebu çalışma alanının MCP tabanı ya da tek bir sunucu olmalıdır. - Kapsamlar:
mcp:read;mcp:writeyalnızca yeni bir oturum açmadan sonraki 15 dakika içinde verilir (“Oturumu kapatıp yeniden açın, ardından uygulamayı bağlayın: kayıtların değiştirilmesine yeni bir oturum açma gerekir.”). IoT araçları yalnızcamcp:readgerektirir. - Erişim belirteçleri 10 dakika geçerlidir. Yenileme belirteçleri her kullanımda değiştirilir; eski bir belirtecin yeniden kullanılması bağlantıyı iptal eder. Bir bağlantı en fazla 90 gün sürer.
- Belirteçler
<base>/api/mcp/oauth/revokeadresinden iptal edilebilir.
Çalıştığını kontrol edin
Asistana “Cihazlarımı listele” diye sorun. list_devices aracını çağırmalı ve kuruluşunuzdaki adlarla yanıt vermelidir.
| Belirti | Neden |
|---|---|
401 | Anahtar hatalı ya da süresi dolmuş, ya da başka bir kuruluşa ait; ya da uygulamanın bağlantısı kesilmiş |
403 “MCP bu çalışma alanı için kapalıdır” | Bir yönetici MCP’yi açmalıdır |
404 | Sunucu adı yanlış ya da modülü kuruluşunuz için açık değil |
| Hiçbir araç listelenmiyor | Anahtarın ya da sizin araçların yetkilerine sahip olmaması ya da araçların kapalı olması |
405 | Asistan GET kullandı; POST kullanmalıdır (Streamable HTTP, JSON yanıtları) |
| Çerez tabanlı oturum reddediliyor | MCP yalnızca Authorization üstbilgisindeki bir anahtarı ya da belirteci kabul eder |
Bir web sayfasından 403 | Başka bir siteye ait bir tarayıcı Origin değeri taşıyan çağrılar reddedilir |
415 | İstek application/json olarak gönderilmedi |
Teknik notlar
- Aktarım: Streamable HTTP, yalnızca
POST, JSON yanıtları, oturum yok (Mcp-Session-Idyok).GETveDELETE405yanıtı verir. - Protokol revizyonu
2025-11-25; daha yeni revizyonlar da yanıtlanır. - İstek gövdeleri 64 KiB’a kadar;
Content-Type: application/json. - Her sunucu, asistanınızın gösterebileceği teknik bir ad bildirir.

