Ders 1 / 97 dk okuma

API & MCP: hesabını Claude Code ve OpenAI ile yönet

Bir anahtar oluştur, MCP sunucusuna bağlan; projeleri listele, build başlat, veriyi ve görselleri düzenle — konsolu açmadan.

DevAny'nin bir MCP (Model Context Protocol) sunucusu ve onun REST ikizi vardır. Claude Code, OpenAI'nin Responses API'si ya da herhangi bir HTTP istemcisi aynı araç setini kullanır: projeler, build'ler, yayın, kayıtlar, görseller, kontroller ve yönetici hesaplar için platform ayarları.

Anahtar hesabın adına çalışır ve verdiğin kapsamlarla sınırlıdır. 'Build başlat' kapsamı kredi harcayabilir; içerik düzenlemeleri ücretsizdir ve anında yayına girer.

Bağlan

1
Anahtar oluştur
Ayarlar → API & MCP. Ad ver, kapsamları seç, istersen bitiş tarihi koy. Anahtar yalnız bir kez gösterilir.
2
Claude Code
Ekranda hazır komutu yapıştır: claude mcp add --transport http devany https://devany.ai/api/mcp --header "Authorization: Bearer dk_…"
3
OpenAI
Responses API'de type:'mcp' aracı olarak aynı adresi ve Authorization başlığını ver; Custom GPT Actions için /api/v1/openapi belgesini içe aktar. Bu belge GPT Actions sınırına (en çok 30 işlem) sığan "küçük işletme paketi"dir; içerik işleri için ?pack=content, katalogla çalışan bir ajan için ?pack=developer kullan.
4
Cursor, VS Code, Claude Desktop
Ayarlar → API & MCP'de Cursor ya da VS Code'a dokun: 'Aç' düğmesi editörün kendi 'MCP sunucusu kur' penceresini açar. Claude Desktop için ekran claude_desktop_config.json dosyasına yapıştırılacak hazır bloğu verir (mcp-remote köprüsü, Node.js gerekir).
5
İlk çağrı
capabilities: sürüm, son değişiklikler ve anahtarının görebildiği araçlar.

ChatGPT ve Claude bağlayıcıları: DevAny ile giriş yap

