# Connectez votre propre IA (MCP)

Utilisez vos propriétés AIdata depuis claude.ai, Claude Desktop ou tout client IA compatible MCP avec une seule URL de connexion personnelle.

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](https://modelcontextprotocol.io) (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 votre URL personnelle

Allez dans **Paramètres → Connected AI** et cliquez sur **Afficher mon URL de connexion**.

Cette URL est **personnelle** : elle 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 sa propre URL - ne partagez jamais la vôtre.

> **Traitez l'URL comme un mot de passe.** Quiconque la détient 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 cesse immédiatement de fonctionner, sans affecter vos coéquipiers.

### 3. L'ajouter à votre client IA

Dans **claude.ai** ou **Claude Desktop** : **Settings → Connectors → Add custom connector**. Donnez-lui un nom (par ex. « AIdata »), collez votre URL comme URL du serveur et enregistrez. Aucune connexion supplémentaire n'est nécessaire - l'URL elle-même donne l'accès.

Autres clients MCP : ajoutez un serveur MCP distant et collez la même URL.

### 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.

## 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, 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 ancienne URL partout où vous l'avez collée. 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](/fr/blog/connect-your-own-ai-mcp/) 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.
- **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.