FlowZap

O MCP do FlowZap gera diagramas de Workflow, Sequência e Arquitetura a partir do seu aplicativo em segundos. Diagramas bonitos.

Ver em flowzap.xyzExperimente este MCPPatrocinado

Documentação

Nosso Compliance Checker foi atualizado para incluir uma verificação de conformidade com o EU AI Act! Saiba mais.

Documentação do Servidor MCP FlowZap

🤖 Esta documentação é otimizada para consumo por LLMs e Agentes de IA

Versão 2.1.0 | Última atualização: Setembro de 2026 | flowzap_fix ferramenta de reparo determinístico + transporte remoto Streamable HTTP (listado no registro oficial do MCP), visualização Mind Map + 4 ferramentas de mindmap (validate, approve, template, create_playground), verificador de conformidade, 13 ferramentas no total

Visão Geral

O Servidor MCP (Model Context Protocol) FlowZap permite que agentes de IA criem, validem e compartilhem diagramas profissionais de Workflow, Sequência e Arquitetura usando FlowZap Code—uma linguagem de domínio específico projetada para geração de diagramas legíveis por máquina.

Dica: Use com o arquivo SKILL md para obter resultados ideais!

O que é FlowZap?

Propósito	Converter código baseado em texto em diagramas visuais de workflow
Otimizado Para	Geração AI-first, workflows agênticos (n8n, Make.com, Zapier)
Recurso Exclusivo	Renderização em quatro visualizações - o mesmo código renderiza como diagramas de workflow, sequência, arquitetura E mind map
Compartilhamento	URLs compartilháveis instantâneas sem autenticação

Garantias de Segurança

O Servidor MCP FlowZap implementa medidas de segurança de nível empresarial para proteger os usuários:

Segurança de Rede

Proteção	Implementação
Prevenção SSRF	Conecta-se apenas a flowzap.xyz e www.flowzap.xyz via HTTPS
Validação de URL	Todas as URLs retornadas são verificadas para se originarem dos domínios FlowZap
Timeout de Requisição	Timeout de 30 segundos evita conexões penduradas

Validação de Entrada

Limite	Valor	Propósito
Comprimento Máximo do Código	50.000 caracteres	Evita esgotamento de memória
Comprimento Máximo da Entrada	100.000 caracteres	Protege contra ataques de payload
Remoção de Byte Nulo	Automática	Evita ataques de injeção
Saneamento de Caracteres de Controle	Automático	Remove caracteres não imprimíveis

Limitação de Taxa

Parâmetro	Valor
Máximo de Requisições	30 por minuto
Duração da Janela	60 segundos
Comportamento	Retorna tempo de nova tentativa quando excedido

Privacidade de Dados

Nenhuma Autenticação Necessária - Apenas endpoints públicos
Nenhum Dado de Usuário Armazenado - Sessões de playground são efêmeras (TTL de 60 minutos, tokens criptográficos não adivinháveis)
Nenhum Rastreamento - Sem cookies ou identificadores persistentes
Logs apenas em stderr - Eventos de segurança nunca expostos aos clientes MCP

Ferramentas Disponíveis

1. flowzap_get_syntax

Propósito: Recuperar a documentação completa da sintaxe do FlowZap Code.

Quando Usar: Antes de gerar qualquer FlowZap Code, chame esta ferramenta para aprender a sintaxe correta.

Esquema de Entrada:

{
  "type": "object",
  "properties": {}
}

Saída: Guia de sintaxe completo incluindo restrições globais, tipos de formas, sintaxe de nós, sintaxe de arestas, sintaxe de loops e erros comuns a evitar.

2. flowzap_validate

Propósito: Validar a sintaxe do FlowZap Code antes de criar um diagrama.

Quando Usar: Sempre valide o código antes de chamar flowzap_create_playground. Isso evita erros e fornece feedback acionável.

Esquema de Entrada:

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "FlowZap Code to validate"
    }
  },
  "required": ["code"]
}

Saída de Sucesso:

✅ FlowZap Code is valid!

