Model Context Protocol

Controle o Muitto a partir de qualquer cliente MCP

Gere imagens, vídeo, áudio e texto, liste seus ativos, execute workflows e reutilize prompts salvos — direto do Claude Desktop, Cursor ou qualquer cliente Model Context Protocol.

Visão geral

O servidor MCP do Muitto expõe o mesmo motor de geração usado no app pela web, via o transporte padrão JSON-RPC 2.0 Streamable HTTP. Qualquer assistente compatível com MCP pode listar seus modelos, navegar seus ativos, iniciar gerações e salvar prompts — tudo medido nos créditos da sua conta, com atribuição por token e rotação.

Os provedores por trás de cada modelo nunca são expostos via MCP — apenas o catálogo AllInOne que você já vê no app.

Conectar um cliente

Aponte seu cliente MCP para o endpoint abaixo usando autenticação Bearer com um token criado em Configurações. Tokens são prefixados por lv_mcp_ e mostrados apenas uma vez na criação — copie imediatamente.

OAuth (recommended)

No token required. Add the URL below in Claude Desktop / Claude.ai / Codex / Cursor — the client opens a browser, you sign in to Muitto and approve access.

https://muitto.app/mcp

Endpoint HTTP bruto

Personal tokens work as a Bearer header, as an x-api-key header, or as a ?token= query string for clients that cannot send headers.

POST https://muitto.app/api/public/mcp
Authorization: Bearer lv_mcp_YOUR_TOKEN
Content-Type: application/json
Accept: application/json, text/event-stream

# or, headerless:
POST https://muitto.app/api/public/mcp?token=lv_mcp_YOUR_TOKEN

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "muitto": {
      "transport": { "type": "http", "url": "https://muitto.app/mcp" }
    }
  }
}

Token alternative (no OAuth prompt):

{
  "mcpServers": {
    "muitto": {
      "transport": {
        "type": "http",
        "url": "https://muitto.app/api/public/mcp?token=lv_mcp_YOUR_TOKEN"
      }
    }
  }
}

Cursor / MCP genérico

# Header auth
curl -X POST https://muitto.app/api/public/mcp \
  -H "Authorization: Bearer lv_mcp_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# Same call with the token in the URL (no headers required)
curl -X POST "https://muitto.app/api/public/mcp?token=lv_mcp_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Disparar um workflow via webhook

# 1. In the workflow editor, switch the Trigger to "Webhook", define your
#    input variables (e.g. { name: "topic", type: "string", required: true })
#    and copy the endpoint URL shown in the Trigger card.
# 2. POST to that URL with your MCP token — the JSON body is validated
#    against the workflow's input_schema before the run is enqueued.
curl -X POST https://YOUR-APP/api/public/webhook-trigger/WEBHOOK_TOKEN \
  -H "Authorization: Bearer lv_mcp_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"topic":"summer campaign","style":"cinematic"}'

# Same workflow via MCP tools/call (input is validated the same way):
curl -X POST https://muitto.app/api/public/mcp \
  -H "Authorization: Bearer lv_mcp_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"run_workflow","arguments":{"workflow_id":"WORKFLOW_ID","input":{"topic":"summer campaign","style":"cinematic"}}}}'

Controlando o Muitto a partir de agentes de IA

Depois que o servidor está conectado, o agente descobre as ferramentas sozinho. Você apenas conversa em linguagem natural — o agente decide qual ferramenta do Muitto chamar, e cada geração é cobrada dos créditos da sua conta.

Claude Desktop e Claude.ai

Adicione o Muitto como conector personalizado usando OAuth. O Claude abre uma janela do navegador para você entrar e aprovar — sem token.

# Claude Desktop → Settings → Connectors → Add custom connector
Name: Muitto
URL:  https://muitto.app/mcp

# Claude will open a browser window: sign in to Muitto and approve.
# Then, in any chat, click the connector icon and enable "Muitto".

Codex CLI

Declare o servidor no arquivo de configuração do Codex. Rode /mcp dentro do Codex para confirmar que as ferramentas carregaram.

# Codex CLI — ~/.codex/config.toml
[mcp_servers.muitto]
url = "https://muitto.app/mcp"

# Token alternative (headerless, useful in CI):
[mcp_servers.muitto]
url = "https://muitto.app/api/public/mcp?token=lv_mcp_YOUR_TOKEN"

# Then:  codex  →  /mcp   (lists the connected servers and their tools)

Claude Code CLI

Adicione o servidor com um comando, rode /mcp e autentique no navegador. As 14 ferramentas ficam disponíveis na sessão.

# Claude Code CLI — OAuth (recommended)
claude mcp add --transport http muitto https://muitto.app/mcp

