DataFast MCP

Comienza con MCP

Conecta tu asistente de IA a DataFast para consultar tráfico, ingresos y objetivos personalizados, o gestionar operaciones del sitio web que autorices. Necesitas una cuenta de DataFast con acceso a la API.

Elige cómo conectarte

Elige un método. Ambos utilizan HTTP Streamable para comunicarse con DataFast.

• Iniciar sesión con OAuth — recomendado para clientes que ofrecen inicio de sesión con OAuth, incluidos Codex y Claude Code. Selecciona sitios web y permisos en DataFast; el cliente gestiona su token de conexión automáticamente. No creas ni copias una clave de API.
• Usar un token de API — para clientes que solicitan un token Bearer. Crea un token de cuenta con alcance en DataFast y agrégalo a la configuración de tu cliente.

Ambos métodos ofrecen las mismas herramientas de DataFast. Los permisos de OAuth te permiten aprobar análisis, administración del sitio web, acciones de cuenta y gestión de credenciales por separado. Consulta la referencia de herramientas para ver qué admite cada método.

Conéctate con OAuth

1. Agrega DataFast a tu cliente

Agrega un servidor MCP remoto con la URL a continuación y elige OAuth o Iniciar sesión.

https://datafa.st/api/mcp

Para Codex, agrega el servidor y completa el inicio de sesión en el navegador:

codex mcp add datafast --url https://datafa.st/api/mcp

Para iniciar sesión nuevamente más tarde, ejecuta codex mcp login datafast. Se admiten tanto documentos de metadatos del cliente como registro dinámico, incluidos los callbacks de bucle local. Si DataFast ya está configurado con un token Bearer, elimina esa credencial de la configuración de DataFast del cliente antes de cambiar a OAuth.

Para Claude Code, agrega el servidor, luego abre /mcp dentro de Claude Code y autentica DataFast:

claude mcp add --transport http datafast https://datafa.st/api/mcp

2. Inicia sesión y aprueba el acceso

1. Inicia sesión en datafa.st con tu cuenta de DataFast existente.
2. Selecciona los sitios web a los que este cliente puede acceder.
3. Revisa los permisos solicitados. Los permisos de lectura están seleccionados por defecto; habilita las escrituras solo si deseas que el cliente realice esos cambios.
4. Selecciona Permitir acceso para volver a tu cliente.

DataFast emite al cliente un token de acceso para esa conexión. El cliente lo almacena y lo renueva automáticamente mientras la conexión siga siendo válida. Tu contraseña de DataFast, la sesión del panel y las claves de API existentes no se comparten con el cliente.

3. Pruébalo

Inicia una conversación con DataFast habilitado y pregunta:

Enumera mis sitios web disponibles, luego muestra visitantes e ingresos de mi sitio web durante los últimos siete días.

Confirma el sitio web y el rango de fechas antes de continuar. Tu plan y permisos siguen aplicándose.

Gestiona o revoca la conexión en Configuración → API / MCP → Aplicaciones conectadas. Vuelve a conectarte cuando DataFast te pida aprobar el acceso nuevamente, o cuando quieras compartir diferentes sitios web o permisos.

Conéctate con un token de API

Usa este método cuando tu cliente solicite una clave de API o un token Bearer. Para MCP, comienza con un token de acceso de cuenta, que comienza con dft_.

1. Crea un token de cuenta

1. Abre Configuración de cuenta → API / MCP.
2. En Nuevo token de acceso, elige Sitios web específicos para restringir el acceso, o Todos los sitios web si eso es lo que tu flujo de trabajo necesita.
3. Selecciona solo los permisos que necesitas. Para una conexión de análisis, comienza con Sitios web → Lectura y Análisis → Lectura, con todos los demás permisos deshabilitados.
4. Dale al token un nombre reconocible, selecciona Crear token y copia el valor de dft_. Solo se muestra una vez.### 2. Agrega el token a tu cliente

Usa https://datafa.st/api/mcp y envía el token como un encabezado Authorization: Bearer …. Mantenlo en la configuración de credenciales del cliente o en una variable de entorno, fuera del control de versiones y de los mensajes de chat.

