Yeni: Yapay zekâ güvenlik duvarı tüm platformu izliyor ve her olayı sade bir dille açıklıyor. Nasıl çalıştığını görün

Bir yapay zeka asistanı bağlayın

MCP sunucu adreslerinizi bulun, bir yapay zeka asistanını API anahtarı ya da oturum açma ile bağlayın ve çalıştığını kontrol edin.

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:

SunucuAdres
Cihazlarhttps://<your host>/tenant/<tenantId>/api/mcp/iot_device
Telemetrihttps://<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.

  1. API Anahtarları > Yeni API Anahtarı seçeneğini açın.
  2. Anahtarı asistanın ve kişinin adına göre adlandırın, örneğin “Masaüstü asistan – Alex”.
  3. 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.
  4. Kısa bir son kullanma süresi belirleyin ve asistan her zaman tek bir ağdan çalışıyorsa bir IP izin listesi ekleyin.
  5. Anahtarı oluşturun ve kopyalayın.
  6. 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_…
  1. İ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.

  1. 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.
  2. Asistan bir Hermetry sayfası açar. İstenirse oturum açın.
  3. 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.
  4. 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.
  5. 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 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; yönlendirme adresi tam olarak eşleşmelidir (https ya da masaüstü uygulamaları için yerel makinede http) ve resource bu çalışma alanının MCP tabanı ya da tek bir sunucu olmalıdır.
  • 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 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 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/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.

BelirtiNeden
401Anahtar 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
404Sunucu adı yanlış ya da modülü kuruluşunuz için açık değil
Hiçbir araç listelenmiyorAnahtarın ya da sizin araçların yetkilerine sahip olmaması ya da araçların kapalı olması
405Asistan GET kullandı; POST kullanmalıdır (Streamable HTTP, JSON yanıtları)
Çerez tabanlı oturum reddediliyorMCP yalnızca Authorization üstbilgisindeki bir anahtarı ya da belirteci kabul eder
Bir web sayfasından 403Baş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-Id yok). GET ve DELETE 405 yanı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.