MCP araçları başvurusu

Başarılı olduğunda, get-screen-image dışındaki her araç sonucunu iki kez döndürür: structuredContent olarak (aracın yayımlanmış çıkış şemasına göre doğrulanmış) ve aynı nesnenin bir metin bloğuna serileştirilmiş hali olarak, { type: "text", text: "<json-string>" }, yapılandırılmış içeriği okumayan istemciler için. get-screen-image yalnızca bir MCP görsel bloğu döndürür: { type: "image", data: "<base64>", mimeType: "image/png" }. Hata durumunda isError: true ayarlanır ve metin bloğu kısa bir hata mesajı içerir. Üzerinde işlem yapabileceğiniz hatalar — silmede ad uyuşmazlığı, geçersiz bir Figma bağlantısı, geçersiz tasarım yönergeleri, bir ek sorunu veya bir oluşturma zaman aşımı — neyin düzeltilmesi gerektiğini açıklar. Diğer hatalar Failed to list files gibi genel bir mesaj döndürür.

Fiyatlandırma: yapay zekâ tasarım araçları — ai-design-screens, ai-generate-screen-variant ve ai-edit-screen-variant — Flowstep uygulamasıyla aynı mesaj kotasını kullanır. Diğer tüm araçlar ücretsizdir. Bkz. Kullanım limitleri.

Her araç ayrıca, istemcinizin ne yaptığını bilmesi için MCP açıklamaları yayımlar. delete-file, delete-screen, delete-design-guidelines, replace-screen-jsx, ai-design-screens ve ai-edit-screen-variant, mevcut içeriği kaldırdıkları veya üzerine yazdıkları için yıkıcı olarak işaretlenir.

Dosya araçları

`list-files`

Flowstep dosyalarınızın meta verilerini listeleyin. İlgili bir dosyanın zaten var olup olmadığını kontrol etmek için önce bunu çağırın. Ekran içeriği döndürmez; bunun için get-screen-image veya get-screen-jsx kullanın. Giriş

Parametre	Tür	Varsayılan	Açıklama
`orderByCreation`	`boolean`	`true`	En yeniler önce, `created_at` alanına göre (`true`) veya `updated_at` alanına göre (`false`) sıralar. Son düzenlenen dosyaları bulmak için `false` kullanın
`limit`	`integer` (1–100)	`20`	Döndürülen en fazla dosya sayısı. Tam bir sayfa, daha fazla dosya olabileceği anlamına gelebilir
`offset`	`integer` (≥0)	`0`	Atlanacak dosya sayısı. Sonraki sayfa `offset + limit` değeridir

Çıktı — { files }.

{
  "files": [
    {
      "id": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0",
      "name": "Dashboard redesign",
      "created_at": "2026-04-30T15:02:13.120152+00:00",
      "updated_at": "2026-04-30T15:02:13.120152+00:00",
      "organisation_id": "0b7f3c9e-2d4a-4f1b-9a5e-6c8d7e1f2a3b",
      "shared_with_me": false,
      "owner": true,
      "url": "https://app.flowstep.ai/file?activeFileId=5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0"
    }
  ]
}

owner — dosyayı siz oluşturduysanız true.
shared_with_me — dosya yalnızca organizasyonunuz üzerinden değil, doğrudan sizinle paylaşıldıysa true.
url — dosyayı Flowstep düzenleyicisinde açar.

`get-file`

Tek bir dosyanın meta verilerini alın. Dosya içeriği bilerek dahil edilmez; ekranları incelemek için get-screen-image veya get-screen-jsx, ekli yönergeleri almak için get-design-guidelines kullanın. Dosya için bekleyen bir davetiniz varsa get-file çağırmak bu daveti kabul eder. Giriş

Parametre	Tür	Açıklama
`id`	`uuid`	Dosya kimliği

Çıktı — { file, user_access_level }.

{
  "file": {
    "id": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0",
    "name": "Dashboard redesign",
    "created_at": "2026-04-30T15:02:13.120152+00:00",
    "updated_at": "2026-04-30T15:02:13.120152+00:00",
    "project_id": "81cb84d6-c69f-492c-a895-7421b60d1a6d",
    "access_level": "private",
    "visibility": "private",
    "owner": true,
    "url": "https://app.flowstep.ai/file?activeFileId=5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0"
  },
  "user_access_level": "write"
}

access_level — private, read veya write.
visibility — private, member veya public.
user_access_level — dosyaya erişiminiz: read veya write.

`create-file`

Ekran içermeyen boş bir Flowstep dosyası oluşturun. Bir dosyayı oluşturup ekranları tek adımda üretmek için bunun yerine fileId olmadan ai-design-screens çağırın. Kod öncelikli iş akışları için create-file kullanın ve ardından add-screen-jsx çağırın. Giriş

