Connectez RankMeFast à vos outils d’IA

RankMeFast fournit un endpoint distant Model Context Protocol (MCP). Un agent de programmation, un IDE ou un outil CLI compatible peut ainsi lire vos données SEO et lancer des audits sans quitter votre environnement de travail.

Configuration en cinq minutes

1. Ouvrez Paramètres → Clés API, sélectionnez Créer une clé, puis copiez la clé dès son affichage. RankMeFast ne montre la clé complète qu’une seule fois.

2. Utilisez l’endpoint MCP de RankMeFast :

   https://rankme.fast/api/mcp
   

3. Pour les clients compatibles avec les variables d’environnement, définissez la clé avant de démarrer le client :

   export RANKMEFAST_API_KEY='rmf_REPLACE_WITH_YOUR_KEY'
   

   Dans PowerShell :

   $env:RANKMEFAST_API_KEY = 'rmf_REPLACE_WITH_YOUR_KEY'
   

4. Choisissez votre client ci-dessous, collez sa configuration, puis redémarrez-le ou rechargez-le.

5. Vérifiez la connexion avec : « Utilise RankMeFast pour répertorier mes sites. »

Traitez la clé comme un mot de passe. Les clés API RankMeFast donnent accès à tout le compte et ne disposent pas de portées distinctes. L’outil start_audit peut consommer votre quota mensuel d’audits. Privilégiez une variable d’environnement, une saisie protégée ou une configuration utilisateur, et ne versionnez jamais une clé dans votre dépôt.

L’accès MCP est inclus dans les plans Starter, Pro et Agency. Les clés Agency fonctionnent également avec l’API REST publique en lecture seule.

Choisissez votre client

Tout autre client peut se connecter s’il prend en charge Streamable HTTP à distance et un en-tête Authorization personnalisé. RankMeFast ne propose ni serveur stdio local ni ancien serveur SSE.

Claude Code

Ajoutez un serveur au niveau utilisateur. Les apostrophes simples préservent la référence à la variable d’environnement :

claude mcp add-json --scope user rankmefast \
  '{"type":"http","url":"https://rankme.fast/api/mcp","headers":{"Authorization":"Bearer ${RANKMEFAST_API_KEY}"}}'

Vérifiez la connexion avec :

claude mcp get rankmefast

Vous pouvez aussi exécuter /mcp dans Claude Code. L’interface Claude Code de l’application pour ordinateur utilise la même configuration. Consultez le guide MCP officiel de Claude Code.

Le connecteur de chat de Claude.ai et Claude Desktop est différent : son processus de connexion à distance documente OAuth, pas un en-tête Bearer statique arbitraire. Il ne peut pas se connecter directement tant que RankMeFast ne propose pas OAuth ; utilisez plutôt Claude Code. Consultez les connecteurs personnalisés Claude.

Cursor IDE et Cursor Agent CLI

Créez ~/.cursor/mcp.json pour une configuration utilisateur. Remplacez les deux valeurs temporaires et gardez ce fichier privé :

{
  "mcpServers": {
    "rankmefast": {
      "url": "https://rankme.fast/api/mcp",
      "headers": {
        "Authorization": "Bearer rmf_REPLACE_WITH_YOUR_KEY"
      }
    }
  }
}

Cursor IDE et Cursor Agent CLI lisent la même configuration. Vérifiez-la avec :

cursor-agent mcp list
cursor-agent mcp list-tools rankmefast

Pour une configuration d’équipe, utilisez .cursor/mcp.json, mais ne placez pas de clé en clair dans ce fichier versionné. Consultez le guide MCP officiel de Cursor.

VS Code et GitHub Copilot

Exécutez MCP: Open User Configuration depuis la palette de commandes, puis utilisez une saisie de mot de passe afin que le secret ne soit pas écrit dans le fichier :

{
  "inputs": [
    {
      "type": "promptString",
      "id": "rankmefast-key",
      "description": "RankMeFast API key",
      "password": true
    }
  ],
  "servers": {
    "rankmefast": {
      "type": "http",
      "url": "https://rankme.fast/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:rankmefast-key}"
      }
    }
  }
}

Exécutez MCP: List Servers pour démarrer ou inspecter le serveur. La configuration de l’espace de travail peut être enregistrée dans .vscode/mcp.json ; le formulaire avec saisie protégée peut être partagé sans risque. Consultez la référence officielle de configuration MCP de VS Code.

