Geliştirici

Geliştirici, Hesap ayarları sayfasının Hesap grubunda yer alır. LetDraw REST API’si ve MCP sunucusu için kişisel API belirteçlerini (token) buradan oluşturur ve yönetirsin. Bu belirteçlerle bir betikten (script) LetDraw diyagramlarına programatik erişebilir ya da bir yapay zeka istemcisini (Claude, Cursor gibi) LetDraw’a MCP üzerinden bağlayabilirsin.

Kimler görür

Oturum açmış Pro/Enterprise kullanıcılar (SaaS’ta) ya da self-hosted’da tüm üyeler.

Belirteç (token) oluştur

Bir belirteç oluştur kartından:

• Ad: belirteci hatırlaman için bir etiket (ör. “Dizüstüm”, “CI betiği”, “Claude MCP”).
• Kapsamlar (scopes): belirtecin neye yetkili olduğunu seçersin (en az ayrıcalık ilkesi; yalnızca gerekeni ver):
  • diagrams:read (Diyagramları oku): diyagramları okur/listeler.
  • diagrams:write (Diyagram oluştur ve düzenle): diyagram oluşturur ve değiştirir.
  • export (Dışa aktar): diyagramı Mermaid / D2 / SVG olarak verir.
  • ai:generate (Komuttan üret): bir metin komutundan diyagram ürettirir (AI).
• Çalışma alanı: belirteci tüm çalışma alanlarına ya da yalnızca tek bir alana sınırlayabilirsin.
• Belirteç oluştur’a bas.

Belirteç oluşturulunca ham değeri (ld_live_… önekiyle) yalnızca bir kez gösterilir; sunucu yalnızca bir özetini saklar, tam değeri bir daha gösteremez. Hemen kopyala ve güvenli bir yerde sakla. Kaybedersen döndürerek (rotate) yenisini alırsın.

Belirteçlerin

Oluşturduğun her belirteç Belirteçlerin kartında listelenir; ad, önek, kapsamlar, (varsa) çalışma alanı ve son kullanım tarihi görünür. İki eylem vardır:

• Döndür (Rotate): yeni bir belirteç üretir ve eskisini anında geçersiz kılar. Sızıntı şüphesinde ya da periyodik yenilemede kullan; sonra istemcilerini yeni belirteçle güncelle.
• İptal et (Revoke): belirteci kalıcı olarak kapatır. Onu kullanan her istemci anında çalışmayı durdurur.

Connecting (Bağlantı)

Connecting kartı, belirtecini nereye ve nasıl göndereceğini gösterir. Belirteç, her istekte bir Bearer başlığı olarak gönderilir:

Authorization: Bearer <belirtecin>

İki uç nokta vardır (kart üstünde kopyalanabilir; aşağıdakiler SaaS adresleridir, self-hosted’da kendi sunucunun adresidir):

• REST API temel adresi: https://api.letdraw.com/api-v1 (betiklerden programatik erişim için).
• MCP sunucu URL’si: https://api.letdraw.com/mcp (bir yapay zeka istemcisini bağlamak için).

Connect an MCP client (MCP istemci bağlama)

MCP (Model Context Protocol), yapay zeka istemcilerinin (Claude, Cursor gibi) LetDraw’ı bir araç olarak kullanmasını sağlar: istemcin, senin belirtecinle LetDraw MCP sunucusuna bağlanıp diyagram okur, oluşturur, düzenler ya da dışa aktarır (belirtecin kapsamları neye izin veriyorsa).

Adımlar:

1. Yukarıdan bir belirteç oluştur.
2. Connect an MCP client kartından istemcini seç.
3. Verilen yapılandırmayı ilgili dosyaya yapıştır ve kaydet. (Belirteci yeni oluşturduysan yapılandırmaya otomatik gömülür; yoksa ld_live_YOUR_TOKEN yer tutucusunu kendi belirtecinle değiştir.)
4. İstemciyi yeniden başlat.

Desteklenen istemciler ve yapılandırma konumları:

İstemci	Yapılandırma konumu	Bağlantı biçimi
Cursor	~/.cursor/mcp.json	Doğrudan uzak HTTP
VS Code	.vscode/mcp.json	Doğrudan uzak HTTP (type: http)
Claude Code	Terminal (komut)	claude mcp add komutu
Claude Desktop	claude_desktop_config.json	npx mcp-remote köprüsü
Codex	~/.codex/config.toml	npx mcp-remote köprüsü
OpenCode	opencode.json	Uzak (type: remote)

Her istemci için kartta yapıştırmaya hazır tam yapılandırma verilir. Örnekler:

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "letdraw": {
      "url": "https://api.letdraw.com/mcp",
      "headers": { "Authorization": "Bearer ld_live_YOUR_TOKEN" }
    }
  }
}

Claude Code (terminalde):

claude mcp add --transport http letdraw https://api.letdraw.com/mcp \
  --header "Authorization: Bearer ld_live_YOUR_TOKEN"

Köprü notu: Claude Desktop ve Codex uzak HTTP MCP’yi doğrudan konuşmadığından, npx mcp-remote üzerinden köprülenir; bu istemciler için Node.js kurulu olmalı ve kaydettikten sonra istemciyi yeniden başlatmalısın.

Güvenlik

• Bir API belirteci parola gücündedir; kimseyle paylaşma, herkese açık depolara (repo) koyma.
• En az ayrıcalık: yalnızca gereken kapsamları ver ve mümkünse belirteci tek bir çalışma alanına sınırla.
• Ham belirteç yalnızca bir kez gösterilir; sunucu yalnızca özetini tutar.
• Sızıntı ya da şüphe durumunda Döndür ya da İptal et.

Uç noktalar, kapsamlar ve MCP araçlarının tam listesi için API ve MCP referansı sayfasına bak.