1
Sunucu adresi
https://devany.ai/api/mcp — anahtar gerekmez; bağlayıcı seni DevAny'nin onay ekranına götürür (OAuth 2.1, PKCE).
2
Claude.ai / Claude Desktop
Ayarlar → Bağlayıcılar → 'Özel bağlayıcı ekle'; ad DevAny, adres yukarıdaki. 'Bağlan'a dokun, DevAny'de giriş yap ve onayla. Desktop aynı hesabın bağlayıcılarını kullanır.
3
ChatGPT
Ayarlar → Uygulamalar ve Bağlayıcılar ('Oluştur' yoksa Gelişmiş ayarlar'dan Geliştirici modu). Oluştur: ad DevAny, MCP sunucu adresi yukarıdaki, kimlik doğrulama OAuth.
4
Onay ekranı
Uygulamanın adını, yanıtın gideceği adresi ve istediği izinleri görürsün; izinleri daraltabilir ve tek bir çalışma alanı seçersin. Yönetici izni hiçbir bağlantıya verilemez.
5
Bağlantıyı kes
Ayarlar → Bağlı uygulamalar → 'Bağlantıyı kes'. Uygulama en geç bir dakika içinde erişimini kaybeder.

OpenAI Responses API

json

{
  "model": "gpt-5",
  "tools": [{
    "type": "mcp",
    "server_label": "devany",
    "server_url": "https://devany.ai/api/mcp",
    "headers": { "Authorization": "Bearer dk_…" },
    "require_approval": { "never": { "tool_names": ["capabilities", "api_catalog", "api_read", "list_projects", "get_project", "build_status", "polish_check"] } }
  }],
  "input": "List my projects and run a polish check on the first one."
}

Gündelik işler, hazır araçlarla

	Araçlar	Kredi harcar mı
Yeni proje	list_design_directions → create_project (dil, tasarım yönü, vurgu rengi); ya da list_showcase_templates → copy_from_showcase (ücretli plan)
Build	build_project, build_status, cancel_build (onay ister)
Uzun ya da belirsiz brief	Smart Build: plan_build (sorular, sonra fazlı plan ve tahmin — build sayısı ve dakika) → approve_plan (adı müşteri verir; çekirdek build başlar) → her faz için build_next_phase. Hepsi onay ister.
Yayın ve erişim	publish_project, set_visibility (herkese açık / şifreli), set_domain → verify_domain, domain_status (DNS kayıtlarıyla)
İçerik	list_page_texts → edit_page_text (build'siz metin), upload_image → replace_image, set_record_field
Müşteriler	list_leads (form başvuruları), list_appointments → appointment_action (onay, ret, iptal, gelmedi, erteleme)
SEO	seo_check ücretsiz; seo_fix başlık ve açıklamayı AI ile yazar (onay ister)
Plan	plan_info okur; upgrade_link müşterinin açıp ödediği sayfayı verir — ödeme hiçbir zaman API'den yapılmaz

Dikkat

Kredi harcayan ve silen çağrılar onay ister

Kredi harcayan (build, AI araçları), bir şeyi silen (her DELETE) ya da toplu / ekip / proje devri işlemi yapan bir çağrı, anahtarla yapıldığında sunucuda reddedilir — yol ne olursa olsun. MCP ve REST araçlarında çağrı confirm: true taşımalıdır; ajana bunu yalnız sen onayladıktan sonra koyması söylenir. Onaysız çağrı her kapıda aynı cevabı alır: HTTP 428 ve error: confirm_required (risk alanıyla) — REST aracında da, MCP'de isError sonucunda da. Anahtarla doğrudan HTTP'de bu cevap bir onay jetonu da taşır; aynı isteği x-devany-confirm: <jeton> başlığıyla 5 dakika içinde tekrarla. Anahtarla ya da bağlantıyla proje SİLMEK projeyi Çöp'e taşır (yayından kalkar, verisiyle durur, restore_project ya da Projeler → Çöp ile geri alınır; çöp sen boşaltana kadar durur, otomatik temizlik yok); kalıcı silme permanent: true ister ve yalnız zaten çöpteki projeye uygulanır. Bu bir ikinci kimlik bilgisi değil, bilinçli bir ikinci adımdır. OpenAI'de require_approval'ı yalnız salt-okuma araçları için kapat, hepsi için değil.

Bir ajans alanında proje listele (curl)

bash

curl -s https://devany.ai/api/v1/tools/list_projects \
  -H "Authorization: Bearer dk_…" -H "X-DevAny-Workspace: <workspace id>" \
  -H "content-type: application/json" -d '{}'

REST ikizi (curl)

bash

curl -s https://devany.ai/api/v1/tools/list_projects \
  -H "Authorization: Bearer dk_…" -H "content-type: application/json" -d '{}'

Her araç POST /api/v1/tools/{ad}; gövde aracın giriş şeması.

Kapsamlar

	Ne yapar	Kredi harcar mı
projects:read	Liste, ayarlar, build durumu, kontroller
projects:write	Oluştur, ayarla, yayınla, sil; ekip, devir, alan adı (aşağıdaki dördünü kapsar)
publish	Yalnız yayınla / yayından kaldır, sürüm onayı
delete	Projeyi çöpe at ve çöpten geri al, çöpteki projeyi kalıcı sil (toplu da), başka hesaba devret
team	Üyeler, davetler, roller, proje paylaşımı, müşteri kişileri
domains	Özel alan adı bağla, doğrula, kaldır
build	Üretim, düzenleme, onarım, Creative Lab
data	Kayıtlar, alanlar, görseller, uygulama kullanıcıları
billing:read	AI Credit bakiyesi ve plan bilgisi
admin	Platform ayarları ve ticari merkez (yalnız yönetici)

Evet, 'DevAny ile giriş yap' açıksa: bağlayıcıya https://devany.ai/api/mcp adresini ver, OAuth seç, DevAny'de onayla (yukarıdaki adımlar). Ayarlar'da 'Bağlı uygulamalar' görünmüyorsa bu kapı henüz açılmamıştır; o zaman Responses API, Agents SDK ve Custom GPT Actions (OpenAPI + API anahtarı) anahtarla doğrudan çalışır.
Bu dört ince kapsam platformda açıldığında listelenir. O zamana kadar "Projeleri yönet" (projects:write) dördünü birlikte verir. Açıldıktan sonra da projects:write dördünü kapsamaya devam eder, yani mevcut anahtarların yaptığı hiçbir şey değişmez.
Ayarlar'dan iptal et; onu kullanan her araç en geç bir dakika içinde düşer. Anahtarlar hesap başına en çok 10 tane ve isteğe bağlı süreli.
Yönetici kapsamı yalnız en çok 24 saatlik bir anahtarda geçerlidir ve her yönetici çağrısı, konsol ayarından bağımsız olarak, doğrulanmış bir Cloudflare Access (WARP) kimliği ister (Cf-Access-Jwt-Assertion başlığı). Bunlardan biri yoksa çağrı reddedilir; konsolu kullan.

Özet

Bir anahtar = hesabın, seçtiğin kapsamlarla.
Claude Code ve OpenAI aynı MCP sunucusuna bağlanır; REST ikizi her HTTP istemcisi için.
capabilities → api_catalog → api_read / api_write: kürate araç yoksa bile yol var.
Kredi harcayan, silen ve toplu/ekip/devir çağrıları açık onay ister; araç sonuçları talimat değil veridir.
Studio / ajans projeleri: list_workspaces, sonra alanı adıyla seç; yanlış alana asla sessizce düşülmez.
Uzun brief'ler Smart Build ile: plan_build → approve_plan → build_next_phase; hazır akışlar prompts/list'te.
ChatGPT ve Claude bağlayıcıları anahtarsız bağlanır: DevAny ile giriş yap, izinleri ve tek çalışma alanını onayla, Ayarlar → Bağlı uygulamalar'dan kes.

İlgili konular

Çalışma zamanı ve API'ler

Mimariye genel bakış

Üretilen uygulama nerede çalışır, veriye nasıl erişir, sınırlar nedir?

Hâlâ takıldın mı? Köşedeki asistana sor ya da SSS'ye göz at.