Connecter un client MCP à un serveur Apigent

Pour les personnes qui utilisent un serveur MCP publié avec Apigent. Le principe est le même dans tous les clients : vous donnez l'adresse du serveur, le client ouvre votre navigateur pour la connexion, les outils apparaissent dans la conversation.

Ce qu'il vous faut

• L'adresse du serveur, de la forme https://mcp.apigent.fr/<identifiant>. L'éditeur vous la donne, ou vous la lisez sur la page publique du serveur (https://apigent.fr/s/<identifiant>), qui rappelle aussi qui peut s'y connecter.
• Un compte chez l'éditeur, ou un compte créé au premier login si l'éditeur l'autorise. Aucun mot de passe ni jeton n'est jamais saisi dans le client : la connexion se fait dans votre navigateur.

Si le serveur est réservé aux membres de l'espace de l'éditeur, il faut d'abord y être invité.

Claude Desktop et claude.ai

1. Réglages → Connecteurs → Ajouter un connecteur personnalisé.
2. Un nom libre, l'adresse du serveur, puis Ajouter.
3. Claude ouvre votre navigateur : connectez-vous avec votre compte chez l'éditeur (ou créez-le), acceptez l'accès demandé, revenez dans Claude.
4. Les outils du serveur apparaissent dans la conversation suivante.

Claude Code

claude mcp add --transport http <nom> https://mcp.apigent.fr/<identifiant>

À la première utilisation, la commande /mcp propose de s'authentifier et ouvre le navigateur.

Cursor

Dans mcp.json (Réglages → MCP), au niveau du projet ou de l'utilisateur :

{ "mcpServers": { "<nom>": { "url": "https://mcp.apigent.fr/<identifiant>" } } }

Cursor ouvre le navigateur pour la connexion au premier appel.

Clients qui ne parlent que stdio

Certains clients plus anciens ne savent lancer qu'un programme local. mcp-remote fait le pont et gère la connexion dans le navigateur :

{ "mcpServers": { "<nom>": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.apigent.fr/<identifiant>"] } } }

Scripts et agents sans navigateur

Un programme qui ne peut pas ouvrir de navigateur s'authentifie avec un token d'accès que l'éditeur crée pour lui (un par client, révocable). Il se place dans l'en-tête Authorization :

curl -X POST https://mcp.apigent.fr/<identifiant> \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Quand un outil demande de connecter un compte

Certains outils appellent l'API de l'éditeur avec votre compte (vos commandes, votre profil…). La première fois :

• si votre client sait ouvrir un lien (Claude Desktop, clients récents), il vous propose d'ouvrir la page de connexion d'Apigent ; connectez votre compte, revenez dans le client, l'appel reprend tout seul ;
• sinon, l'outil répond avec un lien à ouvrir dans le navigateur ; connectez votre compte, puis relancez l'outil.

Vos comptes connectés sont visibles, et déconnectables, sur https://apigent.fr/autoriser.

Se déconnecter

• Dans le client : retirez le connecteur (Claude), claude mcp remove <nom> (Claude Code), l'entrée de mcp.json (Cursor).
• Côté Apigent : https://apigent.fr/autoriser → Se déconnecter. Les jetons d'accès du client expirent en cinq minutes ; un client enregistré est supprimé automatiquement après 90 jours sans usage.

Problèmes courants

Symptôme	Cause probable	Que faire
« Access denied: this server is reserved for the members… »	Serveur réservé aux membres de l'espace, ou compte d'un autre espace	Demander une invitation à l'éditeur, puis se reconnecter
« open by invitation only »	Serveur sur invitation, votre adresse n'est pas dans la liste, ou n'est pas vérifiée	Demander à l'éditeur d'ajouter votre adresse, vérifier votre email
L'outil répond « Sign in to … first »	Votre compte de l'API n'est pas encore connecté pour cette connexion	Ouvrir le lien donné, connecter le compte, relancer
« has expired and could not be renewed »	Session de l'API expirée, sans renouvellement possible	Se reconnecter via le lien
Le navigateur ne s'ouvre pas	Client sans OAuth (script, machine)	Utiliser un token d'accès fourni par l'éditeur