export const metadata = {
  title: "MCP & agents IA : Docs SEO Insight",
  description:
    "Connectez Claude, GPT et d'autres agents à vos données SEO via le serveur MCP intégré de SEO Insight.",
};

# MCP & agents IA

SEO Insight embarque un serveur **Model Context Protocol (MCP)** intégré, pour
que des agents IA comme Claude et GPT puissent lire votre réservoir de mots-clés,
inspecter vos backlinks et générer des briefs, sans copier-coller entre les
outils.

## Connecter le serveur

Ajoutez le serveur MCP de SEO Insight à la configuration de votre agent. Le
serveur s'authentifie avec la même clé API que l'API REST.

```json
{
  "mcpServers": {
    "seo-insight": {
      "command": "npx",
      "args": ["-y", "@seo-insight/mcp"],
      "env": { "SEO_INSIGHT_API_KEY": "sk_live_xxxxxxxxxxxxxxxx" }
    }
  }
}
```

## Ce que les agents peuvent faire

Une fois connecté, l'agent peut lister les outils et les appeler dans une
session :

```text
> claude mcp list
seo-insight: connected ✓ (12 tools, 3 resources)

> Find my SEO quick-wins (positions 11-20)
3 quick-wins found:
  • seo mcp tool      · pos. 12 · 880 vol/mo
  • seo mcp server    · pos. 14 · 320 vol/mo
  • seo api for agents · pos. 18 · 210 vol/mo
```

Les outils disponibles couvrent le réservoir (rechercher et filtrer des
mots-clés), les backlinks (inspecter le profil entrant) et le contenu (générer
et enregistrer des briefs). Les ressources exposent les sources connectées de
l'espace de travail.

## Scopes

L'accès MCP hérite du scope de la clé sur l'espace de travail. Utilisez une clé
en lecture seule pour les agents qui ne doivent qu'interroger les données, et une
clé en lecture-écriture pour ceux qui créent des briefs. Voir
[Authentification](/docs/authentication) pour le modèle de scopes complet.