Flova MCP for Studio
Connect agent clients to Studio dashboards through the Flova MCP server.
Flova MCP lets supported agent clients read and edit Flova workspace resources through the Model Context Protocol. Studio tools can list dashboards, read dashboard context, inspect nodes and authoring capabilities, dry-run semantic edits, apply approved edits, save drafts, validate, visually inspect, publish, and archive dashboards.
The hosted endpoint is:
https://mcp.flova.ir/mcpMCP uses OAuth through Flova Auth. The client opens a browser when it needs access. Sign in, choose the Flova workspace, approve access, and start a fresh agent session when the client asks you to.
Add Flova MCP
These examples register the server with the name flova.
codex mcp add flova --url https://mcp.flova.ir/mcp
codex mcp listCodex opens Flova Auth during add when needed. Use codex mcp login flova if the OAuth session expires.
Verify and edit safely
Ask the agent to list Flova workspace resources or read the Studio dashboard authoring guide. A connected client exposes only tools allowed by OAuth scopes and the workspace role.
For dashboard changes:
- Read dashboard context.
- Inspect the page or nodes that will change.
- Prepare one small semantic edit batch.
- Run the dashboard edit dry run.
- Apply the exact successful batch with a new operation ID and preview fingerprint.
- Save or validate the draft.
- Review the dashboard in Studio before publishing.
For a normal edit, the corresponding tool sequence is:
dashboard_authoring_contextdashboard_nodes_inspectfor the affected pages or widgetsdashboard_edit_dry_runwith 1 to 12 semantic editsdashboard_edit_semanticwith the exact successful batch, a newoperationId, and the returnedpreviewFingerprintdashboard_visual_inspectat the requested breakpointsdashboard_validatedashboard_publishwithconfirm: trueonly after explicit human approval
If a dry run fails, follow its returned nextTool and repair guidance,
change the edit, and do not resend the same failureFingerprint. If the
dashboard has a history conflict, read fresh context before inspecting again.
If responsive geometry fails, inspect the affected Grid or Stack and split the
content into a smaller responsive parent when needed.
A history conflict means the dashboard changed after the agent read it. Read a fresh context and inspect the affected areas. A responsive geometry error means a Grid or Stack cannot fit the requested content at one or more breakpoints.
| Area | Examples |
|---|---|
| Console authoring | Templates, datastreams, mappings, automations, and versions |
| Studio authoring | Dashboards, pages, widgets, bindings, styles, validation, and publishing |
| FlovaQL | Catalog, validation, query execution, and saved-query management |
| Devices | Device lists and runtime state |
| Firmware planning | Current template and datastream context |
MCP does not expose direct device commands, provisioning, flashing, OTA publishing, or activation-code creation. Elevated or destructive operations require confirmation. MCP calls count against the organization plan quota.
The MCP quota is shared by the workspace and resets every 30 days:
| Plan | MCP calls |
|---|---|
| Free | 250 |
| Starter | 500 |
| Pro | 2,500 |
| Business | 10,000 |
The Console billing page shows the current period's MCP usage. When the quota
is exhausted, MCP returns mcp_quota_exhausted with the billing URL.
Return to Assistant for the relationship between external MCP clients and the in-editor Assistant.