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

リモートまたはローカルを選ぶ

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

どちらも同じ公開ツールを提供します: get_brief、list_experience、get_entry、list_lenses、 search_jenks、get_document、ask_jenks。詳しくは MCP ツール リファレンス をご覧ください。

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

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

Claude Code

リモート:

claude mcp add --transport http jenks https://jenksguo.pages.dev/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.pages.dev/mcp をカスタムコネクタとして追加します。

Cursor

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

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

ローカル:

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

ChatGPT

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

その他のクライアント

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

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

管理者版（Jenks のみ）

管理者サーバーは admin_* ツール（読み取り、検証、書き込み、AI 編集、デプロイ状況、プロモート）を追加します。 コンソールで Jenks が作成するエージェントトークン（jgx_agt_…）が必要です — AI エージェントにアクセスを付与する をご覧ください。各呼び出しはトークンのスコープに照らして確認され、監査ログに記録されます。

リモート（ヘッダー付き）:

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

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

export JENKSGUO_ADMIN_TOKEN=jgx_agt_…   # from your Keychain or password manager
jenks mcp --admin

可能であれば、JSON 設定ではトークンをファイルへ書き込むのではなく env を介して渡してください。 トークンを含む設定ファイルを共有しないでください。

トラブルシューティング

• ツールが表示されない: クライアントを再起動し、jenks --version が PATH にあることを確認します。
• 429 が ask_jenks から返る: アシスタントがレート制限中です。1 分ほどお待ちください。
• /mcp/admin で 401: トークンが欠落、誤り、期限切れ、または取り消しされています（エラーに原因が表示されます）。
• 403 missing_scope: そのツールに必要なスコープがトークンにありません。メッセージに不足しているスコープ名が示されます。