Documentation · MCP
Documentation MCP
Connecte seops à Claude, ChatGPT, Gemini ou Claude Code : un serveur MCP distant avec connexion OAuth et 45 outils. Les outils de lecture sont toujours gratuits.
En bref. Ajoute https://app.seops.app/mcp à ton assistant, connecte-toi avec Google et interroge un site par son nom. Il y a 45 outils : 34 en lecture, 11 en écriture. Le serveur embarque des règles qui expliquent à l'agent comment analyser.
Connexion
Claude (claude.ai, Desktop)
- Paramètres → Connecteurs → Ajouter un connecteur personnalisé
- URL : https://app.seops.app/mcp
- Connecte-toi avec Google quand la fenêtre OAuth s'ouvre
- Demande : « Lequel de mes sites a perdu des clics la semaine dernière ? »
Claude Code
claude mcp add --transport http seops https://app.seops.app/mcp- Lance /mcp et termine la connexion
- Le serveur fournit des règles d'analyse et un protocole de synchronisation des tâches ; l'agent les suit sans consigne supplémentaire
ChatGPT
- Paramètres → Connecteurs → Créer (mode développeur)
- URL du serveur MCP : https://app.seops.app/mcp, authentification OAuth
- Active le connecteur dans une discussion et interroge un site par son nom
Gemini
- Gemini CLI : ajoute le serveur dans settings.json sous mcpServers avec httpUrl
- Les connecteurs de l'app Gemini suivront quand Google ouvrira le MCP personnalisé à tous les comptes
Règles suivies par l'agent
Les instructions MCP du serveur sont envoyées à l'agent à chaque connexion. En résumé :
- Pas de supposition : chaque chiffre vient avec sa source et sa période.
- Dans l'API, les taux vont de 0 à 1 ; l'agent doit afficher des pourcentages.
- Moins de 50 clics ou 500 impressions en 28 jours est qualifié de petit échantillon.
- L'agent ne modifie jamais les réglages du tableau de bord, de Cloudflare ou de GA4 ; il fournit du texte à copier-coller.
- Les tâches IA ne démarrent qu'une fois approuvées par toi dans le tableau de bord.
Outils
Les outils de lecture sont toujours inclus. Les outils d'écriture ne modifient que la liste de tâches, l'historique des prompts et les brouillons du tableau de bord ; ils ne changent aucun réglage et ne coûtent jamais de crédits.
Projets et vue d'ensemble
get_work_items | Data-derived to-dos with counters (baseline, remaining, done) in fixed impact order; start a session with the top open item. |
list_projects | Sites suivis, sources connectées (Search Console, GA4), nombre de mots-clés et de prompts. |
get_overview | Résumé sur 28 jours d'un projet : totaux Search Console, trafic GA4 et visites depuis les assistants IA, mouvements de position, taux de visibilité IA. |
get_weekly_summary | La semaine dernière (lun–dim) sur tous les modules, avec ce qui a changé. |
get_alerts | Alertes ouvertes : baisses de trafic, pertes d'index, sauvegardes périmées, crons en échec. |
Recherche
get_search_console | Totaux face à la période précédente, série quotidienne, principales requêtes et pages. |
get_search_opportunities | Requêtes en position 5–20 avec la page qui reçoit le plus d'impressions pour chacune. |
get_rank_tracking | Dernière position par mot-clé et appareil (Search Console), variation, page positionnée. |
get_keyword_history | Historique sur 90 jours d'un mot-clé. |
get_indexing | Sitemaps, résultats d'inspection d'URL, clé IndexNow et file. |
get_queue | Vérifications de position et exécutions IA en attente, erreurs récentes, prochains horaires de cron. |
Analytics
get_analytics | Totaux GA4 face à la période précédente, canaux, pages de destination, source/support, trafic des assistants IA. |
get_realtime | Utilisateurs actifs sur les 30 et 5 dernières minutes, par page et par source. |
get_navigation | D'où venaient les visiteurs d'une page et où ils sont allés ensuite ; parcours fréquents en trois étapes. |
get_site_search | Termes de la recherche interne, recherches sans résultat. |
Visibilité IA
get_ai_visibility | Taux de mention et de citation par moteur et par prompt ; sites cités. |
get_ai_answer | Texte complet de la réponse d'une exécution, URL citées, recherches effectuées par le modèle. |
get_cloudflare_ai_crawlers | GPTBot, ClaudeBot, PerplexityBot et autres : requêtes, pages, autorisés contre bloqués. |
Santé du site et Cloudflare
get_site_audit | Exploration technique des pages du sitemap : statut, redirections, noindex, titres, descriptions, canonicals, données structurées. |
get_page_speed | PageSpeed Insights pour les pages les plus importantes, mobile et ordinateur. |
get_cloudflare_security | Requêtes, visites, données, requêtes bloquées par action, fonctionnalité, règle, pays et chemin. |
get_cloudflare_usage | Consommation Workers, D1 et R2 face aux limites du plan. |
get_backups | État des sauvegardes D1, Supabase, WordPress et Hostinger et dernière exécution réussie. |
get_security_audit | Contrôle de sécurité : résultats de la surface externe (HTTPS, en-têtes de sécurité, fichiers exposés, security.txt, SPF/DMARC, TLS Cloudflare) et le dernier audit de code avec ses constats. |
submit_security_auditwrite | Envoie le findings.json d'un audit de code réalisé avec le skill security-audit de Cloudflare ; les constats nouveaux et clos sont rapprochés de l'exécution précédente. |
get_waf_rules | The site's Cloudflare WAF rules with the panel's analysis: dry run against real URLs and verified bots, false positives in the last 7 days, proposals. |
save_waf_ruleswrite | Record a WAF rule proposal with its rationale, or a new public endpoint; the panel never writes to Cloudflare, the user applies it. |
get_access_audit | Who can reach the site: search and AI bots, agents, PageSpeed and visitors from other countries; WAF linter with a corrected rule set. |
get_resilience_runs | Results of controlled load tests: whether the site stayed up and how fast it answered. |
run_resilience_testwrite | Send a controlled load (at most 250 requests) to your own verified site; only when you ask and retype the domain. |
get_usage | Dépenses du mois chez les fournisseurs payants, plafond de budget, solde, rythme. |
Tâches, prompts, marketing (écriture)
list_tasks | Liste de tâches filtrée par projet, responsable et statut. |
add_taskwrite | Ouvrir une tâche avec quoi/pourquoi/vérification ; responsable utilisateur ou ia ; clé de dédoublonnage. |
update_taskwrite | Changer le statut, la priorité, la note ; fermer avec preuve. Les tâches IA ne démarrent qu'après approbation dans le tableau de bord. |
get_task_log | Chaque changement sur les tâches : qui, quand, quoi. |
log_promptwrite | Enregistrer la demande de l'utilisateur et le résumé de l'agent dans l'historique des prompts. |
list_prompts | Historique des prompts avec sujets et étiquettes. |
list_prompt_templates | Bibliothèque de prompts. |
save_prompt_templatewrite | Enregistrer un prompt réutilisable dans la bibliothèque. |
list_social_posts | Contenu et partage : comptes, publications, planning. |
create_social_postwrite | Rédiger une publication à partir des données de la semaine ; l'utilisateur approuve avant l'envoi. |
update_social_postwrite | Modifier ou planifier un brouillon. |
save_content_draftwrite | Enregistrer un brouillon de guide ou d'article pour relecture dans le tableau de bord. |
list_feedback | Rapports de bugs et suggestions consignés par les agents. |
update_feedbackwrite | Fermer ou annoter un retour. |
Authentification et sécurité
- OAuth 2.1 avec PKCE ; l'enregistrement dynamique des clients est activé. Un jeton est lié à un seul espace de travail et ne peut pas en lire un autre.
- Les secrets (clés, e-mails) sont masqués côté serveur et jamais écrits en clair dans l'historique des prompts.
- Les agents écrivent chaque demande et un court résumé dans l'historique des prompts (Suivi › Tâches › Historique des prompts), secrets masqués ; tu peux désactiver cet enregistrement.