DataFast MCP

oficial

El servidor DataFast MCP permite que clientes compatibles con MCP, como Codex, Claude Code y Cursor, consulten tus análisis y administren tu cuenta mediante lenguaje natural.

¿Qué puedes hacer con DataFast MCP?

  • Descripción general de análisis — Solicita métricas de todo el sitio, como visitantes, páginas vistas y tendencias, mediante datafast_analytics_overview.
  • Listar sitios web — Recupera todos los sitios web a los que tu token tiene acceso con datafast_websites_list para consulta rápida.
  • Gestionar objetivos y embudos — Crea, actualiza o inspecciona objetivos de conversión y embudos para rastrear los recorridos de los usuarios.
  • Revisar detalles de visitantes — Extrae sesiones individuales de visitantes y datos de comportamiento para un análisis más profundo.
  • Verificar estado de integraciones — Comprueba si las integraciones de pago u otras están conectadas, sin exponer credenciales.
  • Vista previa de acciones sensibles — Solicita una vista previa de prueba de operaciones irreversibles, como eliminaciones o acuñación de claves, antes de confirmar con confirm: true.

Documentación

Servidor MCP de DataFast

El servidor MCP de DataFast permite que clientes compatibles con MCP, como Codex, Claude Code y Cursor, consulten tus análisis y administren tu cuenta mediante lenguaje natural. Proporciona la misma funcionalidad, permisos y controles de seguridad que la API REST y la CLI.

Utiliza HTTP Streamable en https://datafa.st/api/mcp.

Paso 1 — Crear un token de cuenta

Abre Configuración de cuenta → API / MCP, elige qué sitios web y permisos puede acceder el cliente, y luego crea un token. Copia el token dft_ cuando aparezca: lo usarás en el siguiente paso y solo se muestra una vez.

Where to create a DataFast account token

Cada solicitud MCP utiliza los permisos y el acceso a sitios web que seleccionaste para el token.

Paso 2 — Conecta tu cliente

Codex

Guarda el token copiado en una variable de entorno DATAFAST_TOKEN, y luego agrega DataFast:

codex mcp add datafast \
  --url https://datafa.st/api/mcp \
  --bearer-token-env-var DATAFAST_TOKEN

Claude Code

claude mcp add --transport http datafast https://datafa.st/api/mcp \
  --header "Authorization: Bearer dft_xxx"

Cursor, Claude Desktop y otros clientes basados en configuración

{
  "mcpServers": {
    "datafast": {
      "url": "https://datafa.st/api/mcp",
      "headers": {
        "Authorization": "Bearer dft_xxx"
      }
    }
  }
}

Clientes que solo admiten stdio

Conecta con mcp-remote:

{
  "mcpServers": {
    "datafast": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://datafa.st/api/mcp",
        "--header",
        "Authorization: Bearer dft_xxx"
      ]
    }
  }
}

Herramientas

Consulta la referencia completa de herramientas: análisis, sitios web, claves API, equipo, objetivos, embudos, visitantes, alertas, cuenta, tokens de acceso y estado de integración. Los nombres de las herramientas siguen datafast_<resource>_<action>, p. ej. datafast_analytics_overview, datafast_websites_list.

Seguridad

  • Puerta de confirmación: las herramientas irreversibles o que emiten credenciales (eliminar, rotar, generar claves/tokens API) requieren un argumento confirm: true explícito. Llamarlas sin él devuelve una vista previa de lo que sucedería en lugar de ejecutarlo, de modo que un agente no puede disparar una acción sensible en el primer intento.
  • Sin exfiltración de secretos: los endpoints de listado de claves API y tokens de acceso nunca devuelven valores secretos, solo metadatos (id, nombre, prefijo, fechas), igual que la API REST.
  • La eliminación de sitios web solo está disponible en el panel: no existe una herramienta MCP para eliminar un sitio web; la eliminación no se puede automatizar por diseño.
  • La conexión/desconexión de pagos solo está disponible en el panel: MCP puede informar el estado de integración, pero conectar o desconectar proveedores de pago (y manejar sus credenciales) permanece en el panel.
  • Delimitado por token, no por herramienta: cada llamada a una herramienta vuelve a validar los permisos contra la ruta real: el transporte resuelve el portador una vez por solicitud y luego reutiliza ese resultado para la autenticación en proceso (sin privilegios elevados exclusivos de MCP).

Avanzado: Limitar MCP a un solo sitio web

Para una configuración más restringida, usa una clave API de sitio web df_ en lugar de un token de cuenta. Esto limita el cliente a un solo sitio web y a análisis mayormente de solo lectura. Créala desde la página Configuración → API / MCP de ese sitio web y consulta autenticación y alcances para más detalles.