convez.ai
MCP Server
sologovision

flato-design-mcp

sologovision/flato-design-mcp

Ver no GitHub
InicialPluginScore · de 0 a 100

Connect AI agents to Flato's editable design canvas with MCP.

Instalação

$npx convez-ai sologovision/flato-design-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
1
Acompanhando
0
Saúde
62%
Último commit
há 5 meses
Versão
v0.1.3
Issues abertas
2
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

Flato Design MCP

Connect AI agents to Flato's editable design canvas with MCP.

Flato Design MCP lets Codex, Claude Code, Cursor, and other MCP-capable agents create, inspect, revise, export, and QA editable Flato design projects. Agents work through the hosted Flato MCP server while users keep full access to the live browser editor.

https://api.flato.ai/api/mcp/editor

This repository is the official distribution package for setup docs, the base guide skill, Codex plugin packaging, examples, and registry/review metadata. It does not contain the Flato MCP server source code.

What's Included

  • skills/flato-design-mcp-guide: installable base guide skill for agents.
  • plugins/flato-design-mcp-codex: Codex plugin package with MCP config and the guide skill.
  • .agents/plugins/marketplace.json: Codex marketplace descriptor for this repo.
  • docs/: setup, OAuth, permissions, and troubleshooting notes.
  • registry/: MCP registry and platform review metadata drafts.
  • examples/prompts/: first prompts for testing the integration.

Codex Install

Codex can install this repo as a plugin marketplace:

codex plugin marketplace add sologovision/flato-design-mcp --ref main
codex plugin add flato-design-mcp-codex@flato-design-mcp
codex mcp login flato-editor

Then open a new Codex conversation and verify:

Use Flato Design MCP. Call flato_whoami first and report the result. Do not create, edit, or write any project.

See Codex setup.

Claude Code Install

Add the hosted Flato MCP server:

claude mcp add --transport http flato-editor https://api.flato.ai/api/mcp/editor

Then use the guide skill in skills/flato-design-mcp-guide.

See Claude Code setup.

Cursor And Other MCP Clients

Use the hosted MCP server URL:

https://api.flato.ai/api/mcp/editor

Then follow the workflow in skills/flato-design-mcp-guide/SKILL.md.

See Cursor setup.

OAuth

Flato Design MCP uses browser OAuth. If needed, Flato asks you to sign in or create an account before authorization.

Do not paste Flato passwords, bearer tokens, refresh tokens, or local OAuth cache contents into an agent conversation.

See Authentication.

Account And Subscription

A Flato account is required for OAuth. A paid Flato subscription is not required to install, connect, or start using Flato Design MCP.

Some features, exports, higher usage, team/workspace capabilities, or paid image generation and editing may still depend on the authenticated user's Flato plan or credits. Agents should report plan or credit errors from MCP instead of asking users to subscribe in advance.

First Agent Workflow

After connecting Flato MCP, an agent should:

  1. Call flato_whoami.
  2. Create or select a project with flato_create_project, flato_use_project, or flato_use_share_link.
  3. Open the live Flato editor when requested.
  4. Poll flato_get_project_status until canWrite=true.
  5. Call flato_get_design_context before any write.
  6. Use concrete page and block ids returned by fresh context reads.
  7. Inspect mcpFeedback after writes.
  8. Export and visually QA important results.

Verified Smoke Test

The v0.1.0 Codex path has been verified with:

codex plugin marketplace add sologovision/flato-design-mcp --ref main
codex plugin add flato-design-mcp-codex@flato-design-mcp
codex mcp login flato-editor

An independent Codex CLI session successfully called flato_whoami through the installed flato-editor MCP server without creating or editing any Flato project.

Screenshots

GitHub release

Flato Design MCP v0.1.0 GitHub release

Codex plugin install

Codex plugin install verified

Read-only MCP smoke test

Read-only MCP smoke test passed

Editable presentation canvas

Editable presentation canvas in Flato

Canvas editing and content tools

Flato canvas editing and content tools

AI-assisted canvas edits

AI-assisted edits in the Flato canvas

Codex working with the live canvas

Codex working with the live Flato canvas

Release Assets

GitHub releases attach:

  • flato-design-mcp-guide-v0.1.0.zip: installable base guide skill.
  • flato-design-mcp-codex-v0.1.0.zip: Codex plugin package.

Safety Principles

  • Do not ask users to paste passwords, bearer tokens, or local OAuth tokens.
  • Do not inspect local OAuth or token stores.
  • Do not guess pageId or blockId.
  • Do not claim generated assets are placed until a design write uses the returned asset URL.
  • Use backups before broad or risky edits.

Related Flato Docs

Support And Security

  • Use GitHub Issues for setup and documentation problems.
  • See SECURITY.md for security reporting guidance.
  • Do not include tokens, passwords, or private project content in public issues.

Roadmap

This is the base package. Scenario-specific skills such as flato-presentation-skill should build on this guide instead of duplicating the connection, OAuth, targeting, and safety workflow.

Ver o original no GitHub

Bom para

Relacionados