DataFast MCP

Commencer avec MCP

Connectez votre assistant IA à DataFast pour poser des questions sur le trafic, les revenus et les objectifs personnalisés, ou pour gérer les opérations du site web que vous autorisez. Vous avez besoin d'un compte DataFast avec accès à l'API.

Choisissez comment vous connecter

Choisissez une méthode. Les deux utilisent Streamable HTTP pour communiquer avec DataFast.

• Se connecter avec OAuth — recommandé pour les clients qui proposent la connexion OAuth, y compris Codex et Claude Code. Sélectionnez les sites web et les autorisations sur DataFast ; le client gère automatiquement son jeton de connexion. Vous ne créez ni ne copiez de clé API.
• Utiliser un jeton API — pour les clients qui demandent un jeton Bearer. Créez un jeton de compte à portée limitée dans DataFast et ajoutez-le à la configuration de votre client.

Les deux méthodes offrent les mêmes outils DataFast. Les autorisations OAuth vous permettent d'approuver séparément les analyses, l'administration du site web, les actions de compte et la gestion des identifiants. Consultez la référence des outils pour savoir ce que chaque méthode prend en charge.

Se connecter avec OAuth

1. Ajouter DataFast à votre client

Ajoutez un serveur MCP distant avec l'URL ci-dessous et choisissez OAuth ou Se connecter.

https://datafa.st/api/mcp

Pour Codex, ajoutez le serveur et terminez la connexion dans le navigateur :

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

Pour vous reconnecter plus tard, exécutez codex mcp login datafast. Les documents de métadonnées client et l'enregistrement dynamique sont pris en charge, y compris les rappels en boucle locale. Si DataFast est déjà configuré avec un jeton Bearer, supprimez cet identifiant de la configuration DataFast du client avant de passer à OAuth.

Pour Claude Code, ajoutez le serveur, puis ouvrez /mcp dans Claude Code et authentifiez DataFast :

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

2. Se connecter et approuver l'accès

1. Connectez-vous sur datafa.st avec votre compte DataFast existant.
2. Sélectionnez les sites web auxquels ce client peut accéder.
3. Examinez les autorisations demandées. Les autorisations de lecture sont sélectionnées par défaut ; activez les écritures uniquement si vous souhaitez que le client effectue ces modifications.
4. Sélectionnez Autoriser l'accès pour revenir à votre client.

DataFast délivre au client un jeton d'accès pour cette connexion. Le client le stocke et le renouvelle automatiquement tant que la connexion reste valide. Votre mot de passe DataFast, votre session de tableau de bord et vos clés API existantes ne sont pas partagés avec le client.

3. Essayer

Commencez une conversation avec DataFast activé et demandez :

Listez mes sites web disponibles, puis affichez les visiteurs et les revenus de mon site web sur les sept derniers jours.

Confirmez le site web et la plage de dates avant de continuer. Votre plan et vos autorisations s'appliquent toujours.

Gérez ou révoquez la connexion sous Paramètres → API / MCP → Applications connectées. Reconnectez-vous lorsque DataFast vous demande d'approuver à nouveau l'accès, ou lorsque vous souhaitez partager différents sites web ou autorisations.

Se connecter avec un jeton API

Utilisez cette méthode lorsque votre client demande une clé API ou un jeton Bearer. Pour MCP, commencez avec un jeton d'accès de compte, qui commence par dft_.

1. Créer un jeton de compte

1. Ouvrez Paramètres du compte → API / MCP.
2. Sous Nouveau jeton d'accès, choisissez Sites web spécifiques pour restreindre l'accès, ou Tous les sites web si c'est ce dont votre flux de travail a besoin.
3. Sélectionnez uniquement les autorisations dont vous avez besoin. Pour une connexion d'analyse, commencez par Sites web → Lecture et Analyses → Lecture, avec toutes les autres autorisations désactivées.
4. Donnez au jeton un nom reconnaissable, sélectionnez Créer le jeton, et copiez la valeur dft_. Elle n'est affichée qu'une seule fois.

2. Ajouter le jeton à votre client

Utilisez https://datafa.st/api/mcp et envoyez le jeton comme en-tête Authorization: Bearer …. Conservez-le dans les paramètres d'identifiants du client ou dans une variable d'environnement, hors du contrôle de version et des messages de discussion.

