Connecter Claude, Cursor et d'autres clients

La configuration pas à pas de Claude Code, Claude Desktop, Cursor, VS Code et MCP Inspector avec le serveur MCP de StickyPrompts, plus un handshake brut en curl et des prompts pour tester la connexion.

Tout client MCP qui prend en charge les serveurs distants Streamable HTTP avec un header personnalisé peut se connecter à StickyPrompts. Il vous faut deux choses : l’endpoint et une clé API.

URL:     https://api.stickyprompts.com/mcp/
Header:  Authorization: Bearer STICKY-API-...

Conservez la barre oblique à la fin de l’URL. Les outils que voit votre client dépendent des autorisations de la clé : créez donc pour l’assistant une clé dotée uniquement des autorisations dont il a besoin (voir la Référence des autorisations).

Avant de commencer

Créer une clé pour votre assistant

Dans Settings > API keys, sélectionnez Generate key, nommez la clé d’après le client (par exemple Claude Code - portable) et cochez les autorisations correspondant aux outils souhaités. Copiez la clé : elle ne s’affiche qu’une fois.
La placer dans une variable d'environnement
```
export STICKY_API_KEY="STICKY-API-..."
```
Les fichiers de configuration qui contiennent une clé ont leur place dans votre coffre de secrets ou dans votre répertoire personnel, jamais dans un dépôt partagé.

Claude Code

Ajoutez le serveur en une seule commande :

zsh

$ claude mcp add --transport http stickyprompts https://api.stickyprompts.com/mcp/ --header "Authorization: Bearer $STICKY_API_KEY"

$ claude mcp list

Votre shell remplace $STICKY_API_KEY par sa valeur au moment où vous lancez la commande : la clé est donc enregistrée dans la configuration de Claude Code. Lancez claude mcp add --help pour choisir où elle est stockée (pour vous seul ou pour un projet). Dans une session Claude Code, /mcp affiche l’état de connexion du serveur et ses outils.

Pour partager la configuration avec une équipe sans partager de clé, vous pouvez plutôt commiter un fichier .mcp.json de projet qui lit la clé dans l’environnement de chaque développeur (exemple) :

{
  "mcpServers": {
    "stickyprompts": {
      "type": "http",
      "url": "https://api.stickyprompts.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${STICKY_API_KEY}"
      }
    }
  }
}

Claude Desktop et claude.ai

Dans Claude Desktop et claude.ai, les connecteurs personnalisés s’ajoutent par URL et se connectent via OAuth. Le serveur MCP de StickyPrompts s’authentifie avec un header de clé API et ne propose pas de connexion OAuth : un connecteur personnalisé défini par sa seule URL ne peut donc pas s’y connecter.

La solution consiste à utiliser une passerelle locale qui relaie les requêtes vers le serveur distant en ajoutant le header. Par exemple avec mcp-remote, dans le fichier claude_desktop_config.json de Claude Desktop (exemple ; Node.js requis) :

{
  "mcpServers": {
    "stickyprompts": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.stickyprompts.com/mcp/",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer STICKY-API-..."
      }
    }
  }
}

Transmettre la valeur via env évite les problèmes que certains systèmes rencontrent avec les espaces à l’intérieur de args. Redémarrez Claude Desktop après avoir modifié le fichier.

Cursor

Ajoutez le serveur dans le fichier .cursor/mcp.json de votre projet, ou dans le fichier mcp.json global du dossier de paramètres de Cursor pour l’utiliser partout (exemple) :

{
  "mcpServers": {
    "stickyprompts": {
      "url": "https://api.stickyprompts.com/mcp/",
      "headers": {
        "Authorization": "Bearer STICKY-API-..."
      }
    }
  }
}

Ouvrez les paramètres MCP de Cursor pour vérifier que le serveur est connecté et voir ses outils. Si vous utilisez un fichier de projet, ajoutez-le à .gitignore ou utilisez la syntaxe de variables d’environnement de Cursor pour que la clé ne soit pas commitée.

VS Code

VS Code lit les serveurs MCP dans .vscode/mcp.json. Son format utilise une clé servers et peut demander la clé API au lieu de la stocker (exemple) :

{
  "inputs": [
    {
      "type": "promptString",
      "id": "sticky-api-key",
      "description": "StickyPrompts API key",
      "password": true
    }
  ],
  "servers": {
    "stickyprompts": {
      "type": "http",
      "url": "https://api.stickyprompts.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${input:sticky-api-key}"
      }
    }
  }
}

