Skip to main content
JGJenks Guo

ドキュメント / how to

クライアントに Jenks MCP サーバーを追加します

リモートまたはローカルの Jenks MCP サーバー(管理者向けバリアントを含む)を使用するように Claude Code、Claude Desktop、Cursor、または ChatGPT を設定します。

リモートかローカルを選びます

  • Remote — https://jenksguo.xyz/mcp (Streamable HTTP, JSON-RPC 2.0)。インストールは不要です。 クライアントがリモート MCP サーバーをサポートしている場合に使用します。
  • Local — jenks CLI は jenks mcp で stdio 上に MCP サーバーを起動します。実サイトへの呼び出しをフォワードします。クライアントがローカル(stdio)サーバーのみをサポートしている場合に使用します。

どちらも同じ公開ツールを提供します: get_brief, list_experience, get_entry, list_lenses, search_jenks, get_document および ask_jenks。 MCP tools reference を参照してください。

まず CLI をインストールします:

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

Claude Code

リモート:

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

ローカル:

claude mcp add jenks -- jenks mcp

Claude Code 内で /mcp で確認します。

Claude Desktop

claude_desktop_config.json を編集し、Claude Desktop を再起動します。ローカルサーバーの場合:

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

使用中のバージョンがリモートサーバーをサポートしている場合は、代わりにアプリの設定で https://jenksguo.xyz/mcp をカスタムコネクタとして追加します。

Cursor

~/.cursor/mcp.json(またはプロジェクトの .cursor/mcp.json)に追加します。リモート:

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

ローカル:

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

ChatGPT

ChatGPT のプランとクライアントがカスタムコネクタ(開発者モード)をサポートしている場合は、サーバー URL https://jenksguo.xyz/mcp でコネクタを作成します。公開ツールには認証は不要です。 コネクタが利用できない場合は、https://jenksguo.xyz/agents の Open in ChatGPT ボタンを使用します。公開ファイルを読み取るチャットが開始されます。

その他のクライアント

リモート URL を指定するか、jenks mcp を stdio コマンドとして実行します。https://jenksguo.xyz/mcp への GET リクエストは、プロトコルバージョン、ツール名、JSON-RPC 呼び出し例を含むディスカバリードキュメントを返します:

curl -s https://jenksguo.xyz/mcp

管理者向けバリアント(Jenks のみ)

管理者サーバーは admin_* ツール(read、validate、write、AI-edit、deploy status、promote)を追加します。 Keychain に agent-env:JENKSGUO_ADMIN_TOKEN として保存された個人用管理トークンが必要です。

リモート(ヘッダー付き):

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

ローカル(環境変数でトークンを渡す):

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

JSON 設定では、可能な限りファイルへ直接書き込まずに env を介してトークンを渡します。トークンを含む設定ファイルを共有してはいけません。

トラブルシューティング

  • ツールが表示されない: クライアントを再起動します。jenks --version が PATH にあることを確認します。
  • ask_jenks の 429: アシスタントがレート制限されています。しばらくお待ちください。
  • /mcp/admin の 401: トークンが存在しない、不正である、またはローテーションされている可能性があります。

.mdこのページはAIの支援で翻訳されています。正式な肩書は英語のままです。