Parametre	Tür	Açıklama
`name`	`string` (en az 1)	Yeni dosyanın görünen adı

Çıktı — get-file ile aynı biçimde { file, user_access_level }. owner her zaman true, user_access_level her zaman write olur. Sonraki araç çağrılarında döndürülen file.id değerini fileId olarak kullanın.

`update-file`

Bir dosyanın adını değiştirin. Giriş

Parametre	Tür	Açıklama
`id`	`uuid`	Dosya kimliği
`name`	`string` (en az 1)	Yeni görünen ad

Çıktı — get-file ile aynı biçimde { file, user_access_level }.

`delete-file`

Bir dosyayı kalıcı olarak silin. İlettiğiniz name değeri silmeden önce dosyanın mevcut görünen adıyla karşılaştırılır; eşleşmezse silme işlemi iptal edilir. Bu, yanlış dosyanın yanlışlıkla silinmesini önler. Ajanlara önce sizden onay almaları talimatı verilmiştir. Giriş

Parametre	Tür	Açıklama
`id`	`uuid`	Dosya kimliği
`name`	`string`	Dosyanın mevcut görünen adı — eşleşmesi gerekir, aksi halde silme iptal edilir

Çıktı — { "deleted": true }

Bu işlem geri alınamaz. Dosyadaki tüm ekranlar silinir.

Ekran araçları

`list-screens`

Bir dosyadaki ekranları tuval sırasına göre listeleyin. Bir dosyada zaten neyin olduğunu görmek için list-files çağrısından sonra bunu çağırın. Döndürülen screenId değerlerini diğer ekran araçlarında ve yapay zekâ tasarım araçlarında kullanın. Giriş

Parametre	Tür	Açıklama
`fileId`	`uuid`	Dosya kimliği

Çıktı — { screens }.

{
  "screens": [
    {
      "screenId": "3f9e6eb6-5525-4383-9375-67e0bd762dbe",
      "name": "Mobile login screen",
      "prompt": "Generate a simple mobile login screen with email and password fields and a sign in button",
      "fidelity": "ui"
    }
  ]
}

prompt — ekranın son oluşturma istemi; hiç oluşturulmamışsa boş bir dize (örneğin add-screen-jsx ile eklenen bir ekran).
fidelity — lofi, hifi veya ui.

`get-screen-image`

Bir ekranı PNG olarak oluşturun ve satır içi bir görsel olarak döndürün. Görsel içerik bloklarını destekleyen bir istemci gerektirir. Bir yapay zekâ tasarım aracı, add-screen-jsx, replace-screen-jsx veya import-figma tarafından döndürülen her screenId için bir kez çağırın. Giriş

Parametre	Tür	Açıklama
`fileId`	`uuid`	Dosya kimliği
`screenId`	`uuid`	`list-screens` veya bir tasarım aracının döndürdüğü `screenIds` dizisinden bir `screenId`

Çıktı — MCP görsel içerik bloğu (image/png). data, PNG baytlarının standart base64 kodlamasıdır; veri URI’si değildir. Bu araç için structuredContent yoktur.

`get-screen-jsx`

Bir ekranı, meta verileriyle birlikte JSX olarak alın — böylece kod tabanınızda bundan geliştirme yapabilir ya da düzenleyip replace-screen-jsx ile geri yazabilirsiniz. Bunun yerine görsel bir önizleme için get-screen-image kullanın. Giriş

Parametre	Tür	Varsayılan	Açıklama
`fileId`	`uuid`	—	Dosya kimliği
`screenId`	`uuid`	—	`list-screens` veya bir tasarım aracının döndürdüğü `screenIds` dizisinden bir `screenId`
`includeIds`	`boolean`	`false`	`jsx` içindeki öğelere `data-id` özniteliği ekler. `ai-design-screens` aracına `elementIds` olarak iletmek üzere öğe kimliklerine ihtiyacınız olduğunda kullanın; yerinde düzenleme veya görsel referans için

Çıktı — { fileId, screenId, name, prompt, fidelity, screenType, colorTheme, jsx, fragments }.

{
  "fileId": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0",
  "screenId": "c13d3707-0efe-49f5-b6cb-0ca5ac5223d0",
  "name": "World clock",
  "prompt": "A world clock screen with a city search and alert button",
  "fidelity": "ui",
  "screenType": "iphone-x-vertical",
  "colorTheme": "blue",
  "jsx": "<div className=\"bg-white text-zinc-950 w-full h-fit\">\n  <div className=\"flex p-6 flex-col gap-6\">\n    …\n  </div>\n</div>",
  "fragments": []
}