Codex: haz que tu token esté disponible como la variable de entorno DATAFAST_TOKEN, luego ejecuta:

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

Claude Code: reemplaza dft_xxx con tu token:

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

Cursor: agrega esta entrada a tu mcp.json. Haz que DATAFAST_TOKEN esté disponible en el entorno de Cursor; Cursor expande la variable de entorno al conectarse.

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

Otros clientes: ingresa la URL del servidor y el token Bearer en su configuración remota de MCP. Los clientes que solo admiten servidores stdio locales necesitan un puente como mcp-remote.

3. Pruébalo y gestiona el acceso

Pide a tu cliente que enumere tus sitios web disponibles, luego solicita visitantes e ingresos para un sitio web durante los últimos siete días.

Gestiona el token en Tus tokens de acceso en Configuración de cuenta → API / MCP. Usa Editar permisos para cambiar lo que puede hacer, Rotar para reemplazar su secreto, o Eliminar para revocarlo. Después de rotar un token, actualiza el valor en tu cliente.

¿Ya tienes una clave de API de sitio web df_? El endpoint general de MCP también las acepta, con acceso vinculado a ese sitio web. Consulta Autenticación de API para las operaciones que admite. También puedes restringir un token de cuenta a un solo sitio web usando Sitios web específicos arriba.

Cómo se limita el acceso

Ambos métodos otorgan al cliente una credencial secreta. OAuth automatiza la emisión y renovación de esa credencial después de tu consentimiento; un token de API es una credencial que creas y configuras tú mismo.

DataFast verifica la credencial, la acción permitida, el acceso al sitio web, la membresía actual y las restricciones aplicables de cuenta o plan en el servidor. Un ID de sitio web en una solicitud de herramienta es un objetivo a verificar, no una prueba de acceso. Por ejemplo, una conexión OAuth aprobada para leer el Sitio A no puede leer el Sitio B ni editar el Sitio A.

Las conexiones OAuth acceden solo a los sitios web aprobados. Un sitio web creado a través de una herramienta OAuth aprobada se agrega a esa conexión; los sitios web agregados en otro lugar no se comparten automáticamente. Los tokens OAuth expiran después de una hora, se renuevan automáticamente hasta 30 días desde su emisión y requieren consentimiento nuevo después de un máximo de 90 días. Los tokens de cuenta creados en el panel siguen siendo válidos hasta que los rotes o elimines, sujetos a tu acceso y permisos de cuenta. Las claves de API y los tokens de cuenta emitidos a través de OAuth también dependen de que la conexión original siga siendo válida.

Los tokens OAuth funcionan solo en el endpoint MCP para el que fueron emitidos. No se pueden pegar en la API REST pública ni usarse para iniciar sesión en el panel de DataFast. Los tokens de cuenta también funcionan con los endpoints de API REST admitidos.

Seguridad

• Comienza con acceso limitado. Dale al cliente solo los sitios web y permisos que necesita. Las acciones de cuenta, la gestión de credenciales y los detalles completos de visitantes requieren permisos OAuth separados que están desactivados por defecto.
• Revisa los cambios. Las herramientas de escritura OAuth requieren confirmación y una clave de reintento. Las herramientas de token de API requieren confirmación para operaciones sensibles como eliminar datos o emitir credenciales. Estas verificaciones complementan la interfaz de confirmación del cliente; no reemplazan la elección de un cliente confiable.
• Mantén las credenciales privadas. Ambos métodos usan tokens Bearer: alguien que obtenga un token válido puede usar su acceso permitido hasta que expire o sea revocado. Nunca pongas credenciales en URLs, control de versiones o mensajes de chat.
• Desconéctate cuando sea necesario. Revocar una conexión OAuth bloquea solicitudes y renovaciones posteriores. Una solicitud ya en ejecución puede finalizar, y los datos ya compartidos con la otra aplicación no se eliminan con la revocación.
• Las operaciones solo del panel permanecen en el panel. MCP no puede eliminar sitios web ni conectar/desconectar proveedores de pago.