Stats:
- Lanes: 2
- Nodes: 5
- Edges: 4

Saída de Falha:

❌ Validation failed:
- Line 3: Unknown shape "oval". Valid shapes: circle, rectangle, diamond, taskbox
- Line 5: Edge missing handle syntax. Use: n1.handle(right) -> n2.handle(left)

3. flowzap_create_playground

Propósito: Criar uma URL de playground compartilhável com o diagrama.

Quando Usar: Após a validação passar, crie um playground para dar aos usuários um diagrama interativo que eles possam visualizar e editar.

Esquema de Entrada:

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "FlowZap Code to load in the playground"
    },
    "view": {
      "type": "string",
      "enum": ["workflow", "sequence", "architecture"],
      "description": "Initial view mode. Default: workflow"
    }
  },
  "required": ["code"]
}

Saída:

✅ Playground created!

🔗 **View your diagram:** https://flowzap.xyz/playground/abc123?view=architecture

The diagram is ready to view and edit. Share this link with anyone!

Modos de Visualização:

Visualização	Melhor Para
workflow	Fluxos de processo passo a passo (padrão)
sequence	Trocas de mensagens entre participantes
architecture	Visão geral de nível de sistema mostrando lanes como sistemas

Notas Importantes:

Valida automaticamente o código antes de criar o playground
Retorna erros de validação se o código for inválido
URLs de playground expiram após 60 minutos
Nenhuma autenticação necessária para visualizar
Use view="architecture" para visão geral de nível de sistema de diagramas multi-lane

4. flowzap_compliance_check

Propósito: Executar análise automatizada de conformidade SOC2, GDPR, PIPL e EU AI Act em um diagrama de fluxo de dados FlowZap Code.

Quando Usar: Quando o usuário solicitar uma revisão de privacidade, segurança ou regulatória de um diagrama de fluxo de dados. Suportado pelo LLM Deepseek.

Esquema de Entrada:

{
  "type": "object",
  "properties": {
    "code": { "type": "string", "maxLength": 50000 },
    "lng": { "type": "string", "enum": ["en", "fr", "zh"], "default": "en" }
  },
  "required": ["code"]
}

Saída: Relatório de auditoria em Markdown cobrindo controles da série CC do SOC2, artigos do GDPR, capítulos do PIPL e obrigações do EU AI Act (classificação de risco de IA, supervisão humana e documentação técnica) com riscos, recomendações e um link para o verificador manual em flowzap.xyz/soc2-gdpr-pipl-compliance-checker.

Limites de Taxa (estritos, proteção de custo do LLM Deepseek):

10 revisões de conformidade gratuitas por período contínuo de 30 dias por IP ou por mcpIdentity
3 chamadas por hora limite de rajada por IP
Disjuntor global de 5 minutos em falhas repetidas de upstream
Apenas chamadas bem-sucedidas contam para a cota mensal

5. flowzap_fix

Propósito: Passo de reparo determinístico para FlowZap Code rejeitado pelo validador: numeração de nós não sequencial, handles de aresta inferidos, sintaxe de rótulo de nó/aresta, rótulos de exibição de lane ausentes, emojis e caracteres não imprimíveis.

Quando Usar: Quando flowzap_validate (ou POST /api/validate) rejeitar código com um desses erros mecânicos. A ferramenta retorna o código corrigido mais a lista de correções aplicadas; erros que não podem ser reparados são relatados como estão e o conteúdo nunca é inventado.

Esquema de Entrada:

{
  "type": "object",
  "properties": {
    "code": { "type": "string", "maxLength": 50000 },
    "lng": { "type": "string", "enum": ["en", "fr", "zh"], "default": "en" }
  },
  "required": ["code"]
}

Saída: O FlowZap Code reparado, as correções aplicadas com contagens e quaisquer erros não corrigíveis restantes com suas mensagens do validador. Suportado pelo endpoint público POST /api/fix (30 requisições/minuto por IP, sem autenticação).

Referência de Regras de Validação