jsx — yalnızca işaretleme. data-id öznitelikleri yalnızca includeIds true olduğunda dahil edilir.
prompt — son oluşturma istemi; ekran hiç oluşturulmamışsa boş bir dize.
fragments — ekranda saklanan ortak arayüz parçaları; gezinme çubuğu, üst bilgi veya logo gibi, { purpose, markup } nesneleri olarak. Yoksa boştur. Bunları korumak veya güncellemek için replace-screen-jsx aracına geri iletin.

fidelity, screenType ve colorTheme değerleri için bkz. Ekran alanı değerleri.

`add-screen-jsx`

Yazdığınız JSX’ten bir dosyaya yeni bir ekran ekleyin. Bu kod öncelikli yoldur ve ücretsizdir; ekranı Flowstep’in yapay zekâsının tasarlamasını istediğinizde ai-design-screens kullanın. add-screen-jsx her zaman yeni bir ekran oluşturur: mevcut bir ekranın üzerine yazmak için replace-screen-jsx kullanın. Kendi yüklediğiniz bir görseli göstermek için bkz. JSX içindeki görseller. Yeni ekran mevcut bir ekrana dayanıyorsa, name, fidelity, screenType, colorTheme ve jsx için get-screen-jsx (includeIds olmadan) ile başlayın, ardından farklı olması gereken her şeyi değiştirin. Giriş

Parametre	Tür	Varsayılan	Açıklama
`fileId`	`uuid`	—	Dosya kimliği
`name`	`string` (1–100 karakter)	—	İsteğe bağlı görünen ad. `Screen N` olarak otomatik adlandırmak için atlayın
`fidelity`	`string`	`"ui"`	Ekran ayrıntı düzeyi
`screenType`	`string`	—	Zorunlu — ekranın tasarlandığı cihaz veya görünüm alanı
`colorTheme`	`string`	`"default"`	Renk teması
`jsx`	`string`	—	Yalnızca JSX işaretlemesi. Tüm `data-id` öznitelikleri yok sayılır — yeni ekran yeni öğe kimlikleri alır

Çıktı — { fileId, screenId }. Sonucu görmek için screenId ile get-screen-image çağırın.

{
  "fileId": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0",
  "screenId": "3f9e6eb6-5525-4383-9375-67e0bd762dbf"
}

`replace-screen-jsx`

Yazdığınız JSX ile mevcut bir ekranın üzerine yazın. Ekran screenId değerini ve tuvaldeki konumunu korur; iç içe öğeler yeni kimlikler alır. Bu kod öncelikli yoldur ve ücretsizdir; yapay zekâ ile değişiklik için ai-design-screens veya ai-edit-screen-variant kullanın, yeni bir ekran oluşturmak için ise add-screen-jsx kullanın. get-screen-jsx (includeIds olmadan) ile başlayın, ardından farklı olması gereken her şeyi değiştirin. Kendi yüklediğiniz bir görseli göstermek için bkz. JSX içindeki görseller. Giriş

Parametre	Tür	Açıklama
`fileId`	`uuid`	Dosya kimliği
`screenId`	`uuid`	Üzerine yazılacak ekran
`jsx`	`string`	Yalnızca JSX işaretlemesi. Tüm `data-id` öznitelikleri yok sayılır
`name`	`string` (1–100 karakter)	İsteğe bağlı. Mevcut adı korumak için atlayın
`fidelity`	`string`	İsteğe bağlı. Mevcut ayrıntı düzeyini korumak için atlayın
`screenType`	`string`	İsteğe bağlı. Mevcut ekran türünü korumak için atlayın
`colorTheme`	`string`	İsteğe bağlı. Mevcut renk temasını korumak için atlayın
`fragments`	`{ purpose, markup }[]`	İsteğe bağlı ortak arayüz parçaları, `get-screen-jsx` çıktısından. Mevcut parçaları korumak için atlayın veya bunları temizlemek için `[]` iletin

Çıktı — { fileId, screenId }. Sonucu görmek için screenId ile get-screen-image çağırın.

Bu, ekranın içeriğini yerinde değiştirir.

`rename-screen`

Bir ekranın tuval etiketini yeniden adlandırın — list-screens içinde ve düzenleyicide gösterilen ad. Bu yalnızca etiketi değiştirir; ekranın düzenini, boyutunu veya içeriğini değiştirmez — bunlar için ai-design-screens kullanın. Giriş

Parametre	Tür	Açıklama
`fileId`	`uuid`	Dosya kimliği
`screenId`	`uuid`	`list-screens` tarafından döndürülen `screenId`
`name`	`string` (1–100 karakter)	Yeni ekran adı. Baştaki ve sondaki boşluklar kırpılır

Çıktı — { screenId, name }.

{ "screenId": "3f9e6eb6-5525-4383-9375-67e0bd762dbe", "name": "Checkout — empty cart" }

`delete-screen`

