MCP — ajan API’si

PrimDB, Model Context Protocol (MCP) üzerinden ajanın okuyabildiği bir API sunar. Claude Desktop, Cursor ya da herhangi bir MCP/ajan istemcisini tek bir proje-kapsamlı token’la buna yönlendir; bütün bir projeyi kurup düzeltebilir: deploy ve terfi et, başarısız bir build’in loglarını okuyup tanıla, başlangıç komutunu ya da env’i güncelle, yönetilen veritabanları sağla ya da sil, verini sorgula ve geri bildirim notlarını oku. Hepsi tek bir projeye kapsanır.

1. Token oluştur

Panelde: projen → Ayarlar → API token’ları → Yeni token. Bir kez gösterilen değeri kopyala (biçim primdb_mcp_<project>_<random>). Proje-kapsamlıdır: bir token yalnızca kendi projesine dokunabilir. Aynı ekrandan istediğin an iptal et.

2. Bağlan

• Uç nokta: https://mcp.primdb.com
• Auth: Authorization: Bearer primdb_mcp_...
• Taşıma: HTTP (JSON-RPC 2.0)
• Hız sınırı: token başına dakikada 1000 istek (aşıldığında 429 + Retry-After)

Claude Desktop / Cursor (mcp.json)

{
  "mcpServers": {
    "primdb": {
      "url": "https://mcp.primdb.com",
      "headers": {
        "Authorization": "Bearer primdb_mcp_..."
      }
    }
  }
}

Doğrudan HTTP (herhangi bir ajan)

curl -s https://mcp.primdb.com \
  -H "Authorization: Bearer primdb_mcp_..." \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

3. Araçlar

Dürüst not. Hostlar araçları hesap düzeyindedir: tek bir projeye değil, filona etki ederler, bu yüzden proje token’ı yerine hesap-kapsamlı bir token gerektirirler. Kendi sunucunu kaydetmek, servisleri ona sabitlemek ve orada zaten çalışan konteynerları keşfetmek ya da benimsemek için kullan. Hostlar bölümüne bak.

Dürüst not. Bir ajan artık bir projeyi tek başına bozuktan canlıya taşıyabilir: başarısız bir build’i okumak için get_deployment_logs, kök neden + düzeltme için diagnose_deployment, başlangıç komutunu ya da env’i düzeltmek için update_settings / set_env, uygulamanın ihtiyaç duyduğu veritabanını sağlamak için create_data_service, sonra deploy. Yalnızca Owner araçları (ayarlar, veritabanı oluştur/sil, deploy) oluşturucusu projeyi sahiplenen bir token gerektirir. Veri araçları projenin ilgili servisini otomatik çözer; yalnızca bir projede bir türden birden fazla olduğunda serviceId geç.

Ajan hızlı başlangıcı: yapıştırılacak istemler

MCP istemcin bağlandığında, ne istediğini düz dille ajana söyle. Birkaç başlangıç:

• “Bu repoyu PrimDB’ye deploy et ve bana önizleme URL’sini ver.”
• “Son deploy’um başarısız oldu: build loglarını oku, nedenini söyle ve düzelt.”
• “Bu uygulamaya Postgres ve Redis gerekiyor. Onları sağla ve başlangıç komutunu ayarla, sonra deploy et.”
• “Son deploylarımı listele ve en son geçen önizlemeyi üretime terfi et.”
• “Bu SQL sorgusunu PrimDB Postgres’ime karşı çalıştır ve satırları özetle.”
• “PrimDB projemde STRIPE_KEY env değişkenini ayarla, sonra yeniden deploy et.”
• “Açık önizleme geri bildirim notlarını göster ve ödeme düğmesiyle ilgili olanı çöz.”

Güvenlik

• Bir token tek bir projeye bağlıdır: başka bir projenin deploylarına, verisine, env’ine ya da notlarına asla ulaşamaz.
• Postgres / Redis / Depolama erişimi, platformun geri kalanının kullandığı aynı kiracı-başına izolasyondan geçer (DB rolleri, Redis ACL’leri, kova kapsamlama).
• Her araç çağrısı denetim kaydına yazılır (mcp_<tool> artı token id). Anında iptal et.
• Gizli değerler (set_env değerleri, bağlantı dizeleri) denetim kayıtlarına asla yazılmaz.