Démarrez le serveur depuis le fichier ou depuis la vue des serveurs MCP, saisissez votre clé lorsqu’elle vous est demandée : les outils StickyPrompts apparaissent alors dans le sélecteur d’outils du mode agent.

Autres clients

Pour tout client qui prend en charge les serveurs HTTP distants avec headers, la forme générique est la suivante (exemple ; les noms de clés varient légèrement d’un client à l’autre, par exemple type ou transport) :

{
  "mcpServers": {
    "stickyprompts": {
      "type": "http",
      "url": "https://api.stickyprompts.com/mcp/",
      "headers": {
        "Authorization": "Bearer STICKY-API-..."
      }
    }
  }
}

Les clients qui ne parlent que stdio peuvent utiliser la passerelle mcp-remote présentée dans la section Claude Desktop.

MCP Inspector

MCP Inspector est le moyen le plus rapide de voir précisément quels outils votre clé expose et de les appeler à la main.

zsh

$ npx @modelcontextprotocol/inspector

Dans l’Inspector, choisissez le transport Streamable HTTP, saisissez https://api.stickyprompts.com/mcp/, ajoutez un header Authorization avec Bearer STICKY-API-..., puis connectez-vous. List Tools affiche les outils que les autorisations de votre clé permettent.

Handshake brut avec curl

Parler le protocole à la main est utile pour le débogage. Commencez par initialiser une session et notez le header de réponse Mcp-Session-Id :

curl -i https://api.stickyprompts.com/mcp/ \
  -H "Authorization: Bearer $STICKY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'

La réponse présente le serveur comme StickyPrompts 1.0.0 avec la capacité tools, et contient un header comme Mcp-Session-Id: mcp-session-<uuid>. Listez ensuite les outils en envoyant cet identifiant de session :

curl https://api.stickyprompts.com/mcp/ \
  -H "Authorization: Bearer $STICKY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: mcp-session-..." \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

Puis appelez-en un :

curl https://api.stickyprompts.com/mcp/ \
  -H "Authorization: Bearer $STICKY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: mcp-session-..." \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"list_agents","arguments":{}}}'

Le champ content[0].text du résultat est une chaîne JSON, par exemple {"agents":[{"id":3,"name":"Support Triage","slug":"...","tag":"support-triage"}]}.

Tester la connexion

Une fois la connexion établie, essayez des prompts comme ceux-ci dans votre client. Chacun nécessite l’autorisation indiquée.

Essayez de demander	Outil utilisé	Autorisation
« Liste mes agents StickyPrompts. »	`list_agents`	`agents_get`
« Cherche notre politique de remboursement dans ma base de connaissances. »	`list_knowledge_bases`, `search_knowledge_base`	`knowledge_bases_get`
« Quels modèles d’IA puis-je utiliser dans StickyPrompts ? »	`list_ai_models`	`ai_models_get`
« Affiche mes cinq dernières conversations StickyPrompts. »	`list_conversations`	`conversations_get`
« Exécute mon prompt Renewal Check-in Email pour Bluebird Market. »	`get_prompt`, `run_prompt`	`prompts_get`, `run_prompt`
« Quelles affaires Pipedrive sont à l’étape Proposal Made ? »	`list_crm_connections`, `search_crm_deals`	`integration_crm_get`
« Quelles tables contient la base de données retail de Northwind ? »	`list_database_connections`, `list_database_tables`	`integration_database_get`

Dépannage

Symptôme	Cause probable
`401 {"error":"unauthorized"}`	Le header est absent ou n’a pas la forme `Bearer STICKY-API-...`.
`401 {"error":"Invalid API key"}`	La clé a été mal saisie, tronquée ou supprimée.
Connecté, mais aucun outil ou un outil manquant	La clé n’a pas l’autorisation de cet outil. Modifiez la clé dans Settings > API keys.
`tool '<name>' not found`	Même cause que ci-dessus : un outil sans autorisation ressemble exactement à un outil qui n’existe pas.
Le client ne parvient pas à se connecter à `/mcp`	Utilisez `/mcp/` avec la barre oblique finale ; certains clients ne suivent pas la redirection.
Les appels longs expirent	La musique, la synthèse vocale, la transcription et les modèles lents peuvent prendre du temps. Augmentez le délai d’expiration des requêtes de votre client.

Consultez la Vue d’ensemble de MCP pour comprendre le fonctionnement des sessions, des résultats et des erreurs, et la référence des outils pour les arguments de chaque outil.