Bir dosyadan bir ekranı kalıcı olarak silin. İlettiğiniz name değeri ekranın mevcut görünen adıyla karşılaştırılır; eşleşmezse silme iptal edilir. Ajanlara önce sizden onay almaları talimatı verilmiştir. Giriş

Parametre	Tür	Açıklama
`fileId`	`uuid`	Dosya kimliği
`screenId`	`uuid`	Silinecek ekran
`name`	`string`	Ekranın mevcut görünen adı — eşleşmesi gerekir, aksi halde silme iptal edilir

Çıktı — { "deleted": true }

JSX içindeki görseller

add-screen-jsx ve replace-screen-jsx, bir img src içinde ya da className içinde bg-[url(...)] ile arka plan olarak görselleri kabul eder. alt metni yazın ve her görseli amacına göre boyutlandırın. Kendi görselinizi yerleştirmek için:

Görseli upload-attachment ile A modunda (mimeType + fileName) yükleyin ve döndürülen uploadCommand komutunu çalıştırın.
Yanıtın type değeri "image" ise assetUrl değerini döndürüldüğü gibi, aynen img src içine ya da bg-[url(assetUrl)] içine yapıştırın.

Diğer tüm görsel URL’lerini get-screen-jsx’in döndürdüğü gibi bırakın. path, signedUrl veya uploadCommand değerlerini asla src içine koymayın.

<img src="ASSET_URL" alt="Team photo" className="w-full h-48 object-cover rounded-lg" />

Ekran alanı değerleri

get-screen-jsx bu değerleri döndürür; add-screen-jsx ve replace-screen-jsx bu değerleri kabul eder:

Alan	Değerler
`fidelity`	`lofi`, `hifi`, `ui`
`screenType`	`web`, `desktop`, `desktop-large`, `desktop-medium`, `desktop-small`, `tablet`, `ipad-tablet-horizontal`, `ipad-tablet-vertical`, `android-tablet-horizontal`, `android-tablet-vertical`, `mobile_ios`, `mobile_android`, `iphone-vertical`, `iphone-horizontal`, `iphone-x-vertical`, `iphone-x-horizontal`, `android-vertical`, `android-horizontal`, `android-small-vertical`, `android-small-horizontal`
`colorTheme`	`default`, `defaultDark`, `blue`, `blueDark`, `ice`, `iceDark`, `grayscale`, `grayscaleDark`, `green`, `greenDark`, `orange`, `orangeDark`, `red`, `redDark`, `rose`, `roseDark`, `violet`, `violetDark`, `yellow`, `yellowDark`

Tasarım yönergeleri araçları

Tasarım yönergeleri, bir dosyada saklanan DESIGN.md metnidir. Ayarlandığında, o dosya için yapılan her yapay zekâ üretimine eklenir. Bkz. Tasarım yönergeleri.

`get-design-guidelines`

Bir dosyaya ekli tasarım yönergelerini alın. Giriş

Parametre	Tür	Açıklama
`fileId`	`uuid`	Dosya kimliği

Çıktı — { guidelines }.

{
  "guidelines": "## Colors\n\nPrimary: #6366F1\nBackground: #FFFFFF\n\n## Typography\n\nFont: Inter"
}

Hiç yönerge ayarlanmadıysa guidelines değeri null olur.

`update-design-guidelines`

Bir dosya için tasarım yönergelerini ayarlayın veya değiştirin. Yönergeleri Google’ın DESIGN.md biçiminde düz bir dize olarak iletin — nesne veya JSON olarak değil. Bir dosyadan okuyorsanız, o dosyanın metnini iletin. Giriş

Parametre	Tür	Açıklama
`fileId`	`uuid`	Dosya kimliği
`designGuidelines`	`string` (en az 1)	Yönergelerin ham metni. Düz bir dize olmalı — JSON ile kodlanmamış

Doğrulama kuralları

Frontmatter doğru şekilde açılmalı ve kapatılmalıdır
Frontmatter satırları geçerli blok biçimli YAML olmalıdır
Markdown gövdesi yinelenen ## bölüm başlıklarını içermemelidir

Doğrulama başarısız olursa çağrı Invalid design guidelines: ile başlayan bir hata döndürür. Çıktı — { updated, warnings? }.

{ "updated": true, "warnings": ["…"] }

warnings, kabul edilmiş ancak yapay zekâ tarafından yok sayılabilecek yumuşak doğrulama sorunlarını (bilinmeyen anahtarlar, onaltılık biçimde olmayan renkler) listeler. Hiç yoksa dahil edilmez. Bunları kullanıcıya bildirin.

`delete-design-guidelines`

Bir dosyanın tasarım yönergelerini temizleyin. Var olmayan yönergeleri silmek bir işlem yapmaz. Giriş

Parametre	Tür	Açıklama
`fileId`	`uuid`	Dosya kimliği

Çıktı — { "deleted": true }

Sohbet araçları

`get-chat-history`

