@referencime/mcp-server

Référencime MCP Server

Serveur MCP centralisé pour l'analyse SEO avec Claude et ChatGPT

Identifiez les meilleurs spots netlinking selon leur performance Google réelle, analysez vos positions et générez des rapports SEO — directement depuis votre assistant IA, sans aucune installation technique.

Vue d'ensemble

Ce serveur MCP permet aux utilisateurs de Référencime d'accéder à leurs données SEO directement dans Claude ou ChatGPT. Les outils sont générés dynamiquement depuis l'API WordPress via OpenAPI.

Cas d'usage principaux

• Netlinking data-driven — Classez les spots par performance Google réelle dans votre thématique (pas des métriques théoriques manipulables)
• Bilan SEO mensuel — Générez des rapports structurés avec comparaisons M-1 / N-1, par catégorie
• Suivi de positions — Détectez les changements significatifs, entrées/sorties du Top 10
• Analyse concurrentielle — Suivez les mouvements de vos concurrents dans les SERP

Architecture

WordPress (plugin Easy Links)
    │
    ├── openapi.yaml ──────────────────────────────► ChatGPT
    │   (compilé en JSON : /wp-json/easy-links/v1/openapi.json)     (import direct)
    │
    └── openapi.json ──► server.js (Node.js) ──SSE──► Claude
                         (génère les outils MCP        (connecteur remote)
                          dynamiquement au démarrage)

• Claude se connecte via SSE à https://mcp.referencime.fr/sse
• ChatGPT importe le schéma OpenAPI directement depuis WordPress
• Les outils sont auto-générés depuis l'OpenAPI — ajouter un endpoint WordPress le rend disponible dans l'IA après reconnexion (cache 1h)

Configuration pour l'utilisateur final

Claude (Pro, Max, Team, Enterprise)

• Dans le dashboard WordPress → Analyse IA
• Générer une clé API
• Ouvrir claude.ai/settings/connectors
• Coller l'URL unique :

https://mcp.referencime.fr/sse?api_key=VOTRE_CLE_API

ChatGPT (Pro, Plus, Team, Enterprise)

• Ouvrir GPT Editor → Créer une nouvelle action
• Authentification : Bearer + votre clé API
• Importer le schéma depuis :

https://referencime.fr/wp-json/easy-links/v1/openapi.json

Déploiement (o2switch)

Prérequis

• Node.js 18+
• Plugin Easy Links installé sur WordPress
• Hébergement compatible Node.js (cPanel → Node.js Apps)

Installation

git clone https://github.com/ThomasViennet/mcp-referencime.git
cd mcp-referencime
npm install --production

Variables d'environnement

PORT=3000
NODE_ENV=production
WORDPRESS_API_URL=https://referencime.fr/wp-json/easy-links/v1
JWT_SECRET=your-secret-key
ALLOWED_ORIGINS=*
TRUST_PROXY=true
LOG_LEVEL=info

Démarrage

npm start

Script de déploiement automatisé

chmod +x deploy-o2switch.sh
./deploy-o2switch.sh

Vérification

curl https://mcp.referencime.fr/         # Statut serveur
curl https://mcp.referencime.fr/health   # Santé
curl https://mcp.referencime.fr/debug/tools  # Outils générés

Outils disponibles

Les outils sont générés automatiquement depuis l'OpenAPI de WordPress. Liste actuelle :

Outil	Description
listWebsitesByUser	Liste les sites de l'utilisateur
listKeywordsByWebsite	Mots-clés d'un site
listCategoriesByWebsite	Catégories thématiques
identifyNetlinkingTargets	Opportunités netlinking (positions 3-20)
getNetlinkingSpotsRanking	Spots classés par proximité sémantique
getWebsitePerformanceSummary	Résumé GSC avec comparaisons
detectRankingChanges	Changements de positions significatifs
getCompetitorsOverview	Vue d'ensemble concurrentielle
getGscProgress	Statut d'indexation GSC
analyzeKeywordPerformance	Analyse détaillée d'un mot-clé
getPositionEvolution	Historique de positions
getKeywordIdeas	Suggestions de mots-clés

Sécurité

• Authentification JWT — Chaque connexion SSE valide le token WordPress
• Rate limiting — 100 req / 15 min par IP (global)
• Heartbeat — Ping toutes les 15s pour maintenir la connexion (anti-Nginx timeout)
• Isolation par session — Chaque utilisateur a son propre serveur MCP instancié

Paquet npm

Ce serveur est publié sur npm pour référencement dans le MCP Registry :

@referencime/mcp-server

Les utilisateurs n'ont pas besoin de l'installer — le serveur tourne en permanence sur o2switch.

Support

• Site : referencime.fr
• Contact : [e-mail]
• Issues : GitHub