Kılavuz/Başlarken/Bölüm 02

MCP Kurulumu

Yargı Pro'yu Claude, ChatGPT, Cursor ve diğer AI istemcilerinize bağlayın.

Kurulum videoları#

Yazılı adımlara geçmeden önce videolu anlatımı izlemek isterseniz, kullandığınız araca uygun kısa kurulum videosunu aşağıdan açabilirsiniz. Karta tıkladığınızda video sayfa içinde oynar.

Nasıl bağlanılır#

Başlamadan önce: Komut satırıyla kurulum yapacaksanız bilgisayarınızda Node.js kurulu olmalı: nodejs.org/en/download

Tüm istemcilerde girilecek MCP adresi:

kod
https://yargi.betaspacestudio.com/mcp

Kullandığınız üyeliğe göre önerilen seçenekler şunlardır: Claude → claude.ai / Claude Desktop · ChatGPT → Codex · Gemini → Google Antigravity.

claude.ai / Claude Desktop#

İndirme: claude.com/download

  1. Customize menüsü → Connectors → + (Artı işareti) → Add custom connector
  2. Name: Yargı PRO
  3. URL: https://yargi.betaspacestudio.com/mcp
  4. Add'e tıklayın; tarayıcıda WorkOS izin sayfası açılır
  5. Hesabınızla giriş yapın, izin verin
  6. Claude'a "Yargıtay 1. Hukuk Dairesi son kararları" gibi bir istek yazın

ChatGPT web sitesi (önerilmez, Codex kullanın)#

Adres: chatgpt.com

  1. Ayarlar → Uygulamalar → Gelişmiş ayarlar → Geliştirici modu'nu açın
  2. Uygulama oluştur'a basın
  3. İsim: Yargı PRO
  4. MCP URL: https://yargi.betaspacestudio.com/mcp
  5. Kimlik doğrulama: OAuth
  6. "Anladım ve devam etmek istiyorum"'a tıklayın, ardından Oluştur'a basın
  7. Açılan pencerede hesabınızla giriş yapın; izin verildikten sonra MCP hazır
  8. Sohbet ekranında + simgesi → Daha fazla → Yargı PRO'yu seçip soru sorabilirsiniz

Codex (ChatGPT aboneliği ile kullanılır)#

İndirme: developers.openai.com/codex/app

  1. Ayarlar → MCP sunucuları → Sunucu ekle
  2. Sunucu adı: Yargı PRO
  3. Akış Destekli HTTP (Streamable HTTP) seçin
  4. URL: https://yargi.betaspacestudio.com/mcp
  5. Kaydet'e tıklayın; tarayıcıda WorkOS OAuth açılır

Cursor#

İndirme: cursor.com/download

  1. Settings → Tools & MCP → Add new MCP server
  2. Type: streamable-http
  3. URL alanına şu adresi yapıştırın: https://yargi.betaspacestudio.com/mcp
  4. Install → tarayıcı OAuth akışı açılır

Alternatif: ~/.cursor/mcp.json dosyasına ekleyebilirsiniz:

json
{
  "mcpServers": {
    "yargi-mcp-pro": {
      "url": "https://yargi.betaspacestudio.com/mcp",
      "type": "streamable-http"
    }
  }
}

Google Antigravity (Gemini aboneliği ile kullanılır)#

İndirme: antigravity.google/download

  1. Antigravity ve Antigravity IDE'yi kurun.
  2. İşletim sisteminize göre aşağıdaki kodu terminale yapıştırıp çalıştırın:

macOS / Linux — Terminal'i açın (Cmd + Boşluk → Terminal), aşağıdaki bloğun tamamını yapıştırın. (Linux: Ctrl + Alt + T)

