Skip to main content
JGJenks Guo

Docs / how to

Ajouter le serveur MCP Jenks à votre client

Configurer Claude Code, Claude Desktop, Cursor ou ChatGPT pour utiliser le serveur MCP Jenks distant ou local, y compris la variante admin.

Choisir distant ou local

  • Distant — https://jenksguo.xyz/mcp (HTTP diffusé, JSON-RPC 2.0). Rien à installer. À utiliser lorsque votre client prend en charge les serveurs MCP distants.
  • Local — le CLI jenks exécute un serveur MCP sur stdio avec jenks mcp. Il relaie les appels vers le site en ligne. À utiliser 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.xyz/downloads/install.sh | sh
jenks --version

Claude Code

Distant :

claude mcp add --transport http jenks https://jenksguo.xyz/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.xyz/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.xyz/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.xyz/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.xyz/agents — cela démarre une discussion qui lit les fichiers publics à la place.

Tout autre client

Pointez-le vers l'URL distante, ou exécutez jenks mcp comme commande stdio. Une requête GET vers https://jenksguo.xyz/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.xyz/mcp

Variante admin (Jenks uniquement)

Le serveur admin ajoute les outils admin_* (lecture, validation, écriture, édition par IA, statut de déploiement, promotion). Il nécessite le jeton admin personnel, stocké dans le trousseau comme agent-env:JENKSGUO_ADMIN_TOKEN.

Distant, avec un en-tête :

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

Local, avec le jeton dans l'environnement :

export JENKSGUO_ADMIN_TOKEN="$(security find-generic-password -s agent-env:JENKSGUO_ADMIN_TOKEN -w)"
jenks mcp --admin

Dans une configuration JSON, transmettez 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 soumis à une limite de débit ; attendez une minute.
  • 401 sur /mcp/admin : le jeton manque, est incorrect ou a été renouvelé.

.mdCette page est traduite avec l’aide de l’IA ; les titres officiels restent en anglais.