Connectez votre propre IA (MCP)

L’accès IA externe vous permet d’utiliser vos propriétés AIdata depuis votre propre assistant IA - claude.ai, Claude Desktop ou tout client compatible MCP (Model Context Protocol). Votre assistant dispose des mêmes outils de données que le chat intégré, et l’usage est couvert par l’abonnement IA que vous payez déjà. Aucune clé API n’entre en jeu.

Prérequis

Votre équipe est sur une offre Pro ou Business.
Un propriétaire d’équipe a activé l’Accès IA externe dans les Paramètres d’équipe. C’est désactivé par défaut.
Pour claude.ai, les connecteurs personnalisés nécessitent une offre Claude payante. Claude Desktop et les autres clients MCP fonctionnent avec l’offre qu’ils requièrent habituellement.

Mise en place

1. Activer l’accès externe (propriétaire d’équipe, une fois par équipe)

Rendez-vous dans les Paramètres d’équipe et activez l’Accès IA externe. C’est l’interrupteur principal pour toute l’équipe : tant qu’il est désactivé, aucun connecteur de membre ne peut atteindre les propriétés de cette équipe.

2. Récupérer vos informations de connexion personnelles

Allez dans Paramètres → IA connectée et cliquez sur Afficher mes informations de connexion. Vous obtenez trois valeurs :

URL du serveur - le point d’accès MCP d’AIdata, https://app.aidata.stream/mcp/u. Elle est identique pour tout le monde et ne contient aucun secret.
En-tête Authorization - Bearer suivi de votre jeton personnel. C’est ce qui vous identifie.
URL de connexion, sous Clients qui n’acceptent qu’une URL - le même point d’accès avec votre jeton intégré à l’adresse, pour les clients qui n’ont aucun champ pour un en-tête.

Votre jeton est personnel : il vous identifie, couvre chaque propriété à laquelle vous avez accès dans toutes vos équipes, et applique vos permissions sur chaque propriété. Chaque coéquipier reçoit son propre jeton - ne partagez jamais le vôtre.

Traitez le jeton et l’URL comme un mot de passe. Quiconque détient l’un ou l’autre peut lire chaque propriété à laquelle vous avez accès et écrire des annotations en votre nom. En cas de fuite, cliquez sur Régénérer le jeton - chaque copie du jeton et de l’URL cesse immédiatement de fonctionner, sans affecter vos coéquipiers.

3. L’ajouter à votre client IA

Utilisez la forme avec en-tête partout où votre client prend en charge les en-têtes de requête. Le jeton n’apparaît alors jamais dans une URL et reste hors des journaux serveur, des proxys et de l’historique du navigateur.

claude.ai et Claude Desktop : Settings → Connectors → Add custom connector. Donnez-lui un nom (par ex. « AIdata ») et collez l’URL du serveur. Sous Authentication, choisissez No sign-in - claude.ai peut marquer Sign in now comme « Detected », mais ce n’est que sa supposition pour tout serveur qui demande des identifiants ; ce connecteur utilise un jeton, pas OAuth. Choisissez-le en premier : la section OAuth client disparaît et Request headers devient la section des identifiants. Cliquez sur Add header, choisissez authorization comme nom et collez la valeur En-tête Authorization de l’application (Bearer …) comme valeur, laissez Required coché, puis enregistrez.

Claude Code :

claude mcp add --transport http aidata https://app.aidata.stream/mcp/u \
  --header "Authorization: Bearer <votre jeton>"

Cursor et autres clients MCP : ajoutez un serveur MCP distant (HTTP) avec l’URL du serveur et un en-tête de requête Authorization: Bearer <votre jeton>.

Clients qui n’acceptent qu’une URL : collez l’URL de connexion comme URL du serveur à la place. Aucun en-tête n’est nécessaire - l’URL elle-même donne l’accès - mais le jeton voyage dans l’adresse : traitez chaque endroit où vous la collez comme une copie de votre mot de passe.

4. L’utiliser

Dans une conversation, vérifiez que le connecteur est activé dans le menu des outils, puis posez simplement votre question. Bon premier prompt : « Liste mes propriétés AIdata. » L’IA découvrira vos propriétés, verra quelles sources de données chacune a connectées et choisira la bonne pour les questions suivantes.

Se connecter au lieu d’utiliser un jeton

Les clients qui prennent en charge OAuth peuvent se connecter sans copier de jeton. Utilisez l’URL du serveur https://app.aidata.stream/mcp (sans /u) et connectez-vous avec votre compte AIdata lorsque le client vous le demande. AIdata affiche une page de consentement, Autoriser l’accès à AIdata, qui nomme l’application et ce qu’elle pourra faire. Cliquez sur Autoriser l’accès et vous êtes renvoyé vers le client. La connexion dispose alors exactement de l’accès que votre jeton aurait : les mêmes propriétés, les mêmes permissions, les mêmes règles d’écriture.

