> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/fr/developpeurs/faq.md). # FAQ Questions fréquentes sur AirOps MCP, le plugin Codex et le connecteur Claude ## Premiers pas ### Qu'est-ce que le connecteur Claude d'AirOps ? Le connecteur Claude d'AirOps vous permet d'accéder directement à vos données AEO (AI Engine Optimization) depuis les conversations Claude. Au lieu de passer de Claude au tableau de bord AirOps, posez à Claude des questions comme "Comment ma marque performe-t-elle dans la recherche IA ?" et obtenez des informations instantanées. Retrouvez-le dans le [Répertoire des connecteurs](https://claude.ai/settings/connectors): cliquez **« Recherche et outils »** dans votre chat et sélectionnez **« Ajouter des connecteurs »**, ou allez à **Paramètres → Connecteurs → Parcourir les connecteurs**. Recherchez "AirOps", cliquez sur Connecter et authentifiez-vous avec votre compte AirOps. ### Que puis-je faire avec AirOps dans Claude ? * **Surveiller la visibilité IA** — Vérifier le taux de mention, le taux de citation, la part de voix * **Analyser les concurrents** — Comparer les performances sur les différentes plateformes IA * **Trouver des opportunités** — Découvrir les pages qui perdent des citations ou sont proches du classement * **Créer des rapports** — Générer des tableaux de bord enregistrés pour les parties prenantes * **Suivre par fournisseur** — Comparer ChatGPT, Perplexity, Gemini et Claude * **Explorer les prompts** — Trouver des questions IA où vous êtes mentionné ou non * **Gérer l'identité de la marque** — Mettre à jour le nom de la marque, le ton rédactionnel, la persona et le style * **Configurer les entités de la marque** — Gérer les gammes de produits, les audiences, les régions, les types de contenu, les règles rédactionnelles et les concurrents * **Rechercher dans les bases de connaissances** — Trouver du contenu pertinent dans vos documents ### Quelle est la différence entre le connecteur Claude et MCP ? **Connecteur Claude** est l'intégration native dans le répertoire des connecteurs de Claude : * Configuration en un clic * Applications interactives (graphiques rendus dans la conversation) * OAuth automatique **MCP** est le protocole sous-jacent. Utilisez-le pour Cursor, VS Code, Windsurf ou Claude Code : * Configuration manuelle * Les mêmes outils, une configuration différente | Fonctionnalité | Connecteur Claude | MCP | | ------------------------- | --------------------- | ------------------------- | | Configuration | En un clic | Manuel | | Applications interactives | Oui | Dépend du client | | Idéal pour | Claude Web et Desktop | Cursor, VS Code, Windsurf | ### Quelles applications Claude prennent en charge AirOps ? | Application | Méthode de connexion | Applications interactives | | -------------- | -------------------- | ------------------------- | | Codex | plugin AirOps MCP | Oui | | Claude Web | Connecteur Claude | Oui | | Claude Desktop | Connecteur Claude | Oui | | Claude Code | MCP | Non | ### De quels abonnements ai-je besoin ? **AirOps :** Un espace de travail payant, y compris un essai éligible de niveau payant. Les requêtes Insights nécessitent également AEO activé et un Brand Kit configuré. Les espaces de travail gratuits peuvent se connecter et utiliser `list_workspaces`, mais les outils de ressources renvoient une restriction liée à l'abonnement. **Claude :** Pro, Team ou Enterprise. Le forfait gratuit ne prend pas en charge les connecteurs. *** ## Applications interactives ### Que sont les applications interactives ? Certains plugins et connecteurs affichent des interfaces interactives en direct dans votre conversation ou votre tâche au lieu de renvoyer uniquement du texte. Vous pouvez consulter le graphique ou l'interface de révision directement là où vous travaillez. Dans Codex, installez et sélectionnez le plugin AirOps pour utiliser ses applications interactives. Dans Claude, les connecteurs dotés de cette fonctionnalité affichent un **badge « Interactif »** dans le répertoire. ### AirOps prend-il en charge les applications interactives ? Oui. Lorsque vous posez des questions sur les tendances ou les métriques, AirOps peut afficher : * **Graphiques en courbes** pour les tendances au fil du temps * **Graphiques à barres** pour les comparaisons * **Cartes KPI** pour les métriques actuelles * **Tableaux de données** pour des données détaillées ### Pourquoi ne vois-je pas de visualisations ? 1. **Vérifiez votre connexion :** Dans Codex, sélectionnez AirOps sous **Sources → Utiliser les plugins**. Dans Claude, vérifiez qu'AirOps est connecté sous **Paramètres → Connecteurs**. 2. **Vérifiez l'accès :** Confirmez que votre compte peut accéder au Brand Kit AirOps et aux données demandés. 3. **Soyez explicite :** Essayez « Montrez-moi un graphique de l'évolution de mon taux de mention. » 4. **Reconnectez-vous :** Reconnectez AirOps, puis lancez une nouvelle conversation ou tâche. *** ## Connexion ### Comment connecter Claude (web/bureau) ? 1. Allez à **Paramètres → Connecteurs** 2. Recherchez **« AirOps »** 3. Cliquez sur **Connecter** 4. Connectez-vous avec votre compte AirOps ### Comment connecter Claude Code ? ```bash claude mcp add --transport http airops https://app.airops.com/mcp ``` Puis authentifiez-vous : 1. Exécutez `/mcp` dans Claude Code 2. Sélectionnez le serveur AirOps 3. Choisissez **S’authentifier** 4. Terminez l'OAuth dans votre navigateur ### Ai-je besoin d'une clé API ? Non. Le connecteur utilise OAuth — vous vous connectez avec votre compte AirOps et Claude s'occupe du reste. Aucune clé API ni jeton à gérer. ### Comment savoir si je suis connecté ? Dans Claude web/bureau : * Allez à **Paramètres → Connecteurs** * AirOps doit apparaître comme « Connecté » Vous pouvez aussi vérifier en demandant à Claude : ``` « À quels brand kits ai-je accès dans AirOps ? » ``` Si Claude renvoie la liste de vos Brand Kits, vous êtes connecté. ### Comment me déconnecter ou me reconnecter ? **Pour vous déconnecter :** 1. Allez à **Paramètres → Connecteurs** 2. Trouvez AirOps 3. Cliquez sur **Déconnecter** **Pour vous reconnecter :** Suivez à nouveau les étapes de connexion. Si vous rencontrez des problèmes, déconnectez-vous d'abord pour effacer l'authentification mise en cache. ### Comment l'authentification est-elle gérée ? 1. Vous cliquez sur **Connecter** dans Claude 2. Claude vous redirige vers AirOps 3. Vous vous connectez avec vos identifiants AirOps 4. AirOps émet un jeton OAuth à l'intention de Claude 5. Claude utilise ce jeton pour les requêtes 6. Les jetons se renouvellent automatiquement — pas besoin de se réauthentifier Aucun mot de passe ni clé API n'est stocké dans Claude. Vous pouvez révoquer l'accès à tout moment en vous déconnectant. *** ## Cas d’usage ### Comment vérifier ma visibilité IA ? ``` « Comment ma marque performe-t-elle dans la recherche IA ? » « Quel est mon taux de mention sur les 30 derniers jours ? » « Montrez-moi les tendances de visibilité IA sur les 2 derniers mois » ``` ### Comment me comparer aux concurrents ? ``` « Comment me comparer aux concurrents ? » « Quelle est ma part de voix par rapport à Clari ? » « Quels concurrents obtiennent plus de citations ? » ``` ### Comment suivre par fournisseur d'IA ? ``` « Comment suis-je performant sur ChatGPT par rapport à Perplexity et Gemini ? » « Quel fournisseur IA mentionne le plus ma marque ? » ``` ### Comment trouver des opportunités d'optimisation ? ``` « Quelles pages perdent des citations IA ? » « Trouvez les pages proches du classement dans les réponses IA » « Montrez-moi les prompts à fort volume où je ne suis pas mentionné » ``` ### Comment créer des rapports ? ``` « Créez un rapport résumant les performances de visibilité IA » « Enregistre un rapport que je peux partager avec mon équipe » ``` Les rapports sont enregistrés dans AirOps et Claude renvoie un lien partageable. ### Comment créer des grilles d'actions ? ``` « Créez une grille d'actions pour les pages qui perdent en visibilité » « Mets en place une grille pour optimiser ces pages » ``` Claude crée une grille dans AirOps avec vos pages, prête pour des agents avancés. Voir [Cas d’usage](/docs/fr/developpeurs/use-cases.md) pour plus d'exemples et de bonnes pratiques. *** ## Bonnes pratiques ### Quelles sont les meilleures questions à poser ? **Soyez précis sur le périmètre :** * Bien : « Montrez-moi les pages qui ont perdu des citations au cours des 30 derniers jours » * Moins bien : « Montrez-moi toutes mes données » **Procédez progressivement :** 1. « Comment suis-je globalement performant ? » 2. « Dans quels sujets suis-je le plus fort ? » 3. « Montre-moi les meilleures pages dans ce sujet » **Précisez les plages de temps :** * « Compare ce mois au mois dernier » * « Montre-moi la tendance sur les 8 dernières semaines » **Posez des questions orientées résultats :** * « Que dois-je optimiser en premier ? » * « Où est-ce que je perds face à mes concurrents ? » * « Quelles sont mes plus grandes opportunités ? » ### Comment sélectionner un Brand Kit ? Si vous avez plusieurs Brand Kits, indiquez-les par nom : ``` « Comment Gong performe-t-il dans la recherche IA ? » « Utilise le Brand Kit d’Acme Corp » ``` Ou demandez : « À quels brand kits ai-je accès ? » Claude mémorise votre sélection pour la conversation. ### Puis-je effectuer des actions ou seulement lire les données ? Les deux. Vous pouvez : * **Créer des rapports** — Enregistrer dans AirOps avec des liens partageables * **Créer des grilles d’action** — Organiser les pages pour l'optimisation * **Obtenir des liens directs** — Accéder directement aux pages, rapports et grilles dans AirOps *** ## Outils ### Quels outils sont disponibles ? **Espace de travail et Brand Kit :** | Outil | Description | | ----------------------- | ---------------------------------------------------------------------------- | | `list_workspaces` | Lister les espaces de travail auxquels vous avez accès | | `list_brand_kits` | Lister les Brand Kits avec les indicateurs AEO et de gestion de marque | | `get_brand_kit` | Obtenir l'identité de marque, le style rédactionnel et les entités associées | | `get_insights_settings` | Obtenir la configuration AEO (concurrents, personas, nombre de prompts) | | `update_brand_kit` | Mettre à jour le nom de la marque, l'URL, le ton rédactionnel, la persona | | `publish_brand_kit` | Publier les modifications du brouillon pour les rendre actives | | `get_legacy_brand_kit` | Obtenir le Brand Kit hérité pour les flux de migration | **Gestion du Brand Kit :** | Outil | Description | | ---------------------------------- | --------------------------------------------------- | | `manage_brand_kit_product_line` | Créer ou mettre à jour les gammes de produits | | `manage_brand_kit_competitor` | Créer ou mettre à jour les concurrents | | `manage_brand_kit_audience` | Créer ou mettre à jour les audiences | | `manage_brand_kit_region` | Créer ou mettre à jour les régions | | `manage_brand_kit_content_type` | Créer ou mettre à jour les types de contenu | | `manage_brand_kit_content_sample` | Créer ou mettre à jour des exemples de contenu | | `manage_brand_kit_writing_rule` | Créer ou mettre à jour les règles rédactionnelles | | `manage_brand_kit_custom_variable` | Créer ou mettre à jour les variables personnalisées | Les modifications du Brand Kit utilisent `update_brand_kit` et `manage_brand_kit_*` après confirmation de l'utilisateur. Elles restent en brouillon jusqu'à ce que l'utilisateur confirme explicitement `publish_brand_kit`. Voir [Modifier un brouillon de Brand Kit](/docs/fr/developpeurs/tools.md#edit-a-brand-kit-draft). **Analytique AEO :** | Outil | Description | | -------------------------- | --------------------------------------------------------------------------------- | | `list_aeo_prompts` | Prompts IA suivis pour un Brand Kit | | `get_prompt_answers` | Réponses IA pour un prompt spécifique | | `get_answer` | Réponse IA complète avec citations et mentions | | `list_aeo_citations` | URL citées dans les réponses IA | | `get_aeo_citation` | Détails pour une URL citée spécifique | | `list_aeo_domains` | Domaines cités dans les réponses IA | | `list_pages` | Pages avec les compteurs AEO, GSC, GA4 et Agent Analytics | | `list_aeo_agent_analytics` | Comptes quotidiens de crawl et de visites d'agents IA par moteur et type de crawl | | `get_page_details` | Métriques détaillées pour une page spécifique | | `get_page_prompts` | Prompts IA citant une page spécifique | | `list_topics` | Sujets configurés pour un Brand Kit | | `list_personas` | Personas configurées pour un Brand Kit | | `query_analytics` | Requêtes de métriques personnalisées avec dimensions flexibles | | `analytics_chart` | Visualisation de graphique interactive (Claude Web et Desktop uniquement) | | `create_report` | Créer des rapports d'analyse enregistrés | | `list_reports` | Lister les rapports enregistrés | | `get_report` | Obtenir un rapport spécifique | **Bases de connaissances :** | Outil | Description | | ----------------------- | ------------------------------------------------------------------------------ | | `list_knowledge_bases` | Lister les bases de connaissances disponibles | | `search_knowledge_base` | Rechercher dans une base de connaissances à l'aide de la similarité sémantique | Voir [Référence des outils](/docs/fr/developpeurs/tools.md) pour la documentation complète. *** ## Autres assistants IA ### Puis-je utiliser AirOps avec Cursor, VS Code ou Windsurf ? Oui. AirOps fonctionne avec tout client compatible MCP. **Cursor :** ```json { "mcpServers": { "airops": { "url": "https://app.airops.com/mcp" } } } ``` **VS Code / Windsurf :** ```json { "mcp": { "servers": { "airops": { "command": "npx", "args": ["-y", "mcp-remote", "https://app.airops.com/mcp"] } } } } ``` Voir [Premiers pas](/docs/fr/developpeurs/getting-started.md) pour des instructions de configuration détaillées. *** ## Dépannage ### Claude indique « authentification requise » **Claude web/bureau :** 1. Allez à **Paramètres → Connecteurs** 2. Trouvez AirOps et cliquez sur **Reconnecter** 3. Terminez la connexion OAuth **Claude Code :** 1. Exécutez `/mcp` 2. Sélectionnez le serveur AirOps 3. Choisissez **S’authentifier** 4. Terminez l'OAuth dans le navigateur ### Les outils n'apparaissent pas 1. **Redémarrez Claude** — Fermez puis rouvrez l'application 2. **Vérifiez la connexion** — Paramètres → Connecteurs doit afficher « Connecté » 3. **Reconnecter** — Déconnectez puis reconnectez l'intégration ### Connexion refusée ou délai d’attente dépassé * Vérifiez que vous pouvez atteindre `https://app.airops.com` dans votre navigateur * Les réseaux d'entreprise peuvent bloquer les connexions MCP — contactez le service informatique * Essayez de déconnecter temporairement le VPN ### OAuth ne fonctionne pas (WSL/entreprise) **Utilisateurs WSL :** L'OAuth du navigateur peut échouer depuis WSL. Exécutez Claude depuis Windows à la place. **Réseaux d’entreprise :** Votre réseau peut bloquer les redirections OAuth. Essayez un réseau personnel ou demandez au service informatique d'ajouter à la liste blanche `app.airops.com`. ### Comment effacer l'authentification mise en cache ? 1. Déconnecter : **Paramètres → Connecteurs → Déconnecter** 2. Reconnectez-vous et terminez à nouveau l'OAuth Pour Claude Code : ```bash claude mcp remove airops claude mcp add --transport http airops https://app.airops.com/mcp ``` *** ## Sécurité ### Mes données sont-elles sécurisées ? Oui. Le connecteur utilise : * **OAuth 2.0 avec PKCE** — Authentification conforme aux standards du secteur * **HTTPS** — Toutes les données sont chiffrées en transit * **Autorisations au niveau utilisateur** — Accès uniquement à vos Brand Kits * **Aucun stockage d'identifiants** — Jetons OAuth gérés de manière sécurisée ### À quoi le connecteur peut-il accéder ? **Accès en lecture :** * Brand Kits pour lesquels vous avez des autorisations * Pages et métriques * Données d'analytics * Prompts et citations * Bases de connaissances **Créer et mettre à jour :** * Rapports (enregistrés dans votre compte) * Grilles d'actions * Paramètres du Brand Kit (nom, URL, ton rédactionnel, persona) * Entités du Brand Kit (gammes de produits, concurrents, audiences, régions, types de contenu, exemples de contenu, règles rédactionnelles) * Publier les brouillons du Brand Kit pour rendre les modifications actives **Ne peut pas :** * Supprimer des données * Accéder aux espaces de travail d'autres utilisateurs *** ## Ressources **Documentation AirOps** * [Connecteur Claude](/docs/fr/developpeurs/claude-connector.md) * [Premiers pas](/docs/fr/developpeurs/getting-started.md) * [Cas d’usage](/docs/fr/developpeurs/use-cases.md) * [Référence des outils](/docs/fr/developpeurs/tools.md) **Documentation Claude** * [Configuration des intégrations](https://support.anthropic.com/en/articles/10168395-setting-up-claude-integrations) * [Répertoire des connecteurs](https://support.anthropic.com/en/articles/11724452-using-the-connectors-directory-to-extend-claude-s-capabilities) * [MCP distant](https://support.anthropic.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.airops.com/docs/fr/developpeurs/faq.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.