Bir yapay zeka asistanı bağlayın

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) sayfasında 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ı “MCP is switched off for this workspace (Settings → MCP)” mesajıyla 403 yanıtı verir.
MCP istemcilerini bağla (mcp_server.connect) yetkisine sahip olmalısınız. Her yerleşik rolde bu yetki bulunur.
Kullanmak istediğ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 ve ardından /api/mcp/<server> biçimindedir:

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 aracının döndürdüğü cihaz kimliklerine ihtiyaç duyar.

Kullanabileceğiniz tüm sunucu ve araçları görmek için MCP istemcilerini bağla yetkisine sahip bir API anahtarıyla dizin çağrısı yapı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 veya kendi sunucunuzda çalışan ve HTTP üstbilgisi ayarlamanıza izin veren asistanlarla 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 istemcilerini bağla seçeneğini (MCP grubu) ve cihazlar modülü ile telemetrinin Yalnızca okuma ön ayarını işaretleyin.
Kısa bir son kullanma süresi belirleyin; 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 adlandırılır) bir sunucu ekleyin; yukarıdaki adresi ve şu üstbilgiyi girin:

Authorization: Bearer sk_live_…

İkinci sunucu için aynı anahtarla tekrarlayın.

Birçok asistan şuna benzer bir JSON yapılandırması kullanır (tam 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’de barındırılan ve adres ile “özel bağlayıcı” veya “uzak MCP sunucusu” eklemenize izin veren asistanlarla 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 Bu çalışma alanına bağlan to this workspace? ile “Kimliği şurada yayımlanmıştır ” ve “Sizin adınıza hareket eder, bu çalışma alanındaki erişiminizin hiçbir zaman üzerinde işlem yapamaz.” ifadelerini içerir. Yalnızca okuma bağlantısında ayrıca “Çalışma alanının yapay zeka araçları üzerinden okuyabildiğinizi okuyabilir. Hiçbir şeyi değiştiremez.” ifadesi yer alır.
Uygulama adını ve sunucuyu kontrol edin, ardından Bağlan seçeneğini seçin. İptal, asistanı erişim vermeden geri gönderir.
Telemetri sunucusu için tekrarlayın. Her sunucu kendi adresiyle ayrı ayrı eklenir.

Uygulama Bağlı uygulamalar bölümünde görünür. “Bağlı uygulamalar bölümünden istediğiniz zaman bağlantıyı kesebilirsiniz.”

Hermetry Bu uygulama bağlanamıyor mesajını gösterirse, uygulamanın sunucusu Hermetry’nin tanıdığı bir sunucu değildir. Hermetry, bilinen yapay zeka uygulamalarından oluşan yerleşik bir listeyi 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 401 ve WWW-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-server adresindedir (ayrıca openid-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; tam bir yönlendirme adresi (https veya masaüstü uygulamaları için yerel makinede http) ve bu çalışma alanının MCP tabanı ya da tek bir sunucusu olan bir resource gerekir.
Kapsamlar: mcp:read; mcp:write yalnı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 izin vermek için yeni bir oturum açma gerekir.”). IoT araçları yalnızca mcp:read gerektirir.
Erişim belirteçleri 10 dakika geçerlidir. Yenileme belirteçleri her kullanımda yenilenir; 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/revoke adresinden 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`	Yanlış veya süresi dolmuş anahtar ya da başka bir kuruluşa ait anahtar; veya uygulamanın bağlantısı kesilmiş
`403` “MCP is switched off for this workspace”	Bir yönetici MCP’yi açmalıdır
`404`	Sunucu adı yanlış veya modülü kuruluşunuz için açık değil
Hiçbir araç listelenmiyor	Anahtarın veya 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ı bir oturum reddedilir	MCP yalnızca `Authorization` üstbilgisindeki bir anahtarı veya belirteci kabul eder
Bir web sayfasından `403`	Başka bir siteye ait tarayıcı `Origin` değeri taşıyan çağrılar reddedilir
`415`	İstek `application/json` olarak gönderilmemiş

Teknik notlar

Taşıma: Streamable HTTP, yalnızca POST, JSON yanıtları, oturum yok (Mcp-Session-Id yok). GET ve DELETE 405 yanıtı verir.
Protokol sürümü 2025-11-25; daha yeni sürümlere de yanıt verilir.
İstek gövdeleri 64 KiB’a kadar; Content-Type: application/json.
Her sunucu, asistanınızın gösterebileceği teknik bir ad bildirir. hermetry- ile başlayan ve kuruluşunuz için değiştirilebilen açık adlar geliştirme aşamasındadır.