claude.ai et Claude Desktop : ajoutez le connecteur personnalisé avec cette URL et choisissez Sign in now.
Claude Code : claude mcp add --transport http aidata https://app.aidata.stream/mcp, puis lancez /mcp dans une session et choisissez Authenticate pour aidata. Votre navigateur ouvre la page de consentement.
L’accès prend fin de lui-même après 30 jours sans utilisation ; reconnectez-vous depuis le client pour continuer. Pour arrêter un client plus tôt, supprimez le connecteur dans ce client.
Votre jeton personnel continue de fonctionner en parallèle. Les deux sont indépendants : régénérer le jeton ne déconnecte pas un client connecté.

Seuls les retours vers claude.ai ou vers un client qui tourne sur votre propre ordinateur (comme Claude Code) sont acceptés. Pour tout autre client, utilisez la méthode par jeton ci-dessus.

Ce que votre IA peut faire

Lire tout ce que le chat intégré peut lire : rapports de trafic, positions de recherche, performance publicitaire, pipelines CRM, Core Web Vitals, trafic edge et données de robots d’IA Cloudflare, annotations et base de connaissances de chaque propriété connectée.
Exécuter vos compétences : les compétences apparaissent dans le menu de prompts de votre client, et l’IA peut aussi les lister et les récupérer elle-même - demandez une compétence par son nom et elle suit votre méthode à la lettre.
Écrire des annotations : sur les propriétés où vous avez la permission d’écriture, l’IA peut créer et modifier des annotations personnalisées, attribuées à vous et visibles par votre équipe dans l’application.
Sauvegarder des mémoires d’équipe : sur les propriétés où la mémoire est activée et où vous avez la permission d’écriture.

Tout le reste est en lecture seule. Le connecteur ne peut jamais rien modifier dans vos plateformes connectées - il ne peut pas toucher aux réglages Google Analytics, éditer des campagnes ou modifier votre site WordPress.

Permissions et sécurité

Vos permissions vous suivent. Le connecteur ne voit que les propriétés auxquelles vous avez accès, et les permissions par propriété (lecture/écriture/admin) s’appliquent à chaque appel - l’IA connaît votre niveau de permission sur chaque propriété.
Interrupteur d’équipe. Si un propriétaire d’équipe désactive l’Accès IA externe, les propriétés de cette équipe disparaissent instantanément du connecteur de chaque membre, sans invalider les URL. La réactivation rétablit l’accès.
Rotation personnelle. Régénérer votre jeton invalide définitivement votre ancien jeton et votre URL de connexion partout où vous les avez utilisés. Verrouillage total pour une équipe = chaque membre régénère, le propriétaire désactive.
Quitter une équipe retire automatiquement ses propriétés de votre connecteur.

À propos des outils facturés

Certains outils coûtent de l’argent à l’appel - par exemple les analyses de backlinks DataForSEO. Ils sont facturés à l’équipe qui possède la propriété transmise par l’IA, et l’IA a pour instruction de vous dire quelle connexion de propriété elle utilise quand elle analyse un domaine qui n’est pas le site de cette propriété. Les administrateurs de connexion peuvent restreindre les analyses à des domaines précis dans les réglages des connexions DataForSEO et PageSpeed (« domaines autorisés »).

Quand le chat intégré est meilleur

Le connecteur est idéal pour des questions rapides depuis là où vous travaillez déjà. Le chat intégré reste plus affûté pour les analyses lourdes - il stocke les résultats volumineux dans une base de données par conversation et exécute du vrai SQL dessus - et les rapports, leur historique et le partage vivent dans l’application. Voir l’article d’annonce pour une comparaison honnête.

Dépannage

« External MCP access is not enabled for any of your teams » - aucune de vos équipes ne combine une offre Pro/Business et l’Accès IA externe activé. Demandez à un propriétaire d’équipe de l’activer dans les Paramètres d’équipe.
Une propriété manque - soit son équipe a désactivé l’accès externe, soit vous n’avez pas accès à cette propriété dans l’application. Le connecteur ne montre jamais plus que l’application.
« Unauthorized MCP access », ou le client indique qu’une connexion est requise - l’URL du serveur a été ajoutée sans l’en-tête Authorization, ou la valeur de l’en-tête est incorrecte. Elle doit être Bearer suivi de votre jeton complet, exactement comme affiché dans Paramètres → IA connectée. Si vous avez régénéré votre jeton, mettez l’en-tête à jour partout où vous l’avez ajouté.
L’IA n’utilise pas le connecteur - vérifiez qu’il est activé dans le menu des outils du chat, et demandez explicitement (« utilise AIdata pour… ») la première fois.
Les écritures sont refusées - les annotations et mémoires nécessitent la permission d’écriture sur la propriété ; demandez à un admin d’équipe de vous l’accorder.
La connexion échoue avec « invalid_client » - le client a envoyé une adresse de retour qu’AIdata n’autorise pas. Seuls claude.ai et les clients qui tournent sur votre propre ordinateur (comme Claude Code) peuvent se connecter ; utilisez la méthode par jeton pour tout le reste.