Bir dosyayla ilişkili tasarım konuşmasını alın — MCP istemcinizin konuşmasını değil, dosyanın Flowstep sohbetini. Dosyadaki önceki çalışmalara devam etmek için kullanın. Giriş

Parametre	Tür	Açıklama
`fileId`	`uuid`	Dosya kimliği

Çıktı — { messages }. Dosyada bir tasarım konuşmanız yoksa messages boştur. Her mesajın bir type ("request" veya "response"), bir author ("human" veya "ai") ve bir content_type değeri vardır. Yanıt mesajları "text", "summary" veya "followup" kullanır.

{
  "messages": [
    {
      "id": "453f593d-2380-425b-ba29-127db08d6a8e",
      "type": "request",
      "status": "success",
      "content": "Generate a simple mobile login screen with email and password fields",
      "author": "human",
      "content_type": "text",
      "sequence": 1,
      "targets": [],
      "attachments": []
    },
    {
      "id": "d860186b-82d5-4bd1-8e8e-8ba5377a14bf",
      "type": "response",
      "status": "success",
      "content": "Generated a mobile login screen with email and password input fields, a sign in button, and a sign up link.",
      "author": "ai",
      "content_type": "summary",
      "sequence": 7,
      "request_message_id": "453f593d-2380-425b-ba29-127db08d6a8e",
      "targets": [{ "target_id": "3f9e6eb6-5525-4383-9375-67e0bd762dbe" }]
    }
  ]
}

Ek araçları

`upload-attachment`

ai-design-screens içinde ek olarak kullanmak üzere bir referans dosyası ya da add-screen-jsx veya replace-screen-jsx ile kendi JSX’inize yerleştirmek için bir görsel yükleyin. ai-generate-screen-variant ve ai-edit-screen-variant ek kabul etmez. Dosya baytları modelden hiç geçmez ve sunucu sizin adınıza URL’leri asla getirmez. Bir web sayfasına başvurmak için bunun yerine URL’sini ai-design-screens aracının message alanına ekleyin. İki mod vardır — birini kullanın, ikisini birleştirmeyin. A modu — dosyalar ve görseller (mimeType + fileName) Herhangi bir görsel, PDF veya daha büyük bir metin dosyası için gereken üç adımlı akış:

Yalnızca mimeType ve fileName ile upload-attachment çağırın (örneğin image/png ve dog.png). Yanıt, saklanmış bir dosya değil, hazırlanmış bir yüklemedir:

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "path": "attachments/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "assetUrl": "https://…",
  "type": "image",
  "mimeType": "image/png",
  "signedUrl": "https://…",
  "uploadCommand": "curl -sS -f -X PUT '…' -H 'Content-Type: image/png' -H 'x-metadata: …' --data-binary @LOCAL_FILE_PATH",
  "nextStep": "…"
}

uploadCommand içindeki LOCAL_FILE_PATH değerini dosyanızın mutlak yoluyla değiştirin ve bu komutu tam olarak kabuğunuzda çalıştırın — çıkış kodu 0 olmalıdır. signedUrl içindeki belirteç yalnızca bu tek yüklemeye yetki verir. Bu adımı atlamak depolamayı boş bırakır ve tasarım aracı ön kontrolünde başarısız olur.
Yalnızca { id, path, type } değerlerini ai-design-screens aracının attachments dizisine iletin — signedUrl, uploadCommand veya nextStep değerlerini değil. Bunun yerine görseli kendi JSX’inize yerleştirmek için assetUrl değerini, add-screen-jsx veya replace-screen-jsx aracına ilettiğiniz JSX içindeki img src veya bg-[url(...)] içine koyun. Bkz. JSX içindeki görseller.

Uzak bir dosyayı eklemek için önce onu kendiniz yerel bir yola indirin (örneğin curl ile), ardından aynı üç adımı izleyin. upload-attachment aracına asla URL iletmeyin.

Parametre	Tür	Açıklama
`mimeType`	enum	Dosya MIME türü. Şunlardan biri: `image/jpeg`, `image/png`, `image/webp`, `application/pdf`, `text/markdown`, `text/plain`, `text/javascript`. `.jsx`, `.tsx`, `.js`, `.ts` dosyaları için `text/javascript` kullanın
`fileName`	`string` (en az 1)	Uzantısı dahil orijinal dosya adı, örneğin `cat.png` veya `design.md`

B modu — kısa metin (text + mimeType) Zaten bağlamda olan metni yükleyin — kabuk komutu gerekmez. Yanıt doğrudan kullanıma hazırdır:

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "path": "attachments/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "assetUrl": "https://…",
  "type": "document",
  "mimeType": "text/plain"
}