# Then inside Claude Code:
/mcp            # lists servers; choose "muitto" → Authenticate
                # a browser opens: sign in to Muitto and approve

# Token alternative (headerless, useful in CI / remote shells):
claude mcp add --transport http muitto "https://muitto.app/api/public/mcp?token=lv_mcp_YOUR_TOKEN"

# Scope flags: --scope local (default) | project (.mcp.json) | user (all projects)
claude mcp list          # check connection status
claude mcp remove muitto

Cursor, VS Code e outros editores

Qualquer editor com suporte a MCP funciona com a mesma URL HTTP. Prefira o arquivo do projeto para que o time compartilhe a mesma configuração.

# Cursor — .cursor/mcp.json (project) or ~/.cursor/mcp.json (global)
{
  "mcpServers": {
    "muitto": { "url": "https://muitto.app/mcp" }
  }
}

# VS Code / GitHub Copilot — .vscode/mcp.json
{
  "servers": {
    "muitto": { "type": "http", "url": "https://muitto.app/mcp" }
  }
}

Exemplos de prompts

Peça em linguagem natural. Citar o nome do servidor ajuda o agente a escolher as ferramentas certas quando há vários conectores ativos.

Use the Muitto MCP server for everything below.

1. "List my available image models in the economy tier."
2. "Generate a 16:9 cinematic image of a neon Tokyo alley and give me the URL."
3. "Show my last 10 assets and describe them."
4. "Search my characters for 'Ana' and use her as a reference for a new portrait."
5. "Save this prompt as a snippet named 'Neon Tokyo base'."
6. "Create a workflow called 'Weekly campaign' and then run it with topic='summer sale'."

Dicas

Conceda apenas os escopos necessários — um agente somente leitura não precisa de write:generate.
Gerações debitam créditos, e agentes em loop gastam rápido; acompanhe em Configurações → Uso.
Se o agente disser que as ferramentas estão indisponíveis, reaprove a conexão ou rotacione o token.
O limite é de 60 requisições/minuto por token; peça ao agente para agrupar em vez de ficar consultando.
Gerações longas retornam um id de ativo — peça ao agente para listar os ativos de novo e pegar a URL final.

Ferramentas disponíveis

Nome	Escopo	Descrição
whoami	—	Return the signed-in Muitto user id and email. Use it to verify connectivity.
get_credit_balance	—	Return the signed-in user's current credit balance in USD.
list_models	read:catalog	List available AI models with modality, tier and pricing.
list_gallery_assets	read:assets	List the user's generated assets (also exposed as list_assets on the token endpoint).
list_chat_threads	read:assets	List the user's most recent chat threads.
generate	write:generate	Generate image, video, audio, voice or text (optionally auto-selects a model via tier). Debits credits.
search_characters	read:catalog	Search your own and public community characters.
list_saved_prompts	manage:prompts	List your saved prompt snippets.
create_saved_prompt	manage:prompts	Save a new prompt snippet for later reuse.
list_projects	read:catalog	List your canvases, workflows and studios.
create_canvas	write:projects	Create a new empty canvas.
create_workflow	write:projects	Create a new empty sequential workflow.
create_studio	write:projects	Create a new empty video studio project.
run_workflow	write:projects	Execute an existing workflow. Accepts optional structured `input` (validated against the workflow's trigger input_schema) and optional `input_prompt`. Debits credits.
get_canvas	read:projects	Read a canvas and all of its elements (id, type, position, size, content).
add_canvas_item	write:projects	Add an element (note, text, shape, image URL or gallery asset) to a canvas — appears live in the open canvas view.
update_canvas_item	write:projects	Move, resize, rotate, restyle or re-text a canvas element in real time.
delete_canvas_item	write:projects	Delete one or more elements from a canvas in real time.

Recursos

Seus últimos 100 ativos ficam expostos como URIs asset://<uuid>. Clientes podem anexá-los nas conversas; o servidor devolve URLs assinadas de 1h na leitura.

Prompts

Seus prompts salvos aparecem nativamente no painel de Prompts do cliente e podem ser inseridos com um clique.

Escopos

Ao criar um token, conceda apenas os escopos que seu cliente precisa.

read:catalog

Browse models, characters and projects.

read:assets

List assets and read signed URLs via resources/read.

write:generate

Trigger generations and debit credits.

manage:prompts

List, read and create saved prompt snippets.

write:projects

Create canvases, workflows, studios and run workflows.

Limites & cobrança

Cada token é limitado a 60 requisições por minuto (janela deslizante). Gerações debitam créditos da sua conta; o uso é atribuído por token e visível em Configurações.