Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.azalt.co/llms.txt

Use this file to discover all available pages before exploring further.

​
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: 
https://app.azalt.co/api/mcp
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: 
https://app.azalt.co/settings/mcp-clients

​
Kapsamlar

Azalt MCP aşağıdaki OAuth kapsamlarını kullanır:
KapsamErişim
openidAzalt kimliğinizi doğrular
profileProfil bilgilerinizi okur
emailE-posta adresinizi okur
azalt:readErişebildiğiniz Azalt organizasyon verilerini okur
azalt:write:formsFormlarla ilgili veri oluşturur ve günceller
azalt:write:importsİçe aktarımları önizler ve uygular
azalt:write:activitiesAktiviteleri oluşturur, günceller ve yeniden hesaplar
azalt:adminYönetimsel Azalt kaynaklarını yönetir

​
Codex

Codex, uzaktan MCP istemcisiyle Azalt MCP’ye bağlanabilir. 
codex mcp add azalt --url https://app.azalt.co/api/mcp
Ardından kimlik doğrulaması yapın: 
codex mcp login azalt --scopes openid,profile,email,azalt:read,azalt:write:forms,azalt:write:imports,azalt:write:activities,azalt:admin
Tarayıcıdaki giriş ve onay akışını tamamlayın. Kimlik doğrulamadan sonra sunucuyu kontrol edin: 
codex mcp list
codex mcp get azalt
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: 
[features]
experimental_use_rmcp_client = true

​
Claude Code

Claude Code, OAuth kullanan uzaktan HTTP MCP sunucularını destekler. Azalt’ı şu komutla ekleyin: 
claude mcp add --transport http azalt https://app.azalt.co/api/mcp
Claude Code içinde şu komutu çalıştırın: 
/mcp
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: 
https://app.azalt.co/api/mcp
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.