DOKÜMANTASYON · SMOP MCP

Bağlantı rehberi

Uç nokta: https://turkcode.ai/hub/smop · aktarım: Streamable HTTP · kimlik: Authorization: Bearer tc_…

1. Hızlı başlangıç

Ücretsiz üye ol ve e-postanı doğrula.
Hesabım → API anahtarları → "Yeni anahtar üret". Anahtar yalnızca bir kez gösterilir.
Aşağıdan kullandığın istemcinin yapılandırmasını ekle.
Ajanına "smop_status ile nerede kaldığımızı söyle" de. Proje yoksa ajan smop_create_project ile oluşturur.

2. İstemci yapılandırması

tc_ANAHTARIN yerine kendi anahtarını yaz. Her makine veya ajan için ayrı anahtar üretebilirsin; panelden iptal edilen anahtarla bağlantı kurulamaz.

Claude Code

Terminalde tek komut:

claude mcp add --transport http turkcode-smop https://turkcode.ai/hub/smop --header "Authorization: Bearer tc_ANAHTARIN"

veya proje kökündeki .mcp.json:

{
  "mcpServers": {
    "turkcode-smop": {
      "type": "http",
      "url": "https://turkcode.ai/hub/smop",
      "headers": { "Authorization": "Bearer tc_ANAHTARIN" }
    }
  }
}

Cursor

~/.cursor/mcp.json veya proje içinde .cursor/mcp.json:

{
  "mcpServers": {
    "turkcode-smop": {
      "url": "https://turkcode.ai/hub/smop",
      "headers": { "Authorization": "Bearer tc_ANAHTARIN" }
    }
  }
}

VS Code (Copilot Chat)

.vscode/mcp.json:

{
  "servers": {
    "turkcode-smop": {
      "type": "http",
      "url": "https://turkcode.ai/hub/smop",
      "headers": { "Authorization": "Bearer tc_ANAHTARIN" }
    }
  }
}

opencode

opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "turkcode-smop": {
      "type": "remote",
      "url": "https://turkcode.ai/hub/smop",
      "headers": { "Authorization": "Bearer tc_ANAHTARIN" },
      "enabled": true
    }
  }
}

3. Ajan talimatı

Bu bloğu repondaki CLAUDE.md veya AGENTS.md dosyasına ekle; ajan her oturumda aynı ritmi izler.

## TurkCode SMOP
- Oturum başında `smop_status` çağır; sıradaki iş için `smop_next`.
- Kartı `smop_start_card` ile başlat; yalnızca kartın iş emrindeki dosyalara dokun.
- İş bitince `smop_submit_card`: değişen dosyalar, build/test son satırı, kontrol maddeleri.
- Kartı "done" yapamazsın; onayı insan verir. Bu arada sıradaki karta geçebilirsin.
- Karar aldıysan `smop_add_decision` (ne, neden, neyin tetiklediği).
- Oturum sonunda `smop_close_session` (next_action zorunlu), ardından `smop_export`
  çıktısındaki dosyaları repodaki yollarına yaz.

4. Durum makinesi kuralları

İnsan onayı: ajan bir kartı en fazla review_required'a taşır. done, retry ve skipped yalnızca panelden verilir.
Sonuç notu: incelemeye gönderirken zorunlu. Panelden "tekrar" denirse yazılan not, ajanın bir sonraki smop_next çıktısında görünür.
Bağımlılık: bir kart, bağımlı olduğu kartlar (P1-T2) veya fazlar (P1) kapanmadan başlamaz.
Gate: her fazın son kartı gate'tir. Önceki fazın gate kartı onaylanmadan sonraki fazın kartları başlamaz.
Bayraklar (kapalı küme): hard-item, mock-ok, draft-ui-ok. hard-item kart şartname referansı (spec_ref) olmadan incelemeye gidemez.
Oturum kapanışı: next_action yazılmadan oturum kapanmaz.

5. Mevcut SMOP yapısını taşıma

Repoda SMOP developer-split yapısı varsa ajana şunu söyle:

.developer/sot/<INT>/03-wbs.md, .developer/memory/execution/plan-registry.json ve
.developer/memory/decisions/decision-log.json dosyalarını oku ve smop_import ile aktar.

İçe aktarma idempotenttir: tekrar çalıştırmak kart çoğaltmaz, hiçbir şeyi silmez, sunucudaki durumu geri düşürmez. [x] işaretli kartlar kapanır.
Çalışma sırasında gerçek kaynak sunucudur. Oturum sonunda smop_export aynı üç dosyayı üretir; repodaki doğrulayıcıların çalışmaya devam eder.
Panelden de "SMOP dosyalarını indir" ile aynı paketi alabilirsin.

6. Kotalar ve hatalar

Plan	Proje	Günlük araç çağrısı
Free	1	100
Standard	sınırsız	5.000

Kota UTC gece yarısı sıfırlanır; güncel kullanım smop_list_projects çıktısında ve API anahtarları sayfasında görünür.
401: anahtar yok, yanlış ya da iptal edilmiş. Araç hatası: kural ihlali (ör. onaylanmamış gate); mesaj Türkçe ve ne yapılacağını söyler.

Hazırsan ilk anahtarını üret.

Ücretsiz başla Araç listesi