Aiten MCP Sunucusu

Aiten MCP sunucusu, sefer operasyonlarınızı Claude gibi yapay zeka istemcilerine araç olarak açar. Kendi Aiten hesabınızla doğal dille konuşarak seferleri sorabilir, izleyebilir ve (isteğe bağlı) sefer açabilirsiniz — panelde tek tık yapmadan.

Sunucu Aiten tarafında barındırılır. Kendi bilgisayarınızda hiçbir şey kurmaz, çalıştırmazsınız — istemcinize tek bir URL verirsiniz, tarayıcıdan bir kez yetki verirsiniz, işiniz biter. MCP (Model Context Protocol), yapay zeka istemcilerinin dış sistemlere standart bir arayüzle bağlanmasını sağlayan açık bir protokoldür; MCP destekleyen istemci, araçları otomatik keşfeder — tek tek tanımlamaya gerek kalmaz.

Kimlik doğrulama OAuth 2.1 iledir (MCP standardı): tarayıcıda Aiten hesabınızla giriş yapıp izin verirsiniz — hiçbir anahtar veya şifreyi istemciye yapıştırmazsınız. Verilen erişim belgesi (token) sunucu tarafında yalnızca sizin şirketinize kilitlenir (kiracı izolasyonu); başka bir şirketin verisine erişilemez.

Bağlanma

Sunucu adresi:

https://mcp.aiten.io/mcp

Uzak (remote) MCP sunucularını destekleyen bir istemcide “Bağlayıcı / Connector ekle” (veya “Uzak MCP sunucusu ekle”) bölümüne bu URL'yi girin. İlk bağlanışta istemci sizi tarayıcıda Aiten'in yetkilendirme ekranına yönlendirir:

Aiten panel hesabınızla giriş yapın (paneldeki e-posta + şifre).
“İzin ver” deyin — istemcinizin hangi şirket adına, hangi kapsamda (okuma/yazma) erişeceğini görürsünüz.
Tarayıcı istemciye geri döner; araçlar “aiten” başlığı altında hazırdır.

Token süresi dolduğunda istemci sessizce yeniler; tekrar giriş yapmanız çoğu zaman gerekmez.

Yalnızca yerel (stdio) istemciler için köprü

İstemciniz uzak MCP sunucusuna doğrudan bağlanamıyorsa (yalnızca yerel komut destekliyorsa), mcp-remote köprüsünü kullanın. OAuth akışını sizin yerinize tarayıcıda o yürütür. Claude Desktop için claude_desktop_config.json:

{
  "mcpServers": {
    "aiten": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.aiten.io/mcp"]
    }
  }
}

Öneri: MCP için panelde kişisel hesabınız yerine ayrı bir entegrasyon kullanıcısı açın. Yetkiyi istediğiniz an panelden geri çekebilirsiniz; bu hesap yalnızca kendi şirketinizin verisini görür.

Kimlik doğrulama nasıl çalışır?

Perde arkasında akış, MCP'nin yetkilendirme standardını (OAuth 2.1 + PKCE) izler:

İstemci, token'sız ilk istekte 401 ve keşif başlığı alır; buradan Aiten'in yetkilendirme sunucusunu (api.aiten.io) bulur.
Tarayıcıda giriş + izin sonrası istemci, yalnızca bu MCP kaynağına geçerli (aud'a bağlı) bir erişim belgesi alır.
Her araç çağrısında bu belge taşınır; sunucu belgeyi doğrular ve içinden şirketinizi çözer.
Sunucu, belgeyi arkadaki API'ye asla iletmez (confused-deputy yasağı) — kendi hizmet anahtarıyla, yalnızca sizin şirketinizin verisi kapsamında çağrı yapar.

Sonuç: istemciniz hiçbir zaman uzun ömürlü bir sır tutmaz; erişimi panelden geri çekmek yetkiyi anında keser.

Araçlar

Sunucu, sefer operasyonlarını iki grup araç olarak sunar.

Okuma araçları (her zaman etkin)

Araç	İşlev
`list_trips`	Seferleri filtreyle listeler (durum, arama, tarih).
`get_trip`	Tek seferin durak ve belge detayını getirir.
`list_stops`	Bir seferin duraklarını listeler.
`get_trip_events`	Seferin olay geçmişini (varış, teslim, gecikme) getirir.
`get_proof_of_delivery`	Tamamlanmış seferin teslimat kanıtını (POD) getirir.
`list_stop_documents`	Bir durağın irsaliye belgelerini listeler.

Yazma araçları

Araç	İşlev
`create_trip`	Yeni sefer açar.
`update_trip`	Sefer bilgilerini günceller.
`complete_trip`	Seferi tamamlar.
`cancel_trip`	Seferi iptal eder.
`update_location`	Sefer konumunu günceller.
`report_issue`	Sefere sorun kaydı ekler.

Güvenlik: Yazma araçları bilinçli olarak varsayılan kapalıdır ve sunucu tarafında Aiten ekibiyle birlikte açılır. create_trip başarılı olduğunda ilgili sürücüye gerçek bir WhatsApp bildirimi gider; bu nedenle istemciniz de her yazma çağrısında ayrıca onay sorar.

Örnek istemler

“IN_PROGRESS seferleri listele.”
“DL-260701-001 nerede, hangi durakta?”
“34 ABC 123 plakalı son seferin teslimat kanıtını getir.”
(yazma açıkken) “Gebze depodan Ankara bayiye 34 ABC 123 ile sefer aç, şoför 905551234567.”