Datadef

Genera y edita diagramas de arquitectura de datos desde tu IA.

GitHubPrueba este MCPPatrocinado

Documentación

Servidor MCP de Datadef

Diagramas de arquitectura de datos que tu IA genera, edita y exporta — desde Claude, Cursor, VS Code, Gemini CLI o cualquier cliente MCP. Tablas tipadas con columnas, pipelines, linaje a nivel de columna, más de 2,000 iconos reales de herramientas. Los PNG exportados vuelven directamente en el chat.

Este repositorio es el hogar público del servidor MCP remoto en https://datadef.io/mcp (HTTP Streamable). No hay nada que instalar desde aquí — existe para directorios, enlaces de instalación y problemas.

Lo que dibuja — en vivo

El diagrama a continuación no es una captura de pantalla. Es un diagrama público de Datadef incrustado por URL — cuando el diagrama se edita, esta imagen se actualiza con él. Ese es el ciclo para el que existe este servidor: tu agente dibuja y mantiene el diagrama, y cada documento que lo incrusta se mantiene actualizado.

Customer 360 Platform — Identity Resolution and Activation

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

Conectar

Dos formas de acceso — ambas incluidas en la prueba gratuita de 7 días:

  • OAuth (sin clave): agrega https://datadef.io/mcp como conector en Claude o ChatGPT e inicia sesión cuando se te solicite. Claude Code también funciona sin clave: claude mcp add --transport http datadef https://datadef.io/mcp.
  • Clave API (sin interfaz): crea una en datadef.io/settings/mcp y envíala como encabezado Bearer — ideal para CI y scripts.

Claude Code

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

Cursor / Claude Desktop (a través del puente 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) — nota httpUrl, no url; url simple es SSE heredado allí y falla silenciosamente:

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

Los botones de instalación con un clic están en datadef.io/settings/mcp.

Herramientas

Tres capas. A nivel de resultado — describe una intención, el pipeline de Datadef la lleva a cabo: create_diagram, list_diagrams, get_diagram, edit_diagram, export_diagram, get_design_guide. Sincronización de repositorio — repo_status y repo_refresh inspeccionan y vuelven a ejecutar la sincronización que mantiene un diagrama y su architecture.md regenerados desde una rama o etiqueta conectada de GitHub/GitLab/Azure DevOps. Los repositorios de Terraform reciben un pipeline dedicado: cada archivo .tf analizado (sin init, sin estado, sin credenciales de nube), módulos dibujados como zonas, conteos por entorno mantenidos honestos. Atómico — 25 herramientas canvas_* que tu modelo maneja directamente (agregar/actualizar/eliminar nodos, conectar bordes, establecer columnas, agregar linaje, agrupar, alinear, diseñar, validar), para que el agente que ya conoce tu repositorio pueda dibujar lo que encuentra. El prompt datadef_design_guide enseña a cualquier modelo el estándar de diseño antes de dibujar.

initialize y tools/list anónimos están abiertos — apunta cualquier inspector de MCP al endpoint para explorar la superficie antes de crear una clave.

Por qué una herramienta de diagramas quiere un agente

El agente que acaba de cambiar tu proyecto dbt todavía tiene todo el cambio en contexto. Decirle "actualiza también el diagrama de arquitectura" cuesta una oración — y un diagrama incrustado (![arch](https://datadef.io/api/embed/your-diagram)) se actualiza en todos los lugares donde el lienzo lo hace. Los documentos dejan de deteriorarse.

Ejecutar como contenedor

Para clientes o verificadores que quieran una imagen ejecutable, el Dockerfile incluido conecta stdio al servidor alojado:

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

Enlaces