Skip to main content
Kaikki työkalut palauttavat 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.
Käytä palautettua 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"
Tämä on peruuttamaton. Kaikki tiedoston näytöt poistetaan.

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

regenerate-design, expand-design ja edit-design vaativat suunnittelun kontekstia, joka on olemassa vain näytöissä, jotka alun perin luotiin designs-matriisilla. Näytöt, jotka on luotu ilman suunnittelun kontekstia, palauttavat virheen.

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:
  1. Kutsu upload-attachment vain mimeType ja fileName (esim. image/png ja dog.png). Vastaus on valmisteilla oleva lataus, ei tallennettu tiedosto:
  2. Korvaa LOCAL_FILE_PATH uploadCommand -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.
  3. Välitä vain { id, path, type } suunnittelun työkalun attachments-matriisiin — ei signedUrl, uploadCommand tai nextStep.
Etäisen tiedoston liittämiseksi lataa se paikalliselle polulle itse ensin (esim. 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
Tuloste — "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.


Laskutustyökalut

get-plan-details

Hanki nykyisen käyttäjän paketti, tilauksen tila ja jäljellä oleva kiintiö. Ei ota syötettä. Tuloste
Rajat vaihtelevat paketin mukaan. Kutsu tämä työkalu ennen sukupolvien erää tarkistaaksesi saatavilla oleva kiintiö.