MCP Entegrasyonu

SetGet, Model Context Protocol'ü iki yönlü olarak destekler:

1. Giden (Outbound) — Çalışma alanı ayarlarından harici MCP sunucularını (Slack, GitHub, Jira, özel HTTP uç noktaları) kaydedin. SetGet'in sohbet AI'ı bu sunucuların araçlarını keşfeder ve bir eylem planının parçası olarak çağırabilir.
2. Gelen (Inbound) — Çalışma alanı kapsamlı taşıyıcı token'lar oluşturun ve harici LLM istemcilerini (Claude Desktop, ChatGPT, özel agent'lar) SetGet'in kendi eylem yüzeyine bağlayın. Bu istemciler; iş ögeleri, döngüler, modüller, sayfalar, yorumlar, dokümanlar ve kadrolama alanlarını kapsayan derlenmiş 26 araçlık bir kataloğa erişir.

Nerede bulunur

• Giden MCP sunucuları: Çalışma alanı ayarları → Geliştirici → MCP Sunucuları
• Gelen taşıyıcı token'lar: Çalışma alanı ayarları → Geliştirici → MCP Token'ları

Her iki sayfa da yalnızca yöneticilere açıktır.

Giden — harici bir MCP sunucusu bağlama

1. Sunucu ekleme

Çalışma alanı ayarları → Geliştirici → MCP Sunucuları bölümünü açın ve Sunucu ekle'ye tıklayın. Aşağıdaki alanları doldurun:

Alan	Notlar
Ad	Sohbet AI'ının araç kataloğunda görünen kısa etiket (örn. Slack — production)
Uç nokta	Uzak MCP sunucusunun HTTPS URL'si
Taşıma	Tekil JSON-RPC için HTTP, akışlı yanıtlar için SSE
Kimlik doğrulama	none, bearer veya header (özel başlık adı + değeri)
Gizli anahtar	Taşıyıcı token veya başlık değeri — şifreli olarak saklanır, bir daha gösterilmez
Açıklama	Satırın altında görünen isteğe bağlı kısa not
Etkin	Devre dışı sunucular sohbet AI'ına tanıtılmaz

Sunucu ekle'ye tıklayın. SetGet, uç noktaya anında ilk tools/list keşfini çalıştırır.

2. Araç kataloğunu doğrulama

Her sunucu satırı şunları gösterir:

• Durum rozeti (etkin / devre dışı).
• Taşıma ve kimlik doğrulama türü.
• Uç nokta URL'si.
• Son keşif zaman damgası ve varsa son hata (kimlik doğrulama, ağ, şema).
• Keşif başarılı olduğunda genişletilebilir Araçları göster listesi.

Satırda last_error görünüyorsa kimlik bilgilerini / URL'yi düzeltin ve yeniden denemek için Keşfet'e tıklayın.

3. Sohbetten araç kullanma

BUILD modundaki herhangi bir proje sohbetinde AI'ya doğal dilde isteyin:

"Slack üzerinden #releases kanalına 1.4.0'ı yeni gönderdik mesajını at."

AI eşleşen aracı (Slack — send_message) seçer, bir mcp_call eylemi önerir ve onay bekler:

Bunu Slack üzerinden #releases kanalına ileteceğim.

:::action
{"type":"mcp_call","data":{"server_id":"…","tool_name":"send_message","arguments":{"channel":"#releases","text":"Just shipped 1.4.0 🎉"}}}
:::

Onaylandığında çağrı SetGet'ten çıkar, yanıt sonucu özetleyen bir sohbet dönüşü olarak geri gelir.

4. Döndürme veya iptal etme

• Gizli anahtarı döndürme: Sunucuyu düzenleyin, Gizli anahtar alanına yeni bir değer girin. Alanı boş bırakmak mevcut kimlik bilgisini korur.
• Entegrasyonu duraklatma: Etkin seçeneğini kapatın. Sunucu kayıt defterinde kalır ancak sohbete artık tanıtılmaz.
• Tamamen kaldırma: Sil'e tıklayın. Hem sunucu satırı hem de şifreli gizli anahtar kaydı silinir.

Gelen — harici bir LLM istemcisinin SetGet'i yönetmesi

1. Taşıyıcı token oluşturma

Çalışma alanı ayarları → Geliştirici → MCP Token'ları bölümünü açın ve Token oluştur'a tıklayın.

Token'a kimin kullanacağını belirten bir etiket verin; örneğin Alice'in MacBook'undaki Claude Desktop veya Pazarlama ChatGPT Bağlayıcısı. Daha sonra iptal etmeniz gerektiğinde elinizde olacak tek tanımlayıcı budur.

Token'ı şimdi kopyalayın

Ham token (kmt_…) size yalnızca bir kez gösterilir. SetGet yalnızca SHA-256 özetini saklar; başlığı kapatmadan önce kopyalamazsanız yeni bir token oluşturmanız gerekir. Şifre yöneticinize kaydedin veya doğrudan LLM istemcisine yapıştırın.

2. LLM istemcisini bağlama

