npm package: @referencime/mcp-server
Description: Serveur MCP pour Référencime - Analysez vos données SEO WordPress avec Claude et ChatGPT
Author: Thomas Viennet
Latest version: 2.0.9

# 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](https://referencime.fr) 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)

1. Dans le dashboard WordPress → **Analyse IA**
2. Générer une clé API
3. Ouvrir [claude.ai/settings/connectors](https://claude.ai/settings/connectors?modal=add-custom-connector)
4. Coller l'URL unique :

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

### ChatGPT (Pro, Plus, Team, Enterprise)

1. Ouvrir [GPT Editor](https://chat.openai.com/gpts/editor) → Créer une nouvelle action
2. Authentification : **Bearer** + votre clé API
3. 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

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

### Variables d'environnement

```env
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

```bash
npm start
```

### Script de déploiement automatisé

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

### Vérification

```bash
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](https://registry.modelcontextprotocol.io) :

```
@referencime/mcp-server
```

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

## Support

- **Site** : [referencime.fr](https://referencime.fr)
- **Contact** : contact@referencime.fr
- **Issues** : [GitHub](https://github.com/ThomasViennet/mcp-referencime/issues)