> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowstep.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP-exempel

> Arbetsflöden från början till slut för vanliga Flowstep MCP-uppgifter.

## 1. Generera och förhandsgranska en skärm

Det vanligaste arbetsflödet: generera en skärm (filen skapas i samma steg) och visa sedan resultatet.

```
1. list-files         {}
                      → { "files": [ ... ] }          // check for an existing file first

2. ai-design-screens  { "message": "Mobile sign-in screen for a developer tool.
                                    Email/password fields, Google SSO button, dark theme." }
                      → { "status": "generated", "fileId": "FILE_ID", "screenIds": ["SCREEN_ID"] }

3. get-screen-image   { "fileId": "FILE_ID", "screenId": "SCREEN_ID" }
                      → [inline PNG]
```

Om du utelämnar `fileId` skapas en ny fil automatiskt. Skicka med ett befintligt `fileId` för att i stället lägga till skärmar i den filen.

**Prompt till din AI-assistent:**

> Generera en Flowstep-design: en mobil inloggningsskärm för ett utvecklarverktyg med e-post/lösenord och en Google SSO-knapp i mörkt tema, och visa mig sedan bilden.

***

## 2. Visualisera en React-komponent

Ladda upp en `.jsx`- eller `.tsx`-fil som bilaga och be Flowstep generera en matchande design. Flowstep läser källkoden och skapar en skärm. Du behöver inte köra appen.

```
1. upload-attachment  { "text": "<UTF-8 contents of ApiKeys.tsx>",
                        "mimeType": "text/javascript" }
                      → { "id": "ATT_ID", "path": "...", "assetUrl": "...", "type": "document",
                          "mimeType": "text/javascript" }

2. ai-design-screens  { "message": "Generate a desktop screen that matches this React component.",
                        "attachments": [{ "id": "ATT_ID", "path": "...", "type": "document" }] }
                      → { "status": "generated", "fileId": "FILE_ID", "screenIds": ["SCREEN_ID"], ... }

3. get-screen-image   { "fileId": "FILE_ID", "screenId": "SCREEN_ID" }
                      → [inline PNG]
```

För källfiler som är längre än 64 000 tecken använder du i stället `upload-attachment` med `mimeType` och `fileName` och kör sedan det returnerade `uploadCommand`. Se [`upload-attachment`](https://docs.flowstep.ai/sv/mcp/tools#upload-attachment).

**Prompt till din AI-assistent:**

> Läs `src/components/settings/ApiKeys.tsx`, ladda upp den som bilaga och generera en Flowstep-skärm som matchar komponentens layout. Visa mig den renderade bilden.

***

## 3. Iterera på en skärm

Ändra en befintlig skärm på plats med fria instruktioner. I samma anrop kan du också lägga till en ny skärm som matchar den.

```
1. list-screens       { "fileId": "FILE_ID" }
                      → { "screens": [{ "screenId": "SCREEN_ID", "name": "Sign-in", ... }] }

2. ai-design-screens  { "fileId": "FILE_ID",
                        "message": "Edit this sign-in screen: switch it to dark mode and add a
                                    'Remember me' checkbox below the password field. Then add a
                                    matching forgot-password screen.",
                        "elementIds": ["SCREEN_ID"] }
                      → { "status": "generated", "fileId": "FILE_ID",
                          "screenIds": ["SCREEN_ID", "NEW_SCREEN_ID"], ... }

3. get-screen-image   { "fileId": "FILE_ID", "screenId": "SCREEN_ID" }
                      → [inline PNG]
   get-screen-image   { "fileId": "FILE_ID", "screenId": "NEW_SCREEN_ID" }
                      → [inline PNG]
```

`screenIds` listar varje skärm som anropet byggde eller ändrade, så anropa `get-screen-image` en gång för varje. Utelämna den sista meningen i meddelandet om du bara vill redigera den befintliga skärmen.

För att ändra endast en del av en skärm anropar du först `get-screen-jsx` med `"includeIds": true` och skickar sedan `data-id` för elementet du vill ändra i `elementIds`.

För en förinställning med ett klick på en hel skärm anropar du i stället `ai-edit-screen-variant`, till exempel med `"operationVariant": "light_theme"` eller `"different_layout"`.

**Prompt till din AI-assistent:**

> I min Flowstep-fil "Login flow" ska du byta inloggningsskärmen till mörkt läge, lägga till en kryssruta "Remember me" under lösenordsfältet och lägga till en matchande skärm för glömt lösenord. Visa mig resultaten.

***

## 4. Utöka en skärm till ett helt flöde

Lägg till efterföljande skärmar i en befintlig design.

```
1. list-screens                { "fileId": "FILE_ID" }
                               → { "screens": [{ "screenId": "BASE_SCREEN_ID", "prompt": "Sign-in screen", ... }] }

2. ai-generate-screen-variant  { "fileId": "FILE_ID",
                                 "screenId": "BASE_SCREEN_ID",
                                 "operationVariant": "next_screen" }
                               → { "status": "generated", "fileId": "FILE_ID", "screenIds": ["NEXT_SCREEN_ID"], ... }

3. get-screen-image            { "fileId": "FILE_ID", "screenId": "NEXT_SCREEN_ID" }
                               → [inline PNG]
```

Upprepa steg 2 med `operationVariant: "error_state"` eller `"empty_state"` för att lägga till skärmar för kantfall, eller `"web_version"` / `"tablet_version"` för andra plattformar.

> [!NOTE]
>
> `operationVariant` är obligatoriskt för `ai-generate-screen-variant`, och verktyget tar exakt ett `screenId`. Om du vill lägga till en skärm som inte är en variant av en befintlig skärm använder du `ai-design-screens` med ett `fileId`.

***

## 5. Överför en skärm till din kodbas och skriv sedan ändringar tillbaka

Läs en skärm som JSX, bygg vidare på den och skicka din redigerade JSX tillbaka till canvas. Inga meddelanden används.

```
1. get-screen-jsx      { "fileId": "FILE_ID", "screenId": "SCREEN_ID" }
                       → { "name": "Settings", "fidelity": "ui", "screenType": "web",
                           "colorTheme": "default", "jsx": "<div ...>...</div>", "fragments": [] }

2. replace-screen-jsx  { "fileId": "FILE_ID", "screenId": "SCREEN_ID",
                         "jsx": "<div ...>...edited...</div>" }
                       → { "fileId": "FILE_ID", "screenId": "SCREEN_ID" }

3. get-screen-image    { "fileId": "FILE_ID", "screenId": "SCREEN_ID" }
                       → [inline PNG]
```

Fält som du utelämnar (`name`, `fidelity`, `screenType`, `colorTheme`, `fragments`) behåller sina nuvarande värden. Om du vill behålla originalet och lägga till din version bredvid det anropar du `add-screen-jsx` med `screenType` och `jsx` i stället för `replace-screen-jsx`.

För att visa en egen bild i skärmen laddar du upp den med `upload-attachment` och lägger den returnerade `assetUrl` i en `img src` i din JSX. Se [Bilder i JSX](https://docs.flowstep.ai/sv/mcp/tools.md#images-in-jsx).

***

## 6. Kontrollera din kvot före ett batchjobb

Kontrollera återstående kapacitet innan du startar flera genereringar. `get-plan-details` är gratis att anropa.

```
get-plan-details {}
→ { "plan": { ... }, "subscription": { ... }, "limits": { ... }, "usage": { ... },
    "remaining": { "messages": { "daily": ..., "monthly": ... } } }
```

Om `remaining.messages.daily` är lågt kan du schemalägga batchen till efter 00:00 UTC, när den återställs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.