Ajouter le serveur MCP Jenks à votre client

Choisir distant ou local

• Distant — https://jenksguo.pages.dev/mcp (HTTP diffusable, JSON-RPC 2.0). Rien à installer. Utilisez-le lorsque votre client prend en charge les serveurs MCP distants.
• Local — le jenks CLI exécute un serveur MCP sur stdio avec jenks mcp. Il transfère les appels vers le site en ligne. Utilisez-le lorsque votre client ne prend en charge que les serveurs locaux (stdio).

Les deux exposent les mêmes outils publics : get_brief, list_experience, get_entry, list_lenses, search_jenks, get_document et ask_jenks. Voir la Référence des outils MCP.

Pour installer d'abord le CLI :

curl -fsSL https://jenksguo.pages.dev/downloads/install.sh | sh
jenks --version

Claude Code

Distant :

claude mcp add --transport http jenks https://jenksguo.pages.dev/mcp

Local :

claude mcp add jenks -- jenks mcp

Vérifiez avec /mcp dans Claude Code.

Claude Desktop

Modifiez claude_desktop_config.json et redémarrez Claude Desktop. Pour le serveur local :

{
  "mcpServers": {
    "jenks": { "command": "jenks", "args": ["mcp"] }
  }
}

Si votre version prend en charge les serveurs distants, ajoutez https://jenksguo.pages.dev/mcp comme connecteur personnalisé dans les paramètres de l'application à la place.

Cursor

Ajoutez à ~/.cursor/mcp.json (ou au .cursor/mcp.json du projet). Distant :

{
  "mcpServers": {
    "jenks": { "url": "https://jenksguo.pages.dev/mcp" }
  }
}

Local :

{
  "mcpServers": {
    "jenks": { "command": "jenks", "args": ["mcp"] }
  }
}

ChatGPT

Lorsque votre offre et votre client ChatGPT prennent en charge les connecteurs personnalisés (mode développeur), créez un connecteur avec l'URL du serveur https://jenksguo.pages.dev/mcp. Aucune authentification n'est requise pour les outils publics. Si les connecteurs ne sont pas disponibles, utilisez le bouton Open in ChatGPT sur https://jenksguo.pages.dev/agents — il démarre une conversation qui lit à la place les fichiers publics.

Tout autre client

Pointez-le vers l'URL distante, ou exécutez jenks mcp comme commande stdio. Une requête GET vers https://jenksguo.pages.dev/mcp renvoie un document de découverte avec la version du protocole, les noms des outils et des exemples d'appels JSON-RPC :

curl -s https://jenksguo.pages.dev/mcp

Variante admin (Jenks uniquement)

Le serveur admin ajoute les outils admin_* (lecture, validation, écriture, édition par IA, état de déploiement, promotion). Il nécessite un jeton d'agent (jgx_agt_…) que Jenks crée dans la console — voir Donner l'accès à un agent IA. Chaque appel est vérifié par rapport aux périmètres (scopes) du jeton et écrit dans le journal d'audit.

Distant, avec un en-tête :

claude mcp add --transport http jenks-admin https://jenksguo.pages.dev/mcp/admin \
  --header "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"

Local, avec le jeton dans l'environnement :

export JENKSGUO_ADMIN_TOKEN=jgx_agt_…   # depuis votre trousseau ou gestionnaire de mots de passe
jenks mcp --admin

Dans une configuration JSON, passez le jeton via env plutôt que de l'écrire dans le fichier lorsque c'est possible. Ne partagez jamais un fichier de configuration qui contient le jeton.

Dépannage

• Les outils n'apparaissent pas : redémarrez le client ; vérifiez que jenks --version est dans votre PATH.
• 429 depuis ask_jenks : l'assistant est limité en débit ; attendez une minute.
• 401 sur /mcp/admin : le jeton est manquant, incorrect, expiré ou révoqué (le message d'erreur précise lequel).
• 403 missing_scope : le jeton n'a pas le périmètre requis pour cet outil ; le message le nomme.