MCP istemcinizi SetGet'in gelen uç noktasına yönlendirin:

URL:    https://<setget-alan-adiniz>/mcp/v1/
Auth:   Authorization: Bearer kmt_<token-degeriniz>

Claude Desktop için claude_desktop_config.json dosyasına bir sunucu ekleyin:

{
  "mcpServers": {
    "setget": {
      "url": "https://app.setget.ai/mcp/v1/",
      "headers": {
        "Authorization": "Bearer kmt_<token-degeriniz>"
      }
    }
  }
}

İstemciyi yeniden başlatın. SetGet'e karşı initialize + tools/list çalıştıracak ve 26 araç yükleyecektir.

3. Hangi araçlar açıktır

Gelen katalog, SetGet'in yerel eylemlerinin güvenli alt kümesini kapsar:

• İş ögeleri — setget.issue.create, update, change_state, assign, add_label, remove_label, update_priority, set_due_date.
• Döngüler ve modüller — setget.cycle.create, setget.cycle.add_issues, setget.cycle.remove_issues ve eşdeğer modül üçlüsü.
• Sayfalar — setget.page.create, setget.page.update.
• Yorumlar — setget.comment.create.
• Çalışma alanı dokümanları — setget.doc.rename, archive, restore, duplicate, set_access, toggle_favorite, create_child.
• Kadrolama — setget.position.assign, setget.position.unassign.

Her aracın input_schema'sı yerel eylemin veri sözleşmesini yansıtır; harici bir LLM, yalnızca bu şemayı kullanarak çağrılarını doğru biçimde planlayabilir.

4. Açık OLMAYAN araçlar (ve nedenleri)

Beş eylem türü kasıtlı olarak kapsam dışında tutulmuştur:

Dışlanan	Neden
bulk_update_issues	SetGet içinde çok aşamalı bir LLM planlayıcısı çalıştırır; harici istemciler kendi toplu işlemlerini planlamalıdır.
generate_project	Çok dakikalık çok agent'lı proje oluşturma; uygulama içi inceleme arayüzüne ihtiyaç duyar.
apply_doc_edit_plan	Yalnızca doküman editörüne izole bir kanal; dışarıdan çağrıldığında dokümanı bozar.
translate_entire_doc, extract_action_items_to_issues	Kanala özgü kardeş işlemler.
mcp_call	Özyineleme tuzağı — harici bir istemcinin SetGet üzerinden başka bir MCP sunucusuna zincir çağrı yapmasına izin verir.

5. Güvenlik modeli

• Token'lar çalışma alanı kapsamlıdır. Sızdırılan bir token başka bir çalışma alanındaki verilere erişemez.
• Çapraz çalışma alanı argüman referansları gelen işleyicide reddedilir (hatalı kimlik doğrulama için mcp.inbound.unauthorized, çapraz çalışma alanı kimlikleri için ai.action.workspace_scope) — yerel bir yürütücünün kapsam denetimi zayıf olsa bile taşıyıcı kapısı yakalar.
• Token'lar oluşturulduktan sonra hiçbir zaman düz metin olarak görünmez. Liste görünümü yalnızca kmt_***<son_dört> biçiminde gösterir.
• İptal işlemi, satıra revoked_at değerini yazar; taşıyıcı kimlik doğrulama ara katmanı iptal edilmiş token'ları bir sonraki istekte anında reddeder. Satır denetim günlüğünde saklanır.

Sorun giderme

Giden: keşifte "auth" aşaması hatası

Uzak sunucu 401 veya 403 döndürdü. Gizli anahtar ile (özel başlıklar için) kimlik doğrulama başlık adının, yukarı akış MCP sunucusunun beklentisiyle eşleşip eşleşmediğini doğrulayın. Güncelledikten sonra yeniden denemek için Keşfet'e tıklayın.

Giden: "dial" aşaması hatası

DNS veya TCP hatası — uç nokta URL'si SetGet sunucularından erişilemiyor. URL'yi ve uzak servisin çalışır durumda olduğunu kontrol edin.

Gelen: harici istemci mcp.inbound.unauthorized döndürüyor

Token iptal edilmiş, yanlış yazılmış veya işaret ettiği çalışma alanı silinmiş. Ayarlardan yeni bir token oluşturun.

Gelen: araç çağrısı ai.action.workspace_scope döndürüyor

Harici LLM, taşıyıcı token'ın çalışma alanından farklı bir çalışma alanına ait bir kimlik (proje, iş ögesi, döngü, …) iletti. Bu, çapraz çalışma alanı korumasının isteği reddetmesidir. Harici istemcinin, kimlikleri çalışma alanları arasında önbelleğe almak yerine tools/call üzerinden almasını sağlayın.

İlgili sayfalar

• SetGet AI Genel Bakış — Sohbet AI'ının kendi başına neler yapabildiği.
• AI Eylemleri Referansı — Tam yerel eylem kataloğu (gelen olarak yalnızca derlenmiş bir alt küme açıktır).
• ADR 009 (iç dokümanlar) — Mimari, güvenlik modeli, ertelenmiş maddeler.