Datadef

Gere e edite diagramas de arquitetura de dados a partir da sua IA.

GitHubExperimente este MCPPatrocinado

Documentação

Datadef MCP

Diagramas de arquitetura de dados que sua IA gera, edita e exporta — a partir do Claude, Cursor, VS Code, Gemini CLI ou qualquer cliente MCP. Tabelas tipadas com colunas, pipelines, linhagem no nível de coluna, mais de 2.000 ícones reais de ferramentas. Os PNGs exportados voltam diretamente no chat.

Este repositório é a casa pública do servidor MCP remoto em https://datadef.io/mcp (HTTP Streamable). Não há nada para instalar daqui — ele existe para diretórios, links de instalação e issues.

O que ele desenha — ao vivo

O diagrama abaixo não é uma captura de tela. É um diagrama público do Datadef incorporado por URL — quando o diagrama é editado, esta imagem é atualizada junto. Esse é o ciclo para o qual este servidor existe: seu agente desenha e mantém o diagrama, e todo documento que o incorpora permanece atualizado.

Customer 360 Platform — Identity Resolution and Activation

![Customer 360 Platform](https://datadef.io/api/embed/customer-360-platform)

Conectar

Duas formas de acesso — ambas incluídas no teste gratuito de 7 dias:

  • OAuth (sem chave): adicione https://datadef.io/mcp como conector no Claude ou ChatGPT e faça login quando solicitado. O Claude Code também funciona sem chave: claude mcp add --transport http datadef https://datadef.io/mcp.
  • Chave de API (headless): crie uma em datadef.io/settings/mcp e envie-a como cabeçalho Bearer — ideal para CI e scripts.

Claude Code

claude mcp add --transport http datadef https://datadef.io/mcp \
  --header "Authorization: Bearer dd_live_YOUR_KEY"

Cursor / Claude Desktop (via bridge mcp-remote)

{
  "mcpServers": {
    "datadef": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://datadef.io/mcp",
        "--header", "Authorization: Bearer dd_live_YOUR_KEY"
      ]
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "datadef": {
      "type": "http",
      "url": "https://datadef.io/mcp",
      "headers": { "Authorization": "Bearer ${input:datadef-key}" }
    }
  }
}

Gemini CLI (~/.gemini/settings.json) — observe httpUrl, não url; url simples é SSE legado lá e falha silenciosamente:

{
  "mcpServers": {
    "datadef": {
      "httpUrl": "https://datadef.io/mcp",
      "headers": { "Authorization": "Bearer $DATADEF_API_KEY" }
    }
  }
}

Botões de instalação com um clique estão em datadef.io/settings/mcp.

Ferramentas

Três camadas. Nível de resultado — descreva uma intenção, o pipeline do Datadef a executa: create_diagram, list_diagrams, get_diagram, edit_diagram, export_diagram, get_design_guide. Sincronização de repositório — repo_status e repo_refresh inspecionam e reexecutam a sincronização que mantém um diagrama e seu architecture.md regenerados a partir de um branch ou tag conectado do GitHub/GitLab/Azure DevOps. Repositórios Terraform recebem um pipeline dedicado: cada arquivo .tf é analisado (sem init, sem state, sem credenciais de nuvem), módulos desenhados como zonas, contagens por ambiente mantidas corretas. Atômico — 25 ferramentas canvas_* que seu modelo aciona diretamente (adicionar/atualizar/remover nós, conectar arestas, definir colunas, adicionar linhagem, agrupar, alinhar, layout, validar), para que o agente que já conhece seu repositório possa desenhar o que encontrar. O prompt datadef_design_guide ensina a qualquer modelo o padrão de design antes de desenhar.

initialize e tools/list anônimos estão abertos — aponte qualquer inspetor MCP para o endpoint para navegar pela superfície antes de criar uma chave.

Por que uma ferramenta de diagrama quer um agente

O agente que acabou de alterar seu projeto dbt ainda tem toda a mudança em contexto. Dizer "atualize o diagrama de arquitetura também" custa uma frase — e um diagrama incorporado (![arch](https://datadef.io/api/embed/your-diagram)) é atualizado em todos os lugares em que o canvas é. Os documentos param de envelhecer.

Executar como contêiner

Para clientes ou verificadores que desejam uma imagem executável, o Dockerfile incluído faz a ponte stdio para o servidor hospedado:

docker build -t datadef-mcp .
docker run -i -e DATADEF_API_KEY=dd_live_YOUR_KEY datadef-mcp

Links