O validador executa verificações de validação abrangentes em múltiplas categorias. Entender isso ajuda a gerar código válido na primeira tentativa.

Códigos de Erro (Criação de Diagrama de Blocos)

Código	Descrição	Correção
CONTAINS_EMOJI	Caracteres de emoji detectados	Use apenas texto simples UTF-8
NESTED_LANE	Lane definida dentro de outra lane	Achate a estrutura de lanes
UNMATCHED_BRACE	Fechamento } sem abertura {	Verifique o equilíbrio de chaves
UNCLOSED_BRACE	Fechamento } ausente	Adicione a chave de fechamento
DUPLICATE_NODE_ID	Mesmo ID de nó usado duas vezes	Use IDs únicos: n1, n2, n3...
INVALID_SHAPE	Tipo de forma desconhecido	Use: circle, rectangle, diamond, taskbox
MISSING_LABEL	Nó sem rótulo (exceto taskbox)	Adicione label:"Texto"
NODE_OUTSIDE_LANE	Nó definido fora de qualquer lane	Mova para dentro de um bloco de lane
MISSING_HANDLES	Aresta sem sintaxe de handle	Use n1.handle(right) -> n2.handle(left)
INVALID_EDGE_SYNTAX	Definição de aresta malformada	Verifique a sintaxe de seta ->
INVALID_DIRECTION	Direção de handle desconhecida	Use: left, right, top, bottom
EDGE_OUTSIDE_LANE	Aresta definida fora de qualquer lane	Mova para dentro de um bloco de lane
UNDEFINED_LANE_REF	Referência entre lanes para lane inexistente	Verifique a grafia do nome da lane
INVALID_LOOP_SYNTAX	Definição de loop malformada	Use loop [condição] n1 n2
LOOP_OUTSIDE_LANE	Loop definido fora de qualquer lane	Mova para dentro de um bloco de lane
MISPLACED_COMMENT	Comentário em local errado	Coloque o único comentário permitido na mesma linha da chave de abertura da lane
COMMENT_OUTSIDE_LANE	Comentário fora de qualquer lane	Remova-o ou mova o rótulo de exibição para a linha de abertura da lane
UNDEFINED_NODE	Aresta referencia nó indefinido	Defina o nó antes de referenciá-lo
NON_SEQUENTIAL_NUMBERING	Numeração de nós não começa em n1 ou tem lacuna	Use n1, n2, n3... sequencialmente em todo o diagrama
WRONG_LABEL_SYNTAX	Rótulo de nó usa = em vez de :	Use label:"Texto" para atributos de nó
WRONG_EDGE_LABEL_SYNTAX	Rótulo de aresta usa : em vez de =	Use [label="Texto"] para rótulos de aresta
ORPHAN_NODE	Nó não está conectado a nenhuma aresta	Conecte-o como origem ou destino de uma aresta, ou remova-o
MISSING_RETURN_EDGE	Requisição entre lanes sem aresta de retorno correspondente	Adicione uma aresta de resposta da lane de destino de volta à lane de origem
MULTIPLE_OUTBOUND_REQUESTS	Uma lane envia outra requisição entre lanes antes da anterior ser respondida	Use um ritmo estrito de requisição → resposta → próxima requisição
CHRONOLOGICAL_PAIRING_VIOLATION	Uma requisição entre lanes diferente aparece antes da aresta de retorno anterior	Reordene as arestas para corresponder à linha do tempo real de requisição/resposta
EMPTY_DIAGRAM	Nenhum nó definido	Adicione pelo menos um nó
WRONG_DSL_FORMAT	Mermaid/PlantUML detectado	Use apenas sintaxe FlowZap

Códigos de Aviso (Violações de Boas Práticas)