bash
node - <<'YARGI'
const fs=require("fs"),os=require("os"),path=require("path");
const dir=path.join(os.homedir(),".gemini","config"),file=path.join(dir,"mcp_config.json");
fs.mkdirSync(dir,{recursive:true});
let cfg={};try{cfg=JSON.parse(fs.readFileSync(file,"utf8"))}catch{}
if(typeof cfg!=="object"||cfg===null||Array.isArray(cfg))cfg={};
if(typeof cfg.mcpServers!=="object"||cfg.mcpServers===null)cfg.mcpServers={};
cfg.mcpServers["yargi-mcp-pro"]={command:"npx",args:["-y","mcp-remote@latest","https://yargi.betaspacestudio.com/mcp"]};
fs.writeFileSync(file,JSON.stringify(cfg,null,2)+"\n");
console.log("yargi-mcp-pro eklendi -> "+file);
YARGI
npx -y mcp-remote@latest https://yargi.betaspacestudio.com/mcp

Windows — PowerShell'i açın (Başlat → PowerShell), aşağıdaki bloğun tamamını yapıştırın.

powershell
@'
const fs=require("fs"),os=require("os"),path=require("path");
const dir=path.join(os.homedir(),".gemini","config"),file=path.join(dir,"mcp_config.json");
fs.mkdirSync(dir,{recursive:true});
let cfg={};try{cfg=JSON.parse(fs.readFileSync(file,"utf8"))}catch{}
if(typeof cfg!=="object"||cfg===null||Array.isArray(cfg))cfg={};
if(typeof cfg.mcpServers!=="object"||cfg.mcpServers===null)cfg.mcpServers={};
cfg.mcpServers["yargi-mcp-pro"]={command:"cmd",args:["/c","npx","-y","mcp-remote@latest","https://yargi.betaspacestudio.com/mcp"]};
fs.writeFileSync(file,JSON.stringify(cfg,null,2)+"\n");
console.log("yargi-mcp-pro eklendi -> "+file);
'@ | node -
npx.cmd -y mcp-remote@latest https://yargi.betaspacestudio.com/mcp

Yapıştırdığınızda komut otomatik çalışır. Tarayıcıda WorkOS giriş sayfası açıldığında hesabınızla giriş yapın. Terminalde Press Ctrl+C to exit yazısını gördüğünüzde MCP başarıyla kurulmuş demektir. Terminal penceresini kapatabilirsiniz; token bilgisayarınıza kaydedilir. Ardından Antigravity'yi açın; yeniden giriş yapmanız gerekmez.

Zcode (Z.ai)#

İndirme: zcode.z.ai/en

  1. Zcode'u indirip kurun.
  2. İşletim sisteminize göre aşağıdaki kodu terminale yapıştırıp çalıştırın:

macOS / Linux

bash
node - <<'YARGI'
const fs=require("fs"),os=require("os"),path=require("path");
const dir=path.join(os.homedir(),".zcode","cli"),file=path.join(dir,"config.json");
fs.mkdirSync(dir,{recursive:true});
let cfg={};try{cfg=JSON.parse(fs.readFileSync(file,"utf8"))}catch{}
if(typeof cfg!=="object"||cfg===null||Array.isArray(cfg))cfg={};
if(typeof cfg.mcp!=="object"||cfg.mcp===null)cfg.mcp={};
if(typeof cfg.mcp.servers!=="object"||cfg.mcp.servers===null)cfg.mcp.servers={};
cfg.mcp.servers["yargi-mcp-pro"]={type:"stdio",command:"npx",args:["-y","mcp-remote@latest","https://yargi.betaspacestudio.com/mcp"]};
fs.writeFileSync(file,JSON.stringify(cfg,null,2)+"\n");
console.log("yargi-mcp-pro eklendi -> "+file);
YARGI
npx -y mcp-remote@latest https://yargi.betaspacestudio.com/mcp

Windows

