MCP sunucusu

Bu kılavuzu tamamladığınızda Model Context Protocol (MCP) destekleyen bir yapay zekâ asistanı merkez sunucunuza bağlanır. Claude, Cursor ve VS Code bu tür istemcilere örnektir. Asistan; cihazlar, işlem akışları, alarm kuralları ve alarmlarla ilgili soruları canlı sistemden aldığı bilgiyle yanıtlar. Bunu yaparken oturum açtığı Proxus kullanıcısının haklarıyla sınırlı kalır.

Başlamadan önce

Şunlar gereklidir:

• Merkez sunucunun adresi. MCP sunucusu, merkez sunucuyla aynı portta /mcp yolunda çalışır, örneğin http://localhost:8080/mcp.
• Asistana ayrılmış bir Proxus kullanıcısı. Asistanın neyi okuyup neyi değiştirebileceğini bu kullanıcının rolü belirler. Ayrıntılar için Kullanıcılar ve roller sayfasına bakın.
• Streamable HTTP aktarımını destekleyen bir MCP istemcisi.
• Merkez sunucunun yapılandırmasında [MCP] Enabled = true ayarı. Bu ayar varsayılan olarak açıktır.

Adım 1: Sunucuyu istemcinize ekleyin

claude mcp add --transport http proxus http://localhost:8080/mcp

{
  "servers": {
    "proxus": { "type": "http", "url": "http://localhost:8080/mcp" }
  }
}

{
  "mcpServers": {
    "proxus": { "url": "http://localhost:8080/mcp" }
  }
}

İstemcide başlık veya anahtar tanımlamanız gerekmez. Oturum açma işlemi bir sonraki adımda, sohbetin içinde yapılır.

Adım 2: Oturum açın

Oturum açılmadan önce asistan yalnızca araç listesini görebilir ve schema_overview aracını çağırabilir. Bu araç sunucuyu ve oturum açma adımını anlatır. Asistandan oturum açmasını isteyin. Asistan sorduğunda Proxus kullanıcı adını ve parolasını verin. Asistan bu bilgilerle auth_login aracını çağırır.

Oturum yalnızca bu MCP bağlantısı için geçerlidir ve SessionTtlMinutes süresi boyunca açık kalır. Varsayılan süre 25 dakikadır. Süre dolduğunda ya da auth_logout çağrıldığında asistan bilgileri yeniden ister. Bağlantının hangi kullanıcıyla açıldığını auth_whoami aracıyla görebilirsiniz.

Asistanın yapabilecekleri

Sunucu bunlara ek olarak üç hazır istem (prompt) sunar: proxus_read_entity, proxus_write_change ve proxus_analyze_telemetry. proxus://schema/ altında da kaynaklar bulunur (overview, entities, telemetry, templates, protocols).

Her çağrı, oturum açmış kullanıcının izinleriyle çalışır. Rolün izin vermediği bir değişiklik, merkez sunucu ekranlarında olduğu gibi reddedilir. Silme işlemleri, silme izni olan kullanıcılar için bile varsayılan olarak engellenir (BlockDelete = true).

Üretim ortamı için güvenliği sıkılaştırın

Aşağıdaki ayarları merkez sunucunun yapılandırmasında [MCP] bölümüne yazın. Ortam değişkeni olarak vermek için MCP__<Key> biçimini kullanın.

telemetry_query aracının sınırları [MCP.ClickHouse] bölümünde tanımlanır: MaxResultRows (1.000), MaxRowsToRead (10.000.000), MaxBytesToRead ve MaxMemoryUsage (512 MiB), MaxExecutionTimeSeconds (10), MaxThreads (4) ve MaxResultBytes (16 MiB). Username ve Password alanlarına, yalnızca DeviceRawData ve Logs tablolarını okuyabilen bir veritabanı kullanıcısının bilgilerini girin.

Birden çok merkez sunucu örneği bir yük dengeleyicinin arkasında çalışıyorsa oturumlar Redis üzerinden paylaşılır. Bunun için Cluster:RedisConnection (veya MCP:RedisConnection) ayarının tanımlı olması gerekir.

Reddedilen çağrılar istemciye hata olarak döner. Adrese izin verilmiyorsa 403 döner. Yönetici rolü olmayan bir kullanıcı yönetici aracını çağırırsa authorization_denied hatası alır. Oturum açmadan korumalı bir araç çağrılırsa 401, çağrı sınırı aşılırsa 429 döner.

Sonraki adımlar

• REST API: aynı veriye kendi programlarınızdan erişin.
• İlişki haritası: ilişki haritası araçlarının okuduğu yapıyı tanıyın.
• Güvenliği sıkılaştırma: merkez sunucu ve Edge Gateway'ler için güvenlik ayarlarını gözden geçirin.