Codex : rendez votre jeton disponible en tant que variable d'environnement DATAFAST_TOKEN, puis exécutez :

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

Claude Code : remplacez dft_xxx par votre jeton :

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

Cursor : ajoutez cette entrée à votre mcp.json. Rendez DATAFAST_TOKEN disponible dans l'environnement de Cursor ; Cursor développe la variable d'environnement lors de la connexion.

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

Autres clients : saisissez l'URL du serveur et le jeton Bearer dans leurs paramètres MCP distants. Les clients qui ne prennent en charge que les serveurs stdio locaux nécessitent un pont tel que mcp-remote.

3. Essayer et gérer l'accès

Demandez à votre client de lister vos sites web disponibles, puis demandez les visiteurs et les revenus pour un site web sur les sept derniers jours.

Gérez le jeton sous Vos jetons d'accès dans Paramètres du compte → API / MCP. Utilisez Modifier les autorisations pour changer ce qu'il peut faire, Régénérer pour remplacer son secret, ou Supprimer pour le révoquer. Après avoir régénéré un jeton, mettez à jour la valeur dans votre client.

Vous avez déjà une clé API de site web df_ ? Le point de terminaison MCP général les accepte également, avec un accès lié à ce site web. Consultez Authentification API pour les opérations prises en charge. Vous pouvez également restreindre un jeton de compte à un seul site web en utilisant Sites web spécifiques ci-dessus.

Comment l'accès est limité

Les deux méthodes donnent au client un identifiant secret. OAuth automatise l'émission et le renouvellement de cet identifiant après votre consentement ; un jeton API est un identifiant que vous créez et configurez vous-même.

DataFast vérifie l'identifiant, l'action autorisée, l'accès au site web, l'adhésion actuelle et les restrictions applicables au compte ou au plan sur le serveur. Un identifiant de site web dans une demande d'outil est une cible à vérifier, pas une preuve d'accès. Par exemple, une connexion OAuth approuvée pour lire le site web A ne peut pas lire le site web B ni modifier le site web A.

Les connexions OAuth n'accèdent qu'aux sites web approuvés. Un site web créé via un outil OAuth approuvé est ajouté à cette connexion ; les sites web ajoutés ailleurs ne sont pas partagés automatiquement. Les jetons OAuth expirent après une heure, se renouvellent automatiquement jusqu'à 30 jours à compter de l'émission et nécessitent un nouveau consentement après au plus 90 jours. Les jetons de compte créés dans le tableau de bord restent valides jusqu'à ce que vous les régénériez ou les supprimiez, sous réserve de votre accès et de vos autorisations de compte. Les clés API et les jetons de compte émis via OAuth dépendent également de la validité de la connexion d'origine.

Les jetons OAuth ne fonctionnent qu'au point de terminaison MCP pour lequel ils ont été émis. Ils ne peuvent pas être collés dans l'API REST publique ni utilisés pour se connecter au tableau de bord DataFast. Les jetons de compte fonctionnent également avec les points de terminaison d'API REST pris en charge.

Sécurité

• Commencez avec un accès limité. Donnez au client uniquement les sites web et les autorisations dont il a besoin. Les actions de compte, la gestion des identifiants et les détails complets des visiteurs nécessitent des autorisations OAuth distinctes qui sont désactivées par défaut.
• Examinez les modifications. Les outils d'écriture OAuth nécessitent une confirmation et une clé de nouvelle tentative. Les outils à jeton API nécessitent une confirmation pour les opérations sensibles telles que la suppression de données ou l'émission d'identifiants. Ces vérifications complètent l'interface de confirmation du client ; elles ne remplacent pas le choix d'un client digne de confiance.
• Gardez les identifiants privés. Les deux méthodes utilisent des jetons Bearer : toute personne qui obtient un jeton valide peut utiliser son accès autorisé jusqu'à son expiration ou sa révocation. Ne mettez jamais les identifiants dans les URL, le contrôle de version ou les messages de discussion.
• Déconnectez-vous si nécessaire. La révocation d'une connexion OAuth bloque les demandes et les renouvellements ultérieurs. Une demande déjà en cours peut se terminer, et les données déjà partagées avec l'autre application ne sont pas supprimées par la révocation.
• Les opérations réservées au tableau de bord restent dans le tableau de bord. MCP ne peut pas supprimer des sites web ni connecter/déconnecter des fournisseurs de paiement.