Parametre	Tür	Açıklama
`text`	`string` (en fazla 64.000 karakter)	Ham metin içeriği. Yalnızca metin dosyaları için — görseller veya PDF’ler için kullanmayın. 64.000 karakterden uzun mu? Bunun yerine A modunu kullanın
`mimeType`	enum	`text/markdown`, `text/plain`, `text/javascript` değerlerinden biri

Ortaya çıkan { id, path, type } değerini ai-design-screens aracının attachments dizisine iletin. Her iki modda da en fazla dosya boyutu 3 MB’dır ve PDF’ler en fazla 100 sayfa olabilir. Çıktı — { id, path, assetUrl, type, mimeType, signedUrl?, uploadCommand?, nextStep? }.

type — görsel dosyalar için "image", PDF’ler ve metin dosyaları için "document".
assetUrl — iki modda da döndürülen, yüklenen dosyanın URL’si. Yalnızca type "image" olduğunda ve yalnızca A modundaki uploadCommand çalıştırıldıktan sonra add-screen-jsx veya replace-screen-jsx için JSX içinde kullanın.
signedUrl, uploadCommand, nextStep — yalnızca A modunda ayarlanır. Bunları tasarım araçlarına iletmeyin.

Figma araçları

`import-figma`

Bir Figma çerçevesini bir Flowstep dosyasına, tuvalinde düzenlenebilir öğeler olarak aktarın. Her aktarma yeni bir ekran ekler — aynı çerçeveyi iki kez aktarmak size iki ekran verir; bu yüzden onu değiştirmek istediyseniz eski ekranı delete-screen ile silin. Dosyanın bağlı olduğu organizasyonda, Flowstep ayarlarında Figma’nın bağlı olması gerekir. Giriş

Parametre	Tür	Açıklama
`fileId`	`uuid`	Çerçevenin aktarılacağı Flowstep dosyası. Bu, `figmaUrl` içindeki Figma dosya anahtarı değildir
`figmaUrl`	`string`	`node-id` içeren belirli bir Figma çerçevesinin bağlantısı. Figma’da çerçeveye sağ tıklayıp Copy/Paste as → Copy link to selection seçeneğini seçin. Bir sayfanın bağlantısı, o sayfadaki tüm üst düzey çerçeveleri aktarır (MCP üzerinden en fazla 20 çerçeve)

Çıktı — { fileId, screenId, frameCount? }. screenId, aktarılan ekrandır — sonucu görmek için bunu get-screen-image aracına iletin. Bir sayfa URL’si birden fazla çerçeve aktardığında screenId null olur ve bunun yerine frameCount döndürülür; list-screens çağırın, ardından her yeni ekran için get-screen-image çağırın.

{
  "fileId": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0",
  "screenId": "3f9e6eb6-5525-4383-9375-67e0bd762dbe"
}

Plan ve faturalandırma araçları

`get-plan-details`

Organizasyonunuzun Flowstep planını, abonelik durumunu, kullanımını ve kalan kotasını alın. Giriş almaz — organizasyon, oturum açmış kullanıcıdan belirlenir. Yapay zekâ tasarım araçlarını çağırmadan önce kotanızı kontrol etmek için kullanın. Çıktı — { plan, subscription, limits, usage, remaining }.

Alan	Açıklama
`plan`	`{ name, code, type }`. `type` değeri `"free"` veya `"paid"` olur
`subscription`	`{ isPaid, isTrial, startDate, endDate, trialDaysRemaining }`
`limits`	Özellik bazında limitler, özellik adına göre anahtarlanmış (örneğin `messages`). Her biri isteğe bağlı `daily` ve `monthly` nesnelerine sahiptir; bunlar `max` ve `warn` değerlerini içerir, ayrıca bir `unlimited` bayrağı vardır
`usage`	Özellik bazında şimdiye kadarki kullanım, `{ daily, monthly }` olarak
`remaining`	Özellik bazında kalan kota, `{ daily, monthly }` olarak. Sınırsız özellikler için atlanır

Limitler plana göre değişir — bkz. Fiyatlandırma ve Kullanım limitleri.

Yapay zekâ tasarım araçları

Bu üç araç bir açıklamadan veya hazır ayardan tasarım yapar — hiçbir zaman JSX almaz veya yeniden kullanmaz. Her çağrı, Flowstep uygulamasıyla aynı mesaj kotasını kullanır ve oluşturma tamamlanana veya zaman aşımına uğrayana (180 saniye) kadar bekler.

Araç	Kullanım amacı
`ai-design-screens`	Serbest biçimli bir açıklamadan yeni ekranlar oluşturun, mevcut ekranları yerinde değiştirin ya da ikisini birden yapın
`ai-generate-screen-variant`	Mevcut tek bir ekranın sonraki adımını, hata veya boş durumunu ya da platform varyantını ekleyin
`ai-edit-screen-variant`	Mevcut tek bir bütün ekrana düzenleme veya yeniden tasarım hazır ayarı uygulayın

