> ## 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

> AI istemcilerini Model Context Protocol ile Azalt'a bağlayın

# 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:

```text theme={null}
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:

```text theme={null}
https://app.azalt.co/settings/mcp-clients
```

## Kapsamlar

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

| Kapsam                   | Erişim                                                |
| ------------------------ | ----------------------------------------------------- |
| `openid`                 | Azalt kimliğinizi doğrular                            |
| `profile`                | Profil bilgilerinizi okur                             |
| `email`                  | E-posta adresinizi okur                               |
| `azalt:read`             | Erişebildiğiniz Azalt organizasyon verilerini okur    |
| `azalt:write:forms`      | Formlarla ilgili veri oluşturur ve günceller          |
| `azalt:write:imports`    | İçe aktarımları önizler ve uygular                    |
| `azalt:write:activities` | Aktiviteleri oluşturur, günceller ve yeniden hesaplar |
| `azalt:admin`            | Yönetimsel Azalt kaynaklarını yönetir                 |

## Codex

Codex, uzaktan MCP istemcisiyle Azalt MCP'ye bağlanabilir.

```bash theme={null}
codex mcp add azalt --url https://app.azalt.co/api/mcp
```

Ardından kimlik doğrulaması yapın:

```bash theme={null}
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:

```bash theme={null}
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:

```toml theme={null}
[features]
experimental_use_rmcp_client = true
```

## Claude Code

Claude Code, OAuth kullanan uzaktan HTTP MCP sunucularını destekler. Azalt'ı
şu komutla ekleyin:

```bash theme={null}
claude mcp add --transport http azalt https://app.azalt.co/api/mcp
```

Claude Code içinde şu komutu çalıştırın:

```text theme={null}
/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:

```text theme={null}
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.