content-matriisin MCP-sisältölohkoista. Teksti-työkalut palauttavat { type: "text", text: "<json-string>" }. Kuvat-työkalut palauttavat { type: "image", data: "<base64>", mimeType: "image/png" }. Virheessä isError: true asetetaan ja tekstilohko sisältää virheilmoituksen.
Tiedoston työkalut
list-files
Luettele Flowstepin tiedostot nykyiselle käyttäjälle.
Syöte
Tuloste — JSON-matriisi tiedostoobjekteista.
get-file
Hanki yksittäinen tiedosto tunnuksella. Tiedoston sisältö jätetään tarkoituksella pois — käytä get-screen tai get-screen-image näyttöjen tarkastukseen ja get-design-guidelines liitettyjen ohjeiden hakemiseen.
Syöte
Tuloste — JSON-tiedostoobjekti.
create-file
Luo uusi Flowstepin tiedosto.
Syöte
Tuloste — JSON-tiedostoobjekti uuden tiedoston
id -tunnuksella.
id -tunnusta fileId -parametrina seuraavissa työkalujen kutsuissa.
update-file
Nimeä tiedosto uudelleen.
Syöte
Tuloste — Päivitetty tiedostoobjekti samassa muodossa kuin
get-file.
delete-file
Poista tiedosto pysyvästi. name -parametri, jonka välität, tarkistetaan tiedoston todellista nimeä vastaan ennen poistamista — jos se ei täsmää, poistaminen peruutetaan. Tämä estää väärän tiedoston poistamisen vahingossa.
Syöte
Tuloste —
"File deleted successfully"
Näytön työkalut
list-screens
Luettele kaikki luodut näytöt tiedostolle. Käytä palautettuja screenId -arvoja näyttöihin viitattaessa get-screen -käskyssä, get-screen-image -käskyssä ja kohteina edit-design -käskyssä, regenerate-design -käskyssä tai expand-design -käskyssä.
Syöte
Tuloste — JSON-matriisi näytön yhteenvedoista.
name on käyttäjän määrittämä näytön nimi, tai null, jos nimetön.
get-screen
Hanki näytön JSX-koodi, jonka avulla voit muokata tai käyttää koodia Flowstepin ulkopuolella. Käytä get-screen-image -komentoa visuaalisen esikatselun saamiseksi.
Syöte
Tuloste — Näyttö koodina (JSX). Huomaa ensimmäisen rivin kommentti, joka vaaditaan
add-screen -työkalun käytössä.
add-screen
Lisää uusi näyttö Flowstepin tiedostoon raaasta JSX-merkkijonosta.
Syöte
Merkintä - Kommentti kuten alla on oltava JSX:n ensimmäisellä rivillä, koska sitä käytetään näytön lisäämiseen oikein.
screenType, name ja screenId ovat kaikki valinnaisia — screenId käytetään (sisäisesti), jos se on olemassa (esim. kun välität JSX:ää kopioituna get-screen -tuotoksesta), mutta ei ole pakollinen. Näytön nimi otetaan kommentin name -kentästä (näytetään muodossa “Copy of <name>”), tai “Untitled” (Nimetön), jos se puuttuu.
<!-- screenType: "iphone-x-vertical" width: "375" height: "812" name: "Change to a light theme" colorTheme: "blue" -->
Tuloste — Äskettäin lisätyn näytön tunnus.
get-screen-image
Renderöi näyttö PNG-kuvaksi ja palauta se sisäisenä kuvana. Vaatii asiakasta, joka tukee kuvan sisältölohkoja.
Syöte
Tuloste — MCP-kuvasisältölohko (
image/png).
rename-screen
Nimeä näytön kanvaslihake uudelleen — list-screens -näyttöjen näyttämä nimi ja editorissa. Tämä muuttaa vain etikettiä, ei näytön asettelua, kokoa tai sisältöä — käytä edit-design -komentoa näihin.
Syöte
Tuloste —
{ screenId, name }.
Tekoäly-työkalut
create-new-design
Luo yksi tai useampi näytön suunnitelma tekstikehotteesta. Jätä fileId pois luodaksesi uuden tiedoston automaattisesti. Estää, kunnes sukupolvi valmistuu tai aikakatkaisu tapahtuu (180 sekuntia).
Syöte
Tuloste —
{ fileId, screenIds, designGuidelinesUpdated }. Välitä kukin screenId get-screen-image -komentoon tulosten näkemiseksi. designGuidelinesUpdated ilmoittaa, muutettiinko tiedoston suunnitteluohjeet osana tätä sukupolvea.
regenerate-design
Tee olemassa olevia näyttöjä alusta uudelleen tai tyylillä muunnelmalla. Vaatii vähintään yhden screenId -tunnuksen targets -kohdassa. Estää, kunnes sukupolvi valmistuu tai aikakatkaisu tapahtuu (180 sekuntia).
Syöte
Tuloste —
{ fileId, screenIds, designGuidelinesUpdated }. Välitä kukin screenId get-screen-image -komentoon tulosten näkemiseksi.
expand-design
Lisää jatkosnäyttöjä olemassa olevaan suunnitelmaan. Vaatii vähintään yhden screenId -tunnuksen targets -kohdassa ja pakollisen operationVariant. Estää, kunnes sukupolvi valmistuu tai aikakatkaisu tapahtuu (180 sekuntia).
Syöte
Tuloste —
{ fileId, screenIds, designGuidelinesUpdated }. Välitä kukin screenId get-screen-image -komentoon tulosten näkemiseksi.
edit-design
Muokkaa olemassa olevia näyttöjä kehotuksella. Vaatii vähintään yhden screenId -tunnuksen targets -kohdassa. Estää, kunnes sukupolvi valmistuu tai aikakatkaisu tapahtuu (180 sekuntia).
Syöte
Tuloste —
{ fileId, screenIds, designGuidelinesUpdated }. Välitä kukin screenId get-screen-image -komentoon tulosten näkemiseksi.
upload-attachment
Lataa tiedosto käytettäväksi liitteenä create-new-design tai edit-design -komentossa (ei regenerate-design tai expand-design). Tiedoston tavut eivät koskaan kulje mallin läpi, ja palvelin ei koskaan nouda URL-osoitteita puolestasi.
On kaksi tilaa — käytä täsmälleen yhtä, äläkä yhdistä niitä.
Tila A — tiedostot ja kuvat (mimeType + fileName)
Pakollinen kolmivaiheinen työnkulku mille tahansa kuvalle, PDF:lle tai suuremmalle tekstitiedostolle:
-
Kutsu
upload-attachmentvainmimeTypejafileName(esim.image/pngjadog.png). Vastaus on valmisteilla oleva lataus, ei tallennettu tiedosto: -
Korvaa
LOCAL_FILE_PATHuploadCommand-kohdassa tiedostoosi absoluuttisella polulla ja suorita tuo tarkka komento kuoressa — sen on oltava poistumisstatus 0.signedUrl-tunnuksen kaikki oikeudet ovat vain tähän yhteen lataukseen. Tämän vaiheen ohittaminen jättää varaston tyhjäksi ja suunnittelun työkalu epäonnistuu esitarkastuksessa. -
Välitä vain
{ id, path, type }suunnittelun työkalunattachments-matriisiin — eisignedUrl,uploadCommandtainextStep.
curl -komentoa käyttäen), sitten seuraa samoja kolmea vaihetta. Älä koskaan välitä URL-osoitetta upload-attachment -komentoon.
Tila B — lyhyt teksti (
text + mimeType)
Lataa teksti, joka on jo kontekstissa — kuorikäskystä ei tarvita. Vastaus on valmis käytettäväksi suoraan:
Välitä tuloksena oleva
{ id, path, type } create-new-design tai edit-design -komentoon attachments -matriisiin.
Enimmäistiedoston koko on 3 MB molempiin tiloihin nähden, ja PDF:t on rajoitettu 100 sivuun. type on "image" kuvatiedostoille ja "document" PDF:ille ja tekstitiedostoille.
Chat-työkalut
get-chat-history
Hanki tiedoston chat-viestihistoria.
Syöte
Tuloste — JSON-objekti, jossa on
messages-matriisi. Jokaisella viestillä on type ("request" tai "response"), author ("human" tai "ai"), ja content_type ("text", "summary" tai "followup").
Suunnittelun työkalut
get-design-guidelines
Hanki tiedostolle tallennetut suunnittelun ohjeet.
Syöte
Tuloste
guidelines on null, jos ohjeita ei ole asetettu.
update-design-guidelines
Aseta tai korvaa suunnittelun ohjeet tiedostolle. Ohjeet välitetään pelkkänä teksti merkkijonona Googlen design.md -muodossa — älä välitä objektia tai JSON-tiedostoa.
Palvelin suorittaa pehmeän validoinnin ja voi palauttaa Warnings: -osion vastauksessa, jossa luetellaan ongelmat (tuntemattuja avaimia, ei-heksadesimaalivärejä), jotka hyväksyttiin mutta jotka tekoäly voi jättää huomiotta. Pinta näitä käyttäjälle.
Syöte
Validointisäännöt
- Etusivu on avattava ja suljettava oikein
- Etusivun rivit on oltava kelvollista block-tyylisen YAML:n
- Markdownin runkoosa ei saa sisältää kaksoisia
##-osion otsikoita
"Design guidelines updated successfully", valinnaisesti seuraa Warnings: -osio.
delete-design-guidelines
Poista suunnittelun ohjeet tiedostolle.
Syöte
Tuloste —
"Design guidelines deleted successfully"
Figma-työkalut
import-figma
Tuo Figman kehys Flowstepin tiedostoon muokattaviksi elementeiksi sen kanvaalle. Saman kehyksen uudelleentuominen päivittää sen paikalla. Organisaatiolla on oltava Figma yhdistetty Flowstepin asetuksissa.
Syöte
Tuloste —
{ fileId, screenId }. screenId on tuodun näyttöelementin tunnus — välitä se get-screen-image -komentoon tuloksen näkemiseksi. Kun sivun URL-osoite tuottaa useita kehyksiä, screenId on null ja frameCount palautetaan sen sijaan.