Üçü de { status, fileId, screenIds, designGuidelinesUpdated } döndürür. Sonucu görmek için her screenId için bir kez get-screen-image çağırın.

designGuidelinesUpdated — bu tur sırasında dosyanın DESIGN.md yönergeleri otomatik olarak güncellendiyse değişikliğin kısa bir özeti; aksi halde null.

`ai-design-screens`

Metin açıklamasından tek bir çağrıda bir veya daha fazla yeni ekran oluşturun, mevcut ekranları yerinde değiştirin ya da ikisini birden yapın — yeni akışlar, tema, metin, düzen veya birden fazla ekranda koordineli değişiklikler. Bu, Flowstep düzenleyicisindeki sohbetle aynı tasarım ajanıdır: neyin oluşturulacağına ve neyin değiştirileceğine message ve elementIds değerlerinize bakarak karar verir. Yeni bir dosya başlatmak için fileId değerini atlayın; mevcut bir dosyada çalışmak için fileId iletin. İstek zaten sahip olduğunuz bir dosyaya uygulanabilecekse ajanınız önce list-files ve list-screens çağrılarını kontrol etmelidir. Bir ekranın sonraki adımı, hata veya boş durumu ya da platform varyantı için ai-generate-screen-variant kullanın. Tek bir ekranın hazır ayar düzenlemesi veya yeniden tasarımı için ai-edit-screen-variant kullanın. Zaten JSX’iniz varsa bunun yerine add-screen-jsx veya replace-screen-jsx kullanın. Giriş

Parametre	Tür	Varsayılan	Açıklama
`fileId`	`uuid`	—	Hedef dosya. Yeni bir dosya oluşturmak için atlayın. `elementIds` ayarlandığında zorunludur
`message`	`string`	—	Oluşturulacak ekranların ve/veya yapılacak değişikliklerin açıklaması. `elementIds` ilettiğinizde, bunları düzenlemek mi yoksa referans olarak mı kullanmak istediğinizi belirtin. Flowstep’in başvurmasını istediğiniz web sayfası URL’lerini buraya ekleyin
`elementIds`	`uuid[]`	`[]`	İsteğe bağlı: `list-screens` içinden `screenId`’ler ve/veya `get-screen-jsx` (`includeIds` ile) içinden öğe `data-id`’leri; düzenleyicideki bir seçim gibi. Yerinde düzenlenebilir ya da yeni ekranlar için görsel referans olarak kullanılabilir. Bir `screenId` tüm ekranı hedefler
`attachments`	`{ id, path, type }[]` (en fazla 5)	`[]`	`upload-attachment` aracından dosyalar — görseller, PDF’ler veya kod ve metin dosyaları. Dosya içeriğini mesaja satır içi eklemeyin

Örnek — tek bir çağrıda bir ekranı düzenleyin ve bir tane daha ekleyin:

{
  "fileId": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0",
  "message": "Switch this sign-in screen to dark mode, then add a matching forgot-password screen.",
  "elementIds": ["3f9e6eb6-5525-4383-9375-67e0bd762dbe"]
}

Çıktı — { status, fileId, screenIds, designGuidelinesUpdated, reply? }.

{
  "status": "generated",
  "fileId": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0",
  "screenIds": [
    "3f9e6eb6-5525-4383-9375-67e0bd762dbe",
    "c13d3707-0efe-49f5-b6cb-0ca5ac5223d0"
  ],
  "designGuidelinesUpdated": null
}

status — ekranlar oluşturulduğunda veya değiştirildiğinde "generated". Flowstep, bir şey oluşturmadan yanıt verdiğinde "chat" döner; bu durumda yanıt reply içinde gelir ve screenIds boş olur. Talebiniz belirsizse ajanınız açıklama istemeli ve aracı yeniden çağırmalıdır.
screenIds — çağrı sırasında oluşturulan veya değiştirilen her ekran; yerinde düzenlenen ekranlar dahil. Çağrı bazı ekranlar oluşturulduktan sonra zaman aşımına uğrarsa hata yerine bu ekranları döndürür.

Düzenlemesini istediğiniz ekranların üzerine yerinde yazılır.

`ai-generate-screen-variant`

Tam olarak bir mevcut ekrandan türetilmiş yeni bir ekran ekleyin — akıştaki sonraki adım, bir hata veya boş durum ya da başka bir platform için bir sürüm. Özgün ekran değiştirilmez. Mevcut bir ekranın varyantı olmayan bir ekran eklemek için (örneğin bir ayarlar ekranı), fileId ile ai-design-screens kullanın. Giriş

Parametre	Tür	Açıklama
`fileId`	`uuid`	Hedef dosya
`screenId`	`uuid`	Türetilecek mevcut ekran
`operationVariant`	enum	Zorunlu — yeni ekranın mevcut olanla ilişkisi

