Configurando o MCP Server

O que é MCP?

O Model Context Protocol (MCP) é um padrão aberto que permite a assistentes de código com IA interagir com ferramentas externas. O ER Flow fornece um MCP Server que expõe seu modelo de dados à IA — permitindo que ela leia seu schema atual, crie tabelas, adicione colunas, configure relacionamentos e muito mais.

Passo 1: Obtenha o UUID do seu modelo de dados

Cada modelo de dados no ER Flow tem um UUID único. Você precisará dele para conectar sua IDE.

Abra seu modelo de dados no ER Flow, depois acesse Configurações ou observe a URL — o UUID é a longa sequência de caracteres no caminho. Você também pode encontrá-lo no modal de Compartilhar.

Copie este UUID — você o usará como token de autenticação para o MCP Server.

Passo 2: Configure o MCP na sua IDE

O endpoint do MCP Server é: https://app.erflow.io/api/mcp/{uuid}

Substitua {uuid} pelo UUID do seu modelo de dados.

Para o Cursor: Abra as configurações do Cursor (.cursor/mcp.json na raiz do seu projeto ou nas configurações globais) e adicione:

{
  "mcpServers": {
    "erflow": {
      "url": "https://app.erflow.io/api/mcp/YOUR_UUID_HERE"
    }
  }

Para o Windsurf: Adicione o MCP server na configuração do Windsurf com a mesma URL.

O UUID na URL funciona como seu token de autenticação — o servidor o usa para identificar em qual modelo de dados operar.

Passo 3: Teste a conexão

Uma vez configurado, seu assistente de IA deve conseguir descobrir as ferramentas do ER Flow. Tente perguntar:

"Mostre o schema atual do banco de dados"

A IA chamará a ferramenta get-data-model-dbml, que retorna todo o seu schema no formato DBML. Se isso funcionar, a conexão foi bem-sucedida.

Passo 4: Use a IA para modificar seu schema

Agora você pode descrever alterações no schema em linguagem natural:

• "Adicione uma tabela comments com id, post_id, user_id, body e created_at"
• "Adicione um índice único na coluna email da tabela users"
• "Crie uma chave estrangeira de comments.post_id para posts.id com delete em cascata"
• "Adicione uma coluna status na tabela orders do tipo enum com padrão 'pending'"

A IA traduz suas instruções em chamadas de ferramentas MCP, e as alterações aparecem no seu diagrama do ER Flow em tempo real.

Passo 5: Entenda as ferramentas disponíveis

O MCP Server do ER Flow oferece mais de 25 ferramentas organizadas por tipo de entidade:

Tabelas: create-table, update-table, rename-table, delete-table Colunas: create-column, update-column, rename-column, delete-column Índices: create-index, update-index, rename-index, delete-index Chaves Estrangeiras: create-foreign-key, update-foreign-key, delete-foreign-key Chaves Primárias: set-primary-key Views: create-view, update-view, delete-view Triggers: create-trigger, update-trigger, delete-trigger Procedures: create-procedure, update-procedure, delete-procedure Lote: batch-operations — executa múltiplas operações em uma única chamada Leitura: get-data-model-dbml — obtém o schema atual no formato DBML

A IA sempre deve chamar get-data-model-dbml primeiro para entender o schema atual antes de fazer alterações. A ferramenta batch-operations é especialmente poderosa — ela permite que a IA crie um schema completo (tabelas, colunas, chaves estrangeiras, índices) em uma única requisição.