GitHub Copilot CLI

Une fois RANKMEFAST_API_KEY défini dans votre shell :

copilot mcp add \
  rankmefast \
  --type http \
  --url https://rankme.fast/api/mcp \
  --header "Authorization=Bearer $RANKMEFAST_API_KEY" \
  --tools "*"

Le shell développe la clé avant que Copilot enregistre la configuration utilisateur ; protégez donc ~/.copilot/mcp-config.json. Consultez Ajouter des serveurs MCP à Copilot CLI.

Windsurf / Cascade

Ajoutez ceci à ~/.codeium/windsurf/mcp_config.json :

{
  "mcpServers": {
    "rankmefast": {
      "serverUrl": "https://rankme.fast/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:RANKMEFAST_API_KEY}"
      }
    }
  }
}

Rechargez-le depuis Windsurf Settings → Cascade → MCP Servers. Consultez le guide MCP officiel de Windsurf.

Codex CLI, extension IDE et ChatGPT pour ordinateur

Codex CLI, l’extension Codex pour IDE et l’interface Codex de ChatGPT pour ordinateur partagent ~/.codex/config.toml sur la même machine :

[mcp_servers.rankmefast]
url = "https://rankme.fast/api/mcp"
bearer_token_env_var = "RANKMEFAST_API_KEY"

Redémarrez l’IDE ou l’application après avoir défini la variable d’environnement. Dans la CLI, vérifiez la connexion avec :

codex mcp list

Vous pouvez aussi exécuter /mcp dans une session Codex. Consultez le guide MCP officiel de Codex.

ChatGPT web ne lit pas la configuration locale de Codex. Cette procédure s’applique donc uniquement aux interfaces Codex de la machine configurée.

Gemini CLI

Une fois RANKMEFAST_API_KEY défini dans votre shell :

gemini mcp add \
  --scope user \
  --transport http \
  --header "Authorization: Bearer $RANKMEFAST_API_KEY" \
  rankmefast https://rankme.fast/api/mcp

Vérifiez la connexion avec gemini mcp list ou /mcp dans Gemini CLI. La commande enregistre l’en-tête développé dans ~/.gemini/settings.json ; gardez donc ce fichier privé. En JSON, utilisez httpUrl : Gemini réserve url à l’ancien protocole SSE. Consultez le guide MCP officiel de Gemini CLI.

OpenCode

Ajoutez ceci au fichier global ~/.config/opencode/opencode.json :

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "rankmefast": {
      "type": "remote",
      "url": "https://rankme.fast/api/mcp",
      "enabled": true,
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:RANKMEFAST_API_KEY}"
      }
    }
  }
}

oauth: false empêche la découverte OAuth, car RankMeFast utilise une clé Bearer. Vérifiez la configuration avec :

opencode mcp list
opencode mcp debug rankmefast

Consultez le guide MCP officiel d’OpenCode.

JetBrains AI Assistant et Junie

Ouvrez Settings → Tools → AI Assistant → Model Context Protocol (MCP), ajoutez un serveur HTTP, puis collez :

{
  "mcpServers": {
    "rankmefast": {
      "url": "https://rankme.fast/api/mcp",
      "headers": {
        "Authorization": "Bearer rmf_REPLACE_WITH_YOUR_KEY"
      }
    }
  }
}

Conservez cette configuration dans les paramètres de l’IDE plutôt que dans un fichier du projet. Activez Pass custom MCP servers lorsque vous souhaitez transmettre les outils à Junie ou à un autre agent intégré. Consultez le guide MCP officiel de JetBrains.

Zed

Ouvrez Settings → AI → MCP Servers → Add Remote Server, ou ajoutez ceci à vos paramètres utilisateur :

{
  "context_servers": {
    "rankmefast": {
      "url": "https://rankme.fast/api/mcp",
      "headers": {
        "Authorization": "Bearer rmf_REPLACE_WITH_YOUR_KEY"
      }
    }
  }
}

Placez la clé en clair dans les paramètres utilisateur, pas dans ceux du projet. Un indicateur vert à côté du serveur confirme la connexion. Consultez le guide MCP officiel de Zed.

Cline

Ouvrez les paramètres MCP de Cline et ajoutez un serveur Streamable HTTP :