`operationVariant`	Ekler
`next_screen`	Kullanıcı akışındaki sonraki ekran
`error_state`	Ekranın bir hata durumu
`empty_state`	Ekranın bir boş durumu
`web_version`	Bir web sürümü
`mobile_version`	Bir mobil sürüm
`tablet_version`	Bir tablet sürümü
`mobile_ios_version`	Bir iOS sürümü
`mobile_android_version`	Bir Android sürümü

Çıktı — { status, fileId, screenIds, designGuidelinesUpdated }. status her zaman "generated" olur.

`ai-edit-screen-variant`

Bir hazır ayar kullanarak tam olarak bir mevcut ekranı yerinde değiştirin — temasını veya görünümünü iyileştirin, farklı bir düzen ya da görsel stil deneyin ya da sıfırdan yeniden tasarlayın. Serbest biçimli talimatlar veya tek tek öğelerde hassas düzenleme için ai-design-screens kullanın. Giriş

Parametre	Tür	Açıklama
`fileId`	`uuid`	Hedef dosya
`screenId`	`uuid`	Değiştirilecek mevcut ekran
`operationVariant`	enum	Zorunlu — uygulanacak düzenleme veya yeniden tasarım hazır ayarı

`operationVariant`	Tür	Etki
`dark_theme`	Düzenleme	Ekranı koyu temaya geçirir
`light_theme`	Düzenleme	Ekranı açık temaya geçirir
`make_pretty`	Düzenleme	Ekranın görsel tasarımını iyileştirir
`different_layout`	Yeniden tasarım	Farklı bir düzen dener
`different_style`	Yeniden tasarım	Farklı bir görsel stil dener
`from_scratch`	Yeniden tasarım	Ekranı sıfırdan yeniden tasarlar

Çıktı — { status, fileId, screenIds, designGuidelinesUpdated }. status her zaman "generated" olur.

Bu, ekranın içeriğinin yerine yazar.

Yeniden adlandırılan araçlar

Araç adları Eylül 2026’da değişti. Eski adları kullanan istemleriniz, betikleriniz veya ajan talimatlarınız varsa bunları güncelleyin:

Eski ad	Yeni ad
`get-screen`	`get-screen-jsx`
`add-screen`	`add-screen-jsx`
`replace-screen`	`replace-screen-jsx`
`ai-generate-screens`	`ai-design-screens`
`ai-edit-screens`	`ai-design-screens`
`create-new-design`	`ai-design-screens`
`edit-design` (serbest biçimli talimatlar)	`ai-design-screens`
`edit-design` (`operationVariant` hazır ayarıyla)	`ai-edit-screen-variant`
`regenerate-design`	`ai-edit-screen-variant`
`expand-design`	`ai-generate-screen-variant`

Girdiler de değişti: yapay zekâ tasarım araçları targets yerine elementIds (ya da varyant araçları için tek bir screenId) alır; add-screen-jsx, meta veri yorumu olan jsxContent yerine jsx ve açık meta veri alanları alır; create-file, title yerine name alır; tasarım yönergeleri araçları ise resourceId ve linkedTo yerine fileId alır.

​Dosya araçları

​list-files

​get-file

​create-file

​update-file

​delete-file

​Ekran araçları

​list-screens

​get-screen-image

​get-screen-jsx

​add-screen-jsx

​replace-screen-jsx

​rename-screen

​delete-screen

​JSX içindeki görseller

​Ekran alanı değerleri

​Tasarım yönergeleri araçları

​get-design-guidelines

​update-design-guidelines

​delete-design-guidelines

​Sohbet araçları

​get-chat-history

​Ek araçları

​upload-attachment

​Figma araçları

​import-figma

​Plan ve faturalandırma araçları

​get-plan-details

​Yapay zekâ tasarım araçları

​ai-design-screens

​ai-generate-screen-variant

​ai-edit-screen-variant

​Yeniden adlandırılan araçlar

Dosya araçları

`list-files`

`get-file`

`create-file`

`update-file`

`delete-file`

Ekran araçları

`list-screens`

`get-screen-image`

`get-screen-jsx`

`add-screen-jsx`

`replace-screen-jsx`

`rename-screen`

`delete-screen`

JSX içindeki görseller

Ekran alanı değerleri

Tasarım yönergeleri araçları

`get-design-guidelines`

`update-design-guidelines`

`delete-design-guidelines`

Sohbet araçları

`get-chat-history`

Ek araçları

`upload-attachment`

Figma araçları

`import-figma`

Plan ve faturalandırma araçları

`get-plan-details`

Yapay zekâ tasarım araçları

`ai-design-screens`

`ai-generate-screen-variant`

`ai-edit-screen-variant`

Yeniden adlandırılan araçlar