Skip to main content

MCP sunucusu

Azalt, uyumlu AI istemcilerinin kendi Azalt hesabınız üzerinden organizasyon verilerinizle güvenli şekilde çalışabilmesi için uzaktan erişilen bir Model Context Protocol (MCP) sunucusu sunar. Üretim MCP endpoint’i:
Sunucu Streamable HTTP ve OAuth kullanır. Azalt hesabınızla giriş yapar, istenen erişimi onaylarsınız ve istemci bir OAuth token alır. Erişim, mevcut Azalt organizasyonunuza ve kullanıcınızın yetkilerine göre uygulanır.

Neler yapabilirsiniz?

Bağlı AI istemcileri Azalt araçlarıyla şunları yapabilir:
  • Profilinizi, mevcut organizasyonunuzu, kullanıcıları, lokasyonları, formları, panoları, veri setlerini ve KPI göstergelerini okuyabilir.
  • Form elemanlarını, form yayılımlarını, form gönderimlerini ve tekil gönderim değerlerini inceleyebilir.
  • KPI verilerini ve kullanılabilir emisyon faktörlerini sorgulayabilir.
  • Onaylanan kapsamlar ve Azalt yetkileriniz izin veriyorsa form, pano ve pano bileşeni oluşturabilir.

Güvenlik

Yalnızca güvendiğiniz MCP istemcilerini bağlayın. Onayladığınız kapsamlara bağlı olarak istemci, organizasyon verilerini okuyabilir ve sizin adınıza Azalt kaynakları oluşturabilir veya güncelleyebilir. Bağlı MCP istemcilerini buradan inceleyebilir ve erişimlerini kaldırabilirsiniz:

Kapsamlar

Azalt MCP aşağıdaki OAuth kapsamlarını kullanır:

Codex

Codex, uzaktan MCP istemcisiyle Azalt MCP’ye bağlanabilir.
Ardından kimlik doğrulaması yapın:
Tarayıcıdaki giriş ve onay akışını tamamlayın. Kimlik doğrulamadan sonra sunucuyu kontrol edin:
Codex’te ilk kez uzaktan MCP sunucusu kullanıyorsanız, ~/.codex/config.toml dosyasında uzaktan MCP istemci özelliğinin açık olduğundan emin olun:

Claude Code

Claude Code, OAuth kullanan uzaktan HTTP MCP sunucularını destekler. Azalt’ı şu komutla ekleyin:
Claude Code içinde şu komutu çalıştırın:
Azalt sunucusunu seçin ve tarayıcıdaki kimlik doğrulama akışını tamamlayın. Tarayıcı otomatik açılmazsa Claude Code’un gösterdiği URL’yi kopyalayıp manuel olarak açın. Tarayıcı yerel callback URL’sine yönlenir ve sayfaya erişilemezse, tarayıcı adres çubuğundaki tam callback URL’sini kopyalayıp Claude Code sizden istediğinde geri yapıştırın.

Diğer istemciler

Uzaktan Streamable HTTP MCP sunucularını, OAuth’u ve dinamik istemci kaydını destekleyen diğer MCP istemcileri de çalışabilir. Kullanılacak endpoint:
Bir istemci yalnızca yerel veya stdio MCP sunucularını destekliyorsa, istemci izin veriyorsa mcp-remote gibi bir uzaktan MCP köprüsü kullanılabilir.

Sorun giderme

OAuth callback sayfasına erişilemiyor

MCP istemcisinin hâlâ callback beklediğinden emin olun. İstemci, erişimi onaylamadan önce zaman aşımına uğradıysa giriş akışını tekrar başlatın ve yeni onay isteğini kullanın.

İstemci bağlı ama bir araç reddediliyor

OAuth token gerekli kapsamı içermiyor olabilir veya Azalt kullanıcınızın mevcut organizasyonda ilgili işlem için yetkisi olmayabilir. Gerekli kapsamlarla yeniden bağlanın veya organizasyon sahibinden Azalt rolünüzü güncellemesini isteyin.

Azalt’ta organizasyon değiştirdim

MCP istekleri, Azalt kullanıcınızın mevcut organizasyonunu kullanır. Organizasyon değiştirdiyseniz yeniden bağlanın veya değişiklik yapmadan önce istemciden get_my_profile aracını çağırarak aktif organizasyonu doğrulamasını isteyin.