Código	Descrição	Recomendação
NON_PRINTABLE_CHARS	Caracteres de controle detectados	Use apenas texto simples
DUPLICATE_LANE	Mesma lane definida duas vezes	Mescle em um único bloco
MISSING_LANE_LABEL	Lane sem # Nome de Exibição	Adicione rótulo de exibição
NON_STANDARD_NODE_ID	ID não está no formato n1, n2, n3	Use numeração padrão
TASKBOX_MISSING_PROPS	Taskbox sem owner/description	Adicione propriedades obrigatórias
LOOP_TOO_FEW_NODES	Loop com apenas 1 nó	Inclua pelo menos 2 nós
UNKNOWN_ATTRIBUTE	Atributo não padrão usado	Use: label, owner, description, system
LABEL_TOO_LONG	Rótulo excede 50 caracteres	Mantenha rótulos concisos

Referência Rápida da Sintaxe do FlowZap Code

Restrições Globais

✓ UTF-8 plain text only (no emojis)
✓ Node IDs: n1, n2, n3... (globally unique, sequential, no gaps)
✓ Shapes: circle, rectangle, diamond, taskbox
✓ Attributes: label, owner, description, system
✓ Comments: Only "# Display Label" on the same line as the lane opening brace
✓ Sequence view: alternate cross-lane request and response edges in real chronological order
✗ No Mermaid, PlantUML, or other DSL syntax

Estrutura Básica

laneName { # Lane Display Name
  n1: circle label:"Start"
  n2: rectangle label:"Process"
  n1.handle(right) -> n2.handle(left)
}

Tipos de Formas

Forma	Propósito	Exemplo
circle	Eventos de Início/Fim	n1: circle label:"Início"
rectangle	Tarefas/Atividades	n2: rectangle label:"Processar Pedido"
diamond	Gateways de decisão	n3: diamond label:"Válido?"
taskbox	Tarefas atribuídas	n4: taskbox owner:"Alice" description:"Implantar"

Sintaxe de Arestas

# Basic edge
n1.handle(right) -> n2.handle(left)

# Edge with label
n2.handle(bottom) -> n3.handle(top) [label="Yes"]

# Cross-lane edge (prefix with lane name)
n3.handle(right) -> fulfillment.n4.handle(left) [label="Send"]

Direções de Handle

Direção	Posição
left	Lado esquerdo do nó
right	Lado direito do nó
top	Topo do nó
bottom	Base do nó

Sintaxe de Loop

loop [retry up to 3 times] n1 n2 n3

Deve estar dentro de um bloco de lane
Não pode ser aninhado
Deve referenciar pelo menos 2 nós

Exemplo Completo

sales { # Sales Team
  n1: circle label:"Order Received"
  n2: rectangle label:"Validate Order"
  n5: rectangle label:"Receive decision"
  n1.handle(right) -> n2.handle(left)
  n2.handle(bottom) -> fulfillment.n3.handle(top) [label="Submit"]
}

fulfillment { # Fulfillment
  n3: rectangle label:"Review Order"
  n4: rectangle label:"Return decision"
  n3.handle(right) -> n4.handle(left)
  n4.handle(top) -> sales.n5.handle(bottom) [label="Approved"]
}

Workflow Recomendado para Agentes de IA

Passo 1: Aprender a Sintaxe
{"name": "flowzap_get_syntax", "arguments": {}}}
Passo 2: Gerar Código
Com base na solicitação do usuário, gere FlowZap Code seguindo as regras de sintaxe.
Passo 3: Validar
{"name": "flowzap_validate", "arguments": {"code": "..."}}
Passo 4: Corrigir Erros (se houver)
Analise as mensagens de erro e corrija o código.
Passo 5: Criar Playground
{"name": "flowzap_create_playground", "arguments": {"code": "..."}}
Passo 6: Apresentar ao Usuário
Compartilhe a URL do playground com o usuário.

Erros Comuns a Evitar

