API anahtarları, Craftkite API’si ve MCP

Craftkite API’si, stüdyoda yaptıklarını kendi kodunun da yapmasını sağlar: açıklamadan uygulama oluşturmak, mesaj göndermek, planları onaylamak, derlemeyi izlemek, önizlemeyi açmak, yayınlamak, kodu dışa aktarmak, güvenlik taraması yapmak ve belge oluşturmak. MCP sunucusu aynı işlemleri araç olarak sunar; böylece MCP destekleyen bir yapay zekâ asistanı Craftkite’ı senin için kullanabilir.

Anahtar oluştur

1. Hesap’ı aç ve API ve MCP bölümüne git.
2. Anahtar oluştur’a tıkla, bir Ad ver (örneğin “derleme hattı”) ve İzinler’i seç:
   • Projeleri okuma: projeleri, görevleri, önizlemeleri, yayınları ve güvenlik taramalarını listeler.
   • Oluşturma ve değiştirme: uygulama oluşturur, mesaj gönderir ve planları onaylar (kredi kullanır).
   • Yayınlama, Kodu dışa aktarma ve Belgeler.
3. Ne zaman Bitiş olacağını ve bir ekip çalışma alanının sahibi veya yöneticisiysen anahtarın kişisel projelerin mi yoksa çalışma alanının mı olacağını (Kapsam) seç.
4. Anahtarı kopyala. Yalnızca bir kez gösterilir; Craftkite yalnızca parmak izini saklar.

Bir anahtarı istediğin zaman çöp kutusu simgesiyle iptal et: onu kullanan araçlar hemen çalışmayı bırakır. API anahtarları ücretli planlarla gelir.

REST API’yi kullan

Anahtarı Authorization başlığında Bearer token olarak gönder. REST API adresi ve OpenAPI açıklaması API ve MCP altında görünür. Tipik bir akış:

1. prompt ile POST /projects uygulamayı oluşturur; yanıt ilk görevini içerir.
2. Durum awaiting_approval olana kadar GET /tasks/{id} (veya /tasks/{id}/events adresindeki canlı olaylar); görev planı ve kredi teklifini gösterir.
3. POST /tasks/{id}/approve uygulamayı oluşturur. POST /projects/{id}/preview önizleme adresini döndürür.
4. POST /projects/{id}/deployments uygulamayı yayınlar. Güvenlik taraması kritik bir sorun bulursa yanıt security-critical olur; devam etmek için confirmSecurity: true ile yeniden yayınla.

Bir yapay zekâ asistanı bağla (MCP)

MCP sunucusu adresini uzak (HTTP) sunucuları destekleyen herhangi bir MCP istemcisine ekle ve anahtarını Bearer token olarak gönder. Asistan, anahtarının izinleriyle sınırlı olarak create_project, send_message, wait_for_task, approve_plan, get_preview_url ve publish_project gibi araçları görür.

Krediler ve sınırlar

Bir anahtarın başlattığı her iş, stüdyoda olduğu gibi kredilerini ve plan sınırlarını kullanır: her derleme önce teklifini gösterir ve onayladığın tekliften fazlasına mal olmaz. Okuma, önizleme, güvenlik taraması ve dışa aktarma ücretsizdir. Anahtarların kendi istek sınırları vardır; çok fazla istek gönderdiğinde yanıt kaç saniye beklemen gerektiğini söyler.