autoranko

Serveur MCP

Utilisez Autoranko depuis votre assistant IA (MCP)

Autoranko fait tourner un serveur MCP distant : des assistants comme Claude, ChatGPT, Claude Code, Cursor et VS Code peuvent auditer des pages, rechercher des mots-clés et rédiger ou publier des articles sur votre compte. Claude et ChatGPT se connectent par OAuth ; les autres clients peuvent utiliser un jeton d’API.

  • Environ 5 minutes pour se connecter (estimation)
  • Dernière vérification : 8 novembre 2026

Comment la connexion fonctionne

Le Model Context Protocol (MCP) permet à un assistant IA d’appeler les outils d’un autre service. Le serveur MCP d’Autoranko est distant, il n’y a donc rien à installer : votre client envoie ses requêtes en Streamable HTTP à https://autoranko.com/api/mcp, connecté par OAuth ou avec un jeton d’API dans l’en-tête Authorization, et le serveur répond avec les résultats des outils.

Les outils sont générés à partir de la même référence que l’API REST et le fichier OpenAPI : ils correspondent donc toujours à ce que permet l’API. Les outils qui enregistrent des résultats les placent dans Tableau de bord → Settings → API & Apps → Saved results ; ceux qui créent ou publient des articles agissent sur vos vrais sites et consomment les quotas de votre offre.

Connecter votre assistant

  1. 1

    Choisissez le mode de connexion

    Claude et ChatGPT se connectent par OAuth : vous approuvez l’accès sur un écran de consentement Autoranko et choisissez ce que l’app peut faire, en lecture seule si vous préférez. Pour Claude Code, Cursor ou VS Code, vous pouvez plutôt créer un jeton dans Tableau de bord → API & Apps, limité aux droits et aux sites nécessaires.

  2. 2

    Ajoutez le serveur à votre client

    Dans Claude, ajoutez un connecteur personnalisé avec l’URL https://autoranko.com/api/mcp (Personnaliser → Connecteurs). Dans ChatGPT, ajoutez-le comme serveur MCP personnalisé avec OAuth. Les clients à jeton ajoutent un serveur distant (HTTP) avec la même URL et un en-tête Authorization contenant Bearer et le jeton ; dans Claude Code, une commande claude mcp add suffit. La documentation MCP donne les étapes exactes.

  3. 3

    Vérifiez la connexion

    Demandez à l’assistant à quel compte Autoranko il est connecté : il appelle whoami et affiche votre compte et votre offre. Si les outils n’apparaissent pas, consultez la section de dépannage ci-dessous.

  4. 4

    Confiez-lui du vrai travail

    Demandez-lui d’auditer une page, de trouver des idées de mots-clés pour un site connecté ou de rédiger un article et de le laisser en relecture. Demandez une confirmation avant de publier : publish_job modifie votre site en ligne.

Ce que votre assistant peut faire

Le serveur MCP propose 34 outils, générés à partir de la même référence que l’API REST :

  • whoamiGet the current account
  • list_sitesList sites
  • get_siteGet a site with usage
  • list_articlesList synced articles
  • get_articleGet an article
  • list_article_jobsList jobs
  • create_article_jobCreate a job
  • get_article_jobGet a job
  • publish_jobPublish a job
  • site_keyword_researchResearch keywords
  • geo_list_promptsList tracked prompts
  • geo_add_promptsAdd prompts
  • geo_start_runStart a run
  • geo_list_runsList runs
  • geo_get_runGet a run with its answers
  • geo_statsGet visibility metrics
  • geo_competitorsList the names AI answers give
  • geo_ai_trafficGet AI-assistant traffic (GA4)
  • seo_analyzeAudit a page
  • seo_keyword_researchResearch keywords for any site
  • seo_write_articleWrite a long-form article
  • seo_write_short_articleWrite a short article
  • seo_meta_tagsWrite title and meta description variants
  • seo_open_graphGenerate Open Graph and Twitter tags
  • seo_schemaGenerate JSON-LD structured data
  • seo_headingsPlan the heading structure
  • seo_content_briefCreate a content brief
  • seo_rewriteRewrite copy for SEO
  • seo_alt_textsWrite image alt text
  • robots_sitemapGenerate robots.txt and a sitemap
  • serp_previewPreview a Google result
  • list_seo_analysesList saved analyses
  • get_seo_analysisGet a saved analysis
  • list_ai_modelsList AI models

Limites et mises en garde honnêtes

Les apps connectées par OAuth n’obtiennent que les droits que vous approuvez, et vous pouvez les déconnecter à tout moment dans Tableau de bord → API & Apps. Les clients qui ne font tourner que des serveurs locaux (stdio) ont besoin d’une passerelle vers un serveur distant ; notre propre paquet npm n’est pas encore publié.

Les requêtes sont limitées par jeton, comme pour l’API REST. Les tâches longues, comme la rédaction d’un article complet, prennent quelques minutes, pendant lesquelles l’assistant attend l’outil ou interroge la tâche. Les métriques de mots-clés renvoyées par les outils sont des estimations de l’IA, signalées comme telles.

Dépannage

Les messages ci-dessous sont exactement ceux qu’Autoranko affiche dans le tableau de bord ou que renvoie l’API (en anglais), avec leur sens et la façon de les résoudre.

missing_token
La requête est arrivée sans identifiants. Les clients OAuth lancent la connexion à partir de cette réponse ; les clients à jeton doivent envoyer Authorization: Bearer ar_live_…
invalid_token
Le jeton est mal formé, révoqué, expiré ou mal saisi. Reconnectez l’app, ou créez un nouveau jeton dans Tableau de bord → API & Apps et mettez à jour la configuration du client.
rate_limited
L’assistant a envoyé trop de requêtes en peu de temps. Attendez le nombre de secondes indiqué par l’en-tête Retry-After, et demandez moins d’appels en parallèle si cela se reproduit.
Le client n’affiche aucun outil Autoranko
Assurez-vous que le serveur est configuré comme serveur HTTP distant (Streamable HTTP), et non comme commande locale, et que l’URL se termine par /api/mcp. Redémarrez le client après avoir modifié sa configuration.

Questions

Quels assistants fonctionnent ?+
Claude et ChatGPT se connectent par OAuth. Claude Code, Cursor, VS Code et tout client qui prend en charge les serveurs distants Streamable HTTP peuvent aussi utiliser un jeton d’API dans un en-tête personnalisé.
Est-il prudent de donner accès à un assistant ?+
Avec OAuth, vous approuvez ce que l’app peut faire, par exemple la lecture seule, et pouvez la déconnecter à tout moment. Un jeton limité aux droits et aux sites dont l’assistant a besoin est plus sûr qu’un accès complet : gardez-le hors des fichiers partagés et révoquez-le dans Tableau de bord → API & Apps s’il fuite.
Cela coûte-t-il plus cher ?+
Non. Les appels MCP consomment les mêmes quotas que le tableau de bord et l’API : les outils calculés sont gratuits, les outils IA comptent dans vos actions d’IA mensuelles, et les articles dans votre quota d’articles.

Connectez votre site en quelques minutes

Commencez avec l’offre gratuite — sans carte — et publiez votre premier article sur votre propre plateforme.