Erro	Incorreto	Correto
Comentário de lane em linha separada	laneName { # Rótulo	laneName { # Rótulo
Formas abreviadas	n1: rect	n1: rectangle
Handles ausentes	n1 -> n2	n1.handle(right) -> n2.handle(left)
Sintaxe errada de atributo de nó	label="Texto"	label:"Texto"
Sintaxe errada de rótulo de aresta	[label:"Texto"]	[label="Texto"]
Emojis em rótulos	label:"Início 🚀"	label:"Início"
Atributos desconhecidos	priority:"alta"	(remover - não suportado)
IDs não sequenciais	n1, n3, n5	n1, n2, n3
Referências de lane indefinidas	undefined.n5	Use o nome real da lane
Segunda requisição antes da resposta	A -> B, depois A -> C, depois B -> A	A -> B, depois B -> A, depois próxima requisição

Endpoints de API (Acesso Direto)

Para agentes que preferem chamadas HTTP diretas em vez de MCP:

POST /api/validate

URL: https://flowzap.xyz/api/validate

Limite de Taxa: 30 requisições/minuto por IP

Requisição:

{
  "code": "process { # P n1: circle label:\"Start\" }"
}

Resposta:

{
  "valid": true,
  "errors": [],
  "warnings": [],
  "stats": {
    "lanes": 1,
    "nodes": 1,
    "edges": 0,
    "loops": 0
  }
}

POST /api/playground/create

URL: https://flowzap.xyz/api/playground/create

Limite de Taxa: 5 requisições/minuto, 50/dia por IP

Requisição:

{
  "code": "process { # P n1: circle label:\"Start\" }"
}

Resposta:

{
  "url": "https://flowzap.xyz/playground?session=abc123"
}

Instalação

O servidor MCP FlowZap funciona com qualquer ferramenta que suporte o Model Context Protocol (MCP). Aqui está a lista completa de ferramentas compatíveis:

Todas as Ferramentas de Codificação Compatíveis

Ferramenta	Como Configurar
Claude Desktop	Adicione em `claude_desktop_config.json`: macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` Windows: `%APPDATA%\Claude\claude_desktop_config.json`
Claude Code	Execute: `claude mcp add --transport stdio flowzap -- npx -y flowzap-mcp` Ou adicione em `.mcp.json` na raiz do seu projeto.
Cursor	Abra Configurações → Recursos → Servidores MCP → Adicionar Servidor. Use a mesma configuração JSON.
Windsurf IDE	Adicione em `~/.codeium/windsurf/mcp_config.json`
OpenAI Codex	Adicione em `~/.codex/config.toml`: `[mcp_servers.flowzap]` `command = "npx"` `args = ["-y", "flowzap-mcp"]` Ou execute: `codex mcp add flowzap -- npx -y flowzap-mcp`
Warp Terminal	Configurações → Servidores MCP → Clique em "+ Adicionar" → Cole a configuração JSON.
Zed Editor	Adicione em `settings.json`: `{"context_servers": {"flowzap": {"command": "npx", "args": ["-y", "flowzap-mcp"]}}}`
Cline (VS Code)	Abra a barra lateral do Cline → Ícone de Servidores MCP → Edite `cline_mcp_settings.json`
Roo Code (VS Code)	Adicione em `.roo/mcp.json` nas configurações do projeto ou globais.
Continue.dev	Crie `.continue/mcpServers/flowzap.yaml` com: `name: FlowZap` `mcpServers:` `- name: flowzap` `command: npx` `args: ["-y", "flowzap-mcp"]`
Sourcegraph Cody	Adicione em `settings.json` do VS Code via configuração `openctx.providers`.

Usuários Windows: Se as ferramentas não aparecerem, use o caminho absoluto: "command": "C:\\Program Files\\nodejs\\npx.cmd". Encontre o caminho do npx com: where.exe npx

Configuração JSON

Todas as ferramentas usam o mesmo formato de configuração JSON:

{
  "mcpServers": {
    "flowzap": {
      "command": "npx",
      "args": ["-y", "flowzap-mcp"]
    }
  }
}

Usuários Windows: Se as ferramentas não aparecerem, use o caminho absoluto: "command": "C:\\Program Files\\nodejs\\npx.cmd". Encontre o caminho do npx com: where.exe npx

Suporte e Recursos

• Documentação de Sintaxe: https://flowzap.xyz/flowzap-code
• Playground Interativo: https://flowzap.xyz/playground
• Biblioteca de Modelos: https://flowzap.xyz/templates
• Estatísticas Públicas de Uso do MCP: https://flowzap.xyz/.well-known/flowzap-stats.json
• Pacote npm: https://www.npmjs.com/package/flowzap-mcp
• Repositório GitHub: https://github.com/flowzap-xyz/flowzap-mcp
• Registro Oficial do MCP: https://registry.modelcontextprotocol.io/?q=flowzap
• Servidor Smithery: https://smithery.ai/server/@flowzap/flowzap
• Skill Smithery: https://smithery.ai/skills/Flowzap/diagram-skill
• PulseMCP: https://www.pulsemcp.com/servers/flowzap
• Glama: https://glama.ai/mcp/servers/flowzap-xyz/flowzap-mcp
• MCPServers.org: https://mcpservers.org/servers/flowzap-xyz-docs-mcp
• AIBase: https://mcp.aibase.com/server/1639702939289526535
• Agent Skill (skills.sh): https://skills.sh/flowzap-xyz/flowzap-mcp/flowzap-diagrams
• Fonte da Skill: https://github.com/flowzap-xyz/flowzap-mcp/tree/main/skills/flowzap-diagrams
• Conjunto de Dados Hugging Face: https://huggingface.co/datasets/Jules-OC/flowzap-sequence-workflows/tree/main

Instale como Agent Skill (mais de 40 agentes)

npx skills add flowzap-xyz/flowzap-mcp

Compatível com: Claude Code, Cursor, Windsurf, Codex, Gemini CLI, GitHub Copilot, Cline, Roo Code, Augment, OpenCode e outros.

Histórico de Versões

Versão	Data	Alterações
1.4.3	Maio 2026	Descrições de ferramentas reforçadas para que todos os clientes MCP (não apenas Claude Code via SKILL.md) invoquem automaticamente `flowzap_compliance_check` junto com `flowzap_create_playground` em solicitações de conformidade; a página de resultados agora corresponde ao layout do verificador manual
1.4.2	Maio 2026	URLs de resultados de conformidade efêmeros compartilháveis (TTL de 60 min, noindex) com página de auditoria renderizada; SKILL.md exigia formato de resposta de duas linhas
1.4.1	Maio 2026	A verificação de conformidade retorna `resultUrl` além do relatório Markdown inline
2.1.0	Set 2026	Nova ferramenta `flowzap_fix` (reparo determinístico via POST /api/fix) + transporte remoto Streamable HTTP listado no registro oficial do MCP — agentes hospedados (Replit, Lovable.dev, conectores ChatGPT, Claude web) não precisam mais de npx — 13 ferramentas no total
2.0.0	Ago 2026	Visualização Mind Map (?view=mindmap) + 4 ferramentas de mindmap (validate, approve, template, create_playground) — 12 ferramentas no total
1.4.0	Maio 2026	Nova ferramenta `flowzap_compliance_check` (SOC2/GDPR/PIPL, com suporte Deepseek) com limites de taxa estritos de 3 camadas; dica de venda cruzada adicionada a `flowzap_create_playground`; 8 ferramentas no total
1.3.6	Abr 2026	Validação mais rigorosa (lacunas de numeração, aplicação de sequência ping-pong, rótulos de faixa na mesma linha), alinhamento do endpoint do playground, documentação atualizada
1.3.5	Fev 2026	Correções de segurança: vulnerabilidades MCP SDK ReDoS, hono JWT/XSS, ajv ReDoS, qs DoS
1.3.3	Fev 2026	Todas as 7 ferramentas conectadas, modo de visualização Architecture
1.3.0	Fev 2026	Adicionado modo de visualização Architecture, renderização de tripla visualização
1.2.0	Jan 2026	Adicionadas novas regras de validação, cobertura abrangente de testes
1.1.0	Dez 2025	Reforço de segurança, limitação de taxa
1.0.0	Nov 2025	Lançamento inicial

Esta documentação é otimizada para consumo por LLM. Para guias legíveis por humanos, visite flowzap.xyz/flowzap-code