Geliştirici kurulumu

Saga, bir MCP sunucusu olarak kullanılabilir; böylece yapay zeka aracıları ve asistanları — Claude, ChatGPT, Cursor ve özel aracılar — Saga çalışma alanınızı bir araç olarak kullanabilir. Aracı, Saga’ya sorular sorabilir, proje belgelerini arayıp okuyabilir ve iş akışlarınızı çalıştırabilir; bunların tümünü kendi erişiminizle yapar. Bu, harici MCP sunucularını Saga’ya bağlamanın tersidir. Burada Saga çalışma alanınız, diğer araçların bağlandığı sunucunun kendisidir.

Başlamadan önce

Şunlara ihtiyacınız var:

Platform URL’niz ve bir API anahtarı. Her ikisi de Saga içindeki Ayarlar > API Anahtarı Yönetimi bölümünden gelir. Sayfayı açın, yoksa bir anahtar oluşturun ve her iki değeri de kopyalayın.
Streamable HTTP taşımasını destekleyen bir MCP istemcisi (Claude Desktop, Claude Code, Cursor veya MCP SDK üzerine kurulu herhangi bir özel aracı).

Her müşterinin kendi Saga alan adı vardır, bu nedenle MCP uç noktanız, sonuna /api/mcp eklenmiş kendi platform URL’nizdir. Ayarlar > API Anahtarı Yönetimi bölümünde gösterilen platform URL’sini kullanın — alan adını tahmin etmeyin.

Bir istemci bağlama

Çoğu istemci yalnızca uç nokta URL’sine ve bir Authorization başlığına ihtiyaç duyar.

Uç nokta: https://<your-domain>.sagalegal.io/api/mcp
Başlık: Authorization: Api-Key <your-api-key>

.mcp.json dosyası okuyan bir istemci için (örneğin Claude Code) şunu ekleyin:

{
  "mcpServers": {
    "saga": {
      "type": "http",
      "url": "https://<your-domain>.sagalegal.io/api/mcp",
      "headers": { "Authorization": "Api-Key <your-api-key>" }
    }
  }
}

<your-domain> yerine platform URL’nizi ve <your-api-key> yerine Ayarlar > API Anahtarı Yönetimi bölümündeki anahtarı yazın.

Bazı istemciler yalnızca bir bearer token yapıştırmanıza izin verir. Bu durumda bunun yerine Authorization: Bearer <your-api-key> kullanın — Saga, API anahtarınızı her iki biçimde de kabul eder.

Aracı neler yapabilir

Bağlandıktan sonra aracı şu araçlara sahip olur:

Araç	Ne yapar
`ask_saga`	Saga’ya bir soru sorar ve uygulamada sohbet etmekle aynı şekilde yanıtı döndürür.
`list_projects`	Sizinle paylaşılanlar dahil projelerinizi listeler.
`list_project_documents`	Bir projedeki belgeleri listeler.
`search_project_documents`	Bir projenin bilgi tabanını arar ve en alakalı bölümleri döndürür.
`fetch_project_document`	Bir belgenin tam metnini döndürür.
`list_workflows`	İş akışlarınızı ve her birinin beklediği girdileri listeler.
`execute_workflow`	Bir iş akışını metin girdileriyle çalıştırır ve sonucu döndürür.

Her araç sizin adınıza çalışır. Aracı yalnızca hesabınızın halihazırda erişebildiği projeleri, belgeleri ve iş akışlarını görür — web uygulamasında sahip olduğunuz izinlerin aynısı.

Güvenlik

API anahtarınıza bir parola gibi davranın. Anahtara ve platform URL’nize sahip olan herkes, Saga aracılığıyla sizin gibi hareket edebilir.
Anahtarı istediğiniz zaman Ayarlar > API Anahtarı Yönetimi bölümünden değiştirin veya iptal edin. İptal etmek, bağlı tüm aracıları anında durdurur.
Bir anahtar sızmış olabilirse, onu iptal edin ve yeni bir tane oluşturun, ardından istemci yapılandırmanızı güncelleyin.

Sorun giderme

İstemci bağlanamıyor veya 401 Unauthorized döndürüyor — uç noktanın /api/mcp ile bittiğini, başlığın Authorization: Api-Key <your-api-key> olduğunu ve anahtarın süresinin dolmadığını veya iptal edilmediğini kontrol edin. Gerekirse Ayarlar > API Anahtarı Yönetimi bölümünde yeni bir anahtar oluşturun.
Bir iş akışı duraklatıldı olarak bildiriliyor — ortada girdi bekleyen iş akışları MCP üzerinden devam ettirilemez ve dosya girdileri desteklenmez. Bunları bunun yerine Saga uygulamasından çalıştırın.

​Başlamadan önce

​Bir istemci bağlama

​Aracı neler yapabilir

​Güvenlik

​Sorun giderme

Başlamadan önce

Bir istemci bağlama

Aracı neler yapabilir

Güvenlik

Sorun giderme