Quickstart

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

Comment brancher Mentionable MCP ?

Trois étapes : créer une API key, coller la config dans votre client, lancer un hello-world. L'endpoint et l'authentification sont identiques pour tous les clients, seule la wrapper JSON change.

1. Créer une API key Mentionable

1. Connectez-vous sur mentionable.ai.
2. Ouvrez Settings → API Keys (MCP).
3. Cliquez sur Create key, nommez-la (par exemple claude-desktop-laptop), 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.

2. Brancher votre client MCP

Claude Desktop

Éditez ~/Library/Application Support/Claude/claude_desktop_config.json sur macOS ou %APPDATA%\Claude\claude_desktop_config.json sur Windows :

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

Quittez et relancez Claude Desktop. Les tools Mentionable apparaissent dans le menu des tools de toute nouvelle conversation.

Cursor

Ouvrez Cursor Settings → MCP → Add new MCP server. Utilisez la même JSON :

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

Les tools Mentionable deviennent disponibles à l'agent Cursor dans tout chat.

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 huit 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.	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.
Tools manquants dans Claude Desktop	Erreur de syntaxe JSON dans la config, ou app non relancée après l'édition.	Validez la JSON puis quittez et relancez l'app.

É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.