MCP Server - AI Agent Entegrasyonu ve Yönetimi
1-) MCP Server Kurulumu ve Yapılandırması
Bu bölüm, Supsis hesabınızdaki verileri Cursor, Claude Desktop ve ChatGPT gibi Model Context Protocol (MCP) destekleyen yapay zekâ asistanlarına (AI agent) güvenli ve yetki kapsamı sınırlandırılabilir bir şekilde bağlamanızı sağlayan MCP Server yönetim sürecini içerir. Bu sayede farklı AI araçları için ayrı entegrasyonlar geliştirmenize gerek kalmadan verilerinize kontrollü erişim sağlayabilirsiniz.
1.a – MCP Server Sayfasına Erişim ve Başlangıç
MCP Server yönetimine ulaşmak için paneli iki farklı yoldan kullanabilirsiniz: 1. Ayarlar > Entegrasyonlar > Utilities > MCP Server
- Tablolar > MCP Server
(Not: Ayarlar menüsündeki bölüm root/admin kullanıcıları içindir. Tablolar altındaki sayfada ise kullanıcılar kendi oluşturdukları kayıtları yönetebilir).
a – MCP Server Keşif Kartı
Entegrasyonlar sayfasındaki Utilities grubunda yer alan, resmi MCP logosunu taşıyan ve ayarlar sayfasına yönlendiren karttır.
b – MCP Server Oluştur Düğmesi
İlgili listeleme ekranına girildiğinde sağ üstte bulunan ve yeni bir bağlantı kurulumu başlatmak için kullanılan butondur.
1.b – Kapsam (Scope) ve Süre Belirleme
Oluşturma işleminin ilk adımında, AI agent'ın hangi verilere ne kadar süreyle erişebileceğini belirlersiniz.
c – Etiket ve Kapsam Seçimi
Bağlantıya hatırlatıcı bir etiket girdiğiniz ve AI agent'ın erişebileceği Supsis ürün kapsamlarını (varsa özel müşteri modülleri dahil) seçtiğiniz alandır. Boş bırakılan kapsamlar varsayılan erişim ayarlarına tabi olur.
d – Geçerlilik Süresi
Erişimin ne kadar süreyle aktif kalacağını gün, hafta, ay veya yıl bazında seçtiğiniz kısımdır. Bu süre API güvenliği gereği minimum 1 gün, maksimum 365 gün olarak belirlenebilir.
1.c – Bağlantı Yapılandırması ve Güvenlik Değeri
Kapsam ve süre belirlenip işlem onaylandığında, AI asistanınızın Supsis'e bağlanması için gereken kodlar oluşturulur.
e – Erişim Değeri (Token / Secret)
Sistemin ürettiği ve güvenliğiniz için yalnızca bir kez gösterilen özel şifredir. Bu değer oluşturma ekranı kapandıktan sonra tekrar görüntülenemeyeceği için güvenli bir yere kopyalanmalıdır.
f – Hazır İstemci (Client) Yapılandırmaları
Cursor için hazır mcp.json yapısı veya Claude Desktop / genel HTTP istemcileri için mcp-remote uç nokta (Endpoint) ve Authorization header bilgilerinin bulunduğu, tek tıkla kopyalanabilen kod bloklarıdır. İlgili kod Cursor dizinine eklenerek bağlantı anında sağlanır.
1.d – MCP Server Listesi ve Yönetimi
Oluşturulan tüm aktif ve pasif bağlantılar MCP Server sayfasından takip edilebilir.
g – Bağlantı Listesi ve Bitiş Süreleri
Hangi bağlantının ne kadar kullanım süresi kaldığını ve hangi kapsamları içerdiğini listeleyen alandır.
h – Silme ve İptal İşlemi
Güvenlik sebebiyle erişimi erken sonlandırmak isterseniz ilgili satırdan silme işlemi yapabilirsiniz. Silme işlemi bir onay penceresi gerektirir ve onaylandığında AI agent'ın erişimi derhal iptal edilir.
1.e – Örnek Kullanım Senaryoları
MCP Server modülü, verileriniz üzerinde AI asistanlarına özel ve güvenli yetkiler tanımlayarak iş süreçlerinizi otomatikleştirmenizi sağlar:
Geliştirici Asistanı Entegrasyonu: Cursor agent'ına yetki vererek Supsis sohbetleri, kişiler veya aktiviteler üzerinden doğrudan kod tabanlı sorgular ve işlemler gerçekleştirebilirsiniz. Özel Kapsamlı AI Analizi: Yalnızca belirli bir "Müşteri Modülüne" (örneğin sadece finans veya destek kayıtlarına) okuma/yazma erişimi olan kısıtlı bir AI asistanı yapılandırabilirsiniz. Geçici Destek ve Otomasyon: Kısa süreli bir veri analizi, dış destek ekibi çalışması veya tek seferlik bir otomasyon senaryosu için "1 haftalık" zaman sınırlı ve süresi dolunca kendi kendini imha eden bir MCP Server erişimi verebilirsiniz.