Quickstart Mentionable MCP : Claude, ChatGPT, Cursor, n8n

Brancher le serveur MCP de Mentionable en deux minutes. OAuth pour Claude, ChatGPT, Claude Code et Cursor, sans API key. Configurations par clé pour n8n, VS Code et curl. Hello-world et erreurs courantes.

Mis à jour le 2026-10-19

Cinq minutes pour passer de zéro à votre premier appel de tool.

Comment brancher Mentionable MCP ?

Deux chemins, un seul endpoint. Les clients qui ont un bouton Connect (Claude, ChatGPT, Claude Code, Cursor) passent par OAuth : vous collez l'URL du serveur et vous approuvez l'accès, aucune clé à créer ni à stocker. Les clients sans OAuth (n8n, scripts, curl) utilisent une API key. L'accès MCP nécessite le plan Pro ou Agency.

1. Se connecter en OAuth (recommandé)

Claude (web et Desktop)

  1. Ouvrez Paramètres → Connecteurs → Ajouter un connecteur personnalisé.
  2. Collez https://mentionable.ai/api/mcp, puis cliquez sur Connect.
  3. Un écran Mentionable s'ouvre. Connectez-vous si besoin, puis cliquez sur Approve.

Les tools Mentionable apparaissent dans le menu des tools de toute nouvelle conversation.

ChatGPT

Ajoutez un connecteur custom pour un serveur MCP distant, collez https://mentionable.ai/api/mcp, cliquez sur Connect et approuvez sur l'écran Mentionable.

Claude Code

claude mcp add --transport http mentionable https://mentionable.ai/api/mcp

Lancez ensuite /mcp, choisissez mentionable puis Authenticate. Le navigateur ouvre l'écran d'approbation Mentionable.

Cursor

Ouvrez Cursor Settings → MCP → Add new MCP server et donnez seulement l'URL :

{
  "mcpServers": {
    "mentionable": {
      "url": "https://mentionable.ai/api/mcp"
    }
  }
}

Cursor ouvre l'écran d'approbation Mentionable à la première utilisation.

Chaque connecteur approuvé apparaît dans Paramètres → MCP sous le nom MCP OAuth (host). Révoquez-le à cet endroit pour déconnecter le client.

2. Utiliser une API key (n8n, scripts, curl)

  1. Connectez-vous sur mentionable.ai.
  2. Ouvrez Paramètres → MCP.
  3. Dans la section Clés API, cliquez sur Créer une clé, nommez-la (par exemple n8n-rapport-hebdo), restreignez-la à certains projets si nécessaire.
  4. Copiez le token. Il commence par mnt_sk_ et n'est affiché qu'une seule fois.

L'API key Mentionable hérite des permissions du membre du workspace qui l'a créée. Les restrictions de projets sur la clé s'intersectent avec celles du membre. Une clé révoquée ne peut pas être réutilisée, créez-en une nouvelle pour la remplacer.

n8n

Utilisez le node MCP Client (n8n version 1.65 ou ultérieure) :

  • Endpoint : https://mentionable.ai/api/mcp
  • Authentication : Header Auth, Authorization à Bearer mnt_sk_xxx
  • Operation : Execute tool, choisissez un tool, remplissez les arguments.

Pattern courant : Cron → MCP (list_prompts) → Function → Slack.

VS Code avec GitHub Copilot Chat

Ajoutez à settings.json :

{
  "mcp.servers": {
    "mentionable": {
      "url": "https://mentionable.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer mnt_sk_xxx"
      }
    }
  }
}

curl (test rapide)

curl -X POST https://mentionable.ai/api/mcp \
  -H "Authorization: Bearer mnt_sk_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

Une réponse réussie est un payload JSON-RPC qui liste les 68 tools. Un 401 veut dire que la clé est mauvaise ou révoquée. Un 429 veut dire plus de 100 requêtes dans les 60 dernières secondes.

3. Lancer un hello-world

Une fois branché, demandez à votre agent :

Liste mes projets Mentionable, puis pour le premier, montre-moi les 10 domaines les plus cités tous LLM confondus.

L'agent enchaîne list_projects → list_llm_sources et affiche un tableau. C'est le pattern canonique du MCP Mentionable : on découvre le projet, puis on creuse une ressource.

Erreurs courantes

Erreur Cause Fix
401 Unauthorized Token manquant ou invalide. En OAuth, reconnectez le connecteur. Avec une clé, vérifiez le header Authorization: Bearer et que la clé n'est pas révoquée.
403 FORBIDDEN: Project not in API key scope La clé a été restreinte à certains projets, le projet demandé n'est pas dans la liste. Utilisez un projectId issu de list_projects ou élargissez le scope de la clé.
429 RATE_LIMITED Plus de 100 requêtes en 60 secondes pour cette clé. Ralentissez. Lisez le header Retry-After.
data vide Filtres trop étroits, ou pas encore de données (projet tout récent). Élargissez les filtres ; attendez la première run quotidienne.
Project not found Le projet n'appartient pas à votre tenant ou hors du scope du membre. Confirmez l'ID via list_projects.
access_denied pendant l'OAuth L'espace n'est pas sur le plan Pro ou Agency. Passez au plan Pro depuis Paramètres → Facturation, puis reconnectez.

Étapes suivantes

  • Lisez Concepts pour comprendre les fan-out queries et la taxonomie des sources.
  • Choisissez un workflow dans Cas d'usage et collez le prompt système dans votre agent.
  • Lisez Authentification avant de partager des clés avec votre équipe.

Vous pouvez voir où vous en êtes dès aujourd'hui.

Essai gratuit. Lancez le suivi de votre visibilité IA, sans carte.