powershell
@'
const fs=require("fs"),os=require("os"),path=require("path");
const dir=path.join(os.homedir(),".zcode","cli"),file=path.join(dir,"config.json");
fs.mkdirSync(dir,{recursive:true});
let cfg={};try{cfg=JSON.parse(fs.readFileSync(file,"utf8"))}catch{}
if(typeof cfg!=="object"||cfg===null||Array.isArray(cfg))cfg={};
if(typeof cfg.mcp!=="object"||cfg.mcp===null)cfg.mcp={};
if(typeof cfg.mcp.servers!=="object"||cfg.mcp.servers===null)cfg.mcp.servers={};
cfg.mcp.servers["yargi-mcp-pro"]={type:"stdio",command:"cmd",args:["/c","npx","-y","mcp-remote@latest","https://yargi.betaspacestudio.com/mcp"]};
fs.writeFileSync(file,JSON.stringify(cfg,null,2)+"\n");
console.log("yargi-mcp-pro eklendi -> "+file);
'@ | node -
npx.cmd -y mcp-remote@latest https://yargi.betaspacestudio.com/mcp

Kod, ~/.zcode/cli/config.json dosyasına yargi-mcp-pro'yu ekler. Tarayıcıda WorkOS giriş sayfası açıldığında hesabınızla giriş yapın. Terminalde Press Ctrl+C to exit yazısını gördüğünüzde MCP başarıyla kurulmuş demektir. Terminal penceresini kapatabilirsiniz; token bilgisayarınıza kaydedilir. Ardından Zcode'u açın; yeniden giriş yapmanız gerekmez.

VS Code#

İndirme: code.visualstudio.com/download

  1. Gereksinim: VS Code 1.101+ ve GitHub Copilot Chat eklentisi
  2. Command Palette (⌘⇧P) → MCP: Open User Configuration
  3. Açılan dosyaya aşağıdaki JSON'u ekleyin:
json
{
  "servers": {
    "yargi-mcp-pro": {
      "type": "http",
      "url": "https://yargi.betaspacestudio.com/mcp"
    }
  }
}

Command Palette → MCP: List Servers yolunu izleyin ve yargi-mcp-pro için Start'a tıklayın. Tarayıcıda OAuth sayfası açılır.

OpenCode Desktop#

İndirme: opencode.ai/download

İşletim sisteminize göre aşağıdaki kodu çalıştırın:

macOS / Linux

bash
node - <<'YARGI'
const fs=require("fs"),os=require("os"),path=require("path");
const dir=path.join(os.homedir(),".config","opencode"),file=path.join(dir,"opencode.json");
fs.mkdirSync(dir,{recursive:true});
let cfg={};try{cfg=JSON.parse(fs.readFileSync(file,"utf8"))}catch{}
if(typeof cfg!=="object"||cfg===null||Array.isArray(cfg))cfg={};
if(!cfg["$schema"])cfg["$schema"]="https://opencode.ai/config.json";
if(typeof cfg.mcp!=="object"||cfg.mcp===null)cfg.mcp={};
cfg.mcp["yargi-mcp-pro"]={type:"remote",url:"https://yargi.betaspacestudio.com/mcp"};
fs.writeFileSync(file,JSON.stringify(cfg,null,2)+"\n");
console.log("yargi-mcp-pro eklendi -> "+file);
YARGI

Windows

powershell
@'
const fs=require("fs"),os=require("os"),path=require("path");
const dir=path.join(os.homedir(),".config","opencode"),file=path.join(dir,"opencode.json");
fs.mkdirSync(dir,{recursive:true});
let cfg={};try{cfg=JSON.parse(fs.readFileSync(file,"utf8"))}catch{}
if(typeof cfg!=="object"||cfg===null||Array.isArray(cfg))cfg={};
if(!cfg["$schema"])cfg["$schema"]="https://opencode.ai/config.json";
if(typeof cfg.mcp!=="object"||cfg.mcp===null)cfg.mcp={};
cfg.mcp["yargi-mcp-pro"]={type:"remote",url:"https://yargi.betaspacestudio.com/mcp"};
fs.writeFileSync(file,JSON.stringify(cfg,null,2)+"\n");
console.log("yargi-mcp-pro eklendi -> "+file);
'@ | node -

Ardından masaüstü uygulamasını açın. Sağ üstteki durum butonuna tıklayın → MCP sekmesini açın → yargi-mcp-pro'ya tıklayıp giriş yapın. Tarayıcıda WorkOS OAuth sayfası açılır.

Witsy#

İndirme: witsyai.com

  1. Witsy'de yeni bir sohbet açın → sağ üstteki Connectors butonuna tıklayın
  2. Açılan panelde sağ üstten Add MCP server
  3. Label: Yargı PRO, URL: https://yargi.betaspacestudio.com/mcp → Save

Hermes Agent#

  1. Hermes Agent masaüstü uygulamasında sağ üstteki ayarlar simgesine tıklayın
  2. MCP sekmesine geçin
  3. Name alanına Yargı PRO yazın
  4. JSON alanına aşağıdaki kodu yapıştırın:
json
{
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote@latest",
    "https://yargi.betaspacestudio.com/mcp"
  ],
  "env": {}
}

Save server'a tıklayın. İlk bağlantıda tarayıcıda WorkOS giriş sayfası açılır; hesabınızla giriş yapın.

LM Studio (lokal modeller)#

İndirme: lmstudio.ai/download

İşletim sisteminize göre aşağıdaki kodu çalıştırın:

macOS / Linux

bash
node - <<'YARGI'
const fs=require("fs"),os=require("os"),path=require("path");
const home=os.homedir();
const candidates=[path.join(home,".lmstudio"),path.join(home,".cache","lm-studio")];
const dir=candidates.find(d=>fs.existsSync(d))||candidates[0];
const file=path.join(dir,"mcp.json");
fs.mkdirSync(dir,{recursive:true});
let cfg={};try{cfg=JSON.parse(fs.readFileSync(file,"utf8"))}catch{}
if(typeof cfg!=="object"||cfg===null||Array.isArray(cfg))cfg={};
if(typeof cfg.mcpServers!=="object"||cfg.mcpServers===null)cfg.mcpServers={};
cfg.mcpServers["yargi-mcp-pro"]={command:"npx",args:["-y","mcp-remote@latest","https://yargi.betaspacestudio.com/mcp"]};
fs.writeFileSync(file,JSON.stringify(cfg,null,2)+"\n");
console.log("yargi-mcp-pro eklendi -> "+file);
YARGI
npx -y mcp-remote@latest https://yargi.betaspacestudio.com/mcp

Windows

powershell
@'
const fs=require("fs"),os=require("os"),path=require("path");
const home=os.homedir();
const candidates=[path.join(home,".lmstudio"),path.join(home,".cache","lm-studio")];
const dir=candidates.find(d=>fs.existsSync(d))||candidates[0];
const file=path.join(dir,"mcp.json");
fs.mkdirSync(dir,{recursive:true});
let cfg={};try{cfg=JSON.parse(fs.readFileSync(file,"utf8"))}catch{}
if(typeof cfg!=="object"||cfg===null||Array.isArray(cfg))cfg={};
if(typeof cfg.mcpServers!=="object"||cfg.mcpServers===null)cfg.mcpServers={};
cfg.mcpServers["yargi-mcp-pro"]={command:"cmd",args:["/c","npx","-y","mcp-remote@latest","https://yargi.betaspacestudio.com/mcp"]};
fs.writeFileSync(file,JSON.stringify(cfg,null,2)+"\n");
console.log("yargi-mcp-pro eklendi -> "+file);
'@ | node -
npx.cmd -y mcp-remote@latest https://yargi.betaspacestudio.com/mcp

Komutu çalıştırdığınızda tarayıcıda WorkOS giriş sayfası açılır; hesabınızla giriş yapın. Terminalde Press Ctrl+C to exit yazısını gördüğünüzde MCP başarıyla kurulmuş demektir. Terminal penceresini kapatabilirsiniz; token bilgisayarınıza kaydedilir. Ardından LM Studio'yu açın; yeniden giriş yapmanız gerekmez. Bağlantıyı sağ kenar çubuğundaki Program sekmesinden kontrol edebilirsiniz.

Claude Code CLI#

Tek komut:

bash
claude mcp add yargi-mcp-pro --transport http https://yargi.betaspacestudio.com/mcp

Sonra Claude Code içinde /mcp yazıp yargi-mcp-pro'yu seçin; tarayıcıda OAuth açılır.

Antigravity CLI (Gemini aboneliği ile kullanılır)#

Antigravity CLI, MCP sunucularını plugin klasörü olarak yükler. Aşağıdaki kod, gerekli klasörü ve dosyaları (plugin.json + mcp_config.json) sizin yerinize oluşturur.

İşletim sisteminize göre aşağıdaki kodu çalıştırın:

macOS / Linux

bash
node - <<'YARGI'
const fs=require("fs"),os=require("os"),path=require("path");
const dir=path.join(os.homedir(),".gemini","antigravity-cli","plugins","yargi-mcp-pro");
fs.mkdirSync(dir,{recursive:true});
fs.writeFileSync(path.join(dir,"plugin.json"),JSON.stringify({name:"yargi-mcp-pro",version:"1.0.0"},null,2)+"\n");
fs.writeFileSync(path.join(dir,"mcp_config.json"),JSON.stringify({mcpServers:{"yargi-mcp-pro":{command:"npx",args:["-y","mcp-remote@latest","https://yargi.betaspacestudio.com/mcp"]}}},null,2)+"\n");
console.log("yargi-mcp-pro plugin kuruldu -> "+dir);
YARGI
npx -y mcp-remote@latest https://yargi.betaspacestudio.com/mcp

Windows

powershell
@'
const fs=require("fs"),os=require("os"),path=require("path");
const dir=path.join(os.homedir(),".gemini","antigravity-cli","plugins","yargi-mcp-pro");
fs.mkdirSync(dir,{recursive:true});
fs.writeFileSync(path.join(dir,"plugin.json"),JSON.stringify({name:"yargi-mcp-pro",version:"1.0.0"},null,2)+"\n");
fs.writeFileSync(path.join(dir,"mcp_config.json"),JSON.stringify({mcpServers:{"yargi-mcp-pro":{command:"cmd",args:["/c","npx","-y","mcp-remote@latest","https://yargi.betaspacestudio.com/mcp"]}}},null,2)+"\n");
console.log("yargi-mcp-pro plugin kuruldu -> "+dir);
'@ | node -
npx.cmd -y mcp-remote@latest https://yargi.betaspacestudio.com/mcp

Komutu çalıştırdığınızda tarayıcıda WorkOS giriş sayfası açılır; hesabınızla giriş yapın. Terminalde Press Ctrl+C to exit yazısını gördüğünüzde MCP başarıyla kurulmuş demektir. Terminal penceresini kapatabilirsiniz; token bilgisayarınıza kaydedilir. Ardından Antigravity CLI'ı açın; plugin otomatik yüklenir ve yeniden giriş yapmanız gerekmez.

Codex CLI (ChatGPT aboneliği ile kullanılır)#

Terminalde sırasıyla şu iki komutu çalıştırın:

bash
codex mcp add yargi-mcp-pro --url https://yargi.betaspacestudio.com/mcp
bash
codex mcp login yargi-mcp-pro

İkinci komutta tarayıcıda WorkOS OAuth açılır.

Kimi Code CLI#

İndirme: github.com/MoonshotAI/kimi-code

  1. Kimi Code CLI'ı açın, /mcp-config yazıp Enter'a basın
  2. Açılan sohbete aşağıdaki metni yapıştırın:
kod
Bu adresi global MCP sunucusu olarak ekle: https://yargi.betaspacestudio.com/mcp — sunucunun adı yargi-pro olsun.

Kurulum tamamlanınca /new yazıp Enter'a basın. Ardından /mcp-config login yargi-pro yazıp Enter'a basın; açılan tarayıcı penceresinden hesabınızla giriş yapın.

OpenCode#

İşletim sisteminize göre aşağıdaki kodu çalıştırın:

macOS / Linux

bash
node - <<'YARGI'
const fs=require("fs"),os=require("os"),path=require("path");
const dir=path.join(os.homedir(),".config","opencode"),file=path.join(dir,"opencode.json");
fs.mkdirSync(dir,{recursive:true});
let cfg={};try{cfg=JSON.parse(fs.readFileSync(file,"utf8"))}catch{}
if(typeof cfg!=="object"||cfg===null||Array.isArray(cfg))cfg={};
if(!cfg["$schema"])cfg["$schema"]="https://opencode.ai/config.json";
if(typeof cfg.mcp!=="object"||cfg.mcp===null)cfg.mcp={};
cfg.mcp["yargi-mcp-pro"]={type:"remote",url:"https://yargi.betaspacestudio.com/mcp"};
fs.writeFileSync(file,JSON.stringify(cfg,null,2)+"\n");
console.log("yargi-mcp-pro eklendi -> "+file);
YARGI

Windows

powershell
@'
const fs=require("fs"),os=require("os"),path=require("path");
const dir=path.join(os.homedir(),".config","opencode"),file=path.join(dir,"opencode.json");
fs.mkdirSync(dir,{recursive:true});
let cfg={};try{cfg=JSON.parse(fs.readFileSync(file,"utf8"))}catch{}
if(typeof cfg!=="object"||cfg===null||Array.isArray(cfg))cfg={};
if(!cfg["$schema"])cfg["$schema"]="https://opencode.ai/config.json";
if(typeof cfg.mcp!=="object"||cfg.mcp===null)cfg.mcp={};
cfg.mcp["yargi-mcp-pro"]={type:"remote",url:"https://yargi.betaspacestudio.com/mcp"};
fs.writeFileSync(file,JSON.stringify(cfg,null,2)+"\n");
console.log("yargi-mcp-pro eklendi -> "+file);
'@ | node -

Sonra terminalde:

bash
opencode mcp auth yargi-mcp-pro

Tarayıcıda WorkOS OAuth açılır.

Diğer MCP istemcileri (mcp-remote ile)#

macOS / Linux

bash
npx -y mcp-remote@latest https://yargi.betaspacestudio.com/mcp

Windows

powershell
npx.cmd -y mcp-remote@latest https://yargi.betaspacestudio.com/mcp

Komutu bir kez çalıştırın; tarayıcıda OAuth tamamlanır ve token cache'lenir. Terminalde Press Ctrl+C to exit yazısını gördüğünüzde MCP başarıyla kurulmuş demektir. Terminal penceresini kapatabilirsiniz. Ardından kendi MCP istemcinizi ~/.mcp-auth/ altındaki token ile yapılandırabilirsiniz.

Örnek kullanım#

AI asistanınıza örneğin şöyle sorabilirsiniz:

İhtiyaç Nedeniyle Tahliye#

kod
TBK m.350 uyarınca konut ihtiyacı nedeniyle tahliye davalarında ilgili kanun maddelerini ve gerekçelerini incele, ardından Yargıtay kararlarında "samimi ve zorunlu ihtiyaç" ölçütünün nasıl uygulandığını araştır. Dava açılmadan önce dikkat edilmesi gereken riskleri ve gerekli delilleri listele.

Geçersiz Fesih Stratejisi#

kod
Performans düşüklüğü gerekçesiyle yapılan iş sözleşmesi fesihleri için İş Kanunu'nda yer alan ilgili hükümleri tespit et, sonra Yargıtay ve istinaf kararlarında geçerli fesih için aranan kriterleri karşılaştır. İşe iade davasında güçlü ve zayıf argümanlar ile dava stratejisi notunu çıkar.

Vergi Cezasında Tebligat#

kod
Vergi ziyaı cezalarında usulsüz tebligat iddiasının değerlendirilmesi için VUK ve Tebligat Kanunu'nda uygulanabilecek maddeleri bul, Danıştay kararlarında usulsüz tebligatın dava açma süresine etkisini araştır. Süre hesabı, iptal argümanları ve emsal içtihatları özetle.

← Önceki

Üyelik ve Hesap

Sonraki →

MCP Araçları