{
  "mcpServers": {
    "rankmefast": {
      "type": "streamableHttp",
      "url": "https://rankme.fast/api/mcp",
      "headers": {
        "Authorization": "Bearer rmf_REPLACE_WITH_YOUR_KEY"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Laissez autoApprove vide afin que le lancement d’un audit exige votre approbation. Consultez le guide MCP officiel de Cline.

Roo Code

Utilisez les paramètres MCP globaux ou .roo/mcp.json :

{
  "mcpServers": {
    "rankmefast": {
      "type": "streamable-http",
      "url": "https://rankme.fast/api/mcp",
      "headers": {
        "Authorization": "Bearer rmf_REPLACE_WITH_YOUR_KEY"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Laissez alwaysAllow vide afin que les actions payantes exigent votre approbation. Consultez le guide MCP officiel de Roo Code.

Kiro IDE et CLI

Utilisez ~/.kiro/settings/mcp.json pour une configuration globale ou .kiro/settings/mcp.json pour un projet :

{
  "mcpServers": {
    "rankmefast": {
      "url": "https://rankme.fast/api/mcp",
      "headers": {
        "Authorization": "Bearer ${RANKMEFAST_API_KEY}"
      }
    }
  }
}

Kiro développe les variables d’environnement dans les en-têtes. Consultez la configuration MCP officielle de Kiro.

Copilot dans les autres IDE

GitHub Copilot dans Visual Studio, les IDE JetBrains, Xcode et Eclipse utilise une structure différente de VS Code :

{
  "servers": {
    "rankmefast": {
      "url": "https://rankme.fast/api/mcp",
      "requestInit": {
        "headers": {
          "Authorization": "Bearer rmf_REPLACE_WITH_YOUR_KEY"
        }
      }
    }
  }
}

Enregistrez cette configuration au niveau utilisateur et ne versionnez pas la clé. Suivez le guide de configuration MCP pour les extensions Copilot dans les IDE pour connaître l’emplacement du fichier de configuration dans votre IDE.

Outils RankMeFast disponibles

Les lectures et les actions sont toujours limitées au compte propriétaire de la clé. Un identifiant de site, d’analyse ou d’exécution appartenant à un autre compte est renvoyé comme introuvable.

La liste des outils évolue de manière additive : les outils existants gardent leurs noms et la forme de leurs arguments, et de nouveaux outils peuvent apparaître au fil des livraisons. Rien dans cette version ne supprime ni ne renomme un outil.

Résolution des problèmes

• Le client ne trouve pas les outils : vérifiez que l’URL se termine par /api/mcp, choisissez Streamable HTTP plutôt que SSE ou stdio, puis redémarrez le client.
• 401 Unauthorized : utilisez exactement l’en-tête Authorization: Bearer rmf_…. La clé est peut-être mal saisie, révoquée ou liée à un compte inactif.
• 402 Upgrade required : MCP nécessite Starter, Pro ou Agency. Consultez Plans, limites et crédits.
• 405 Method not allowed dans un navigateur : ce comportement est normal, car l’endpoint accepte les requêtes MCP POST, pas les requêtes GET ordinaires d’un navigateur.
• 429 Too many requests : attendez la fin de la fenêtre de limitation indiquée dans les en-têtes de réponse, puis réessayez.
• 503 Unavailable : MCP est désactivé ou temporairement indisponible sur cette installation RankMeFast ; contactez son opérateur.
• Fonctionne en local, mais pas derrière un proxy : vérifiez que le proxy transmet les en-têtes Authorization, Content-Type et Accept à /api/mcp.

Pour remplacer une clé, créez-en une nouvelle, mettez à jour et vérifiez chaque client, puis révoquez l’ancienne depuis Paramètres → Clés API. La révocation est immédiate.

Compatibilité

Le registre de cette version contient exactement les huit outils indiqués ci-dessus. Sept sont en lecture seule ; start_audit est le seul outil qui consomme un quota du forfait. Le Radar de marque, l’Intelligence des avis, l’Intelligence des liens, l’Analyse du trafic, les Tendances de mots-clés et le Capteur SERP n’ont pas d’outil MCP. Aucun nom d’outil ni format d’argument existant n’a changé.

<!-- mcp-tools: list_sites; get_latest_audit_report; list_keywords; get_rank_history; list_content_analyses; get_content_analysis; start_audit; get_audit_status -->

Guides associés

• API publique — l’API en lecture réservée au plan Agency.
• Content Intelligence — comprenez les données d’analyse renvoyées par MCP.
• Sécurité du compte — protégez votre compte et vos clés.