ドキュメント / reference
MCP ツール
公開および管理用の MCP サーバー上のすべてのツール、その引数と例をまとめます。
サーバー
| サーバー | URL | 認証 |
|---|---|---|
| パブリック | https://jenksguo.xyz/mcp |
なし |
| 管理 | https://jenksguo.xyz/mcp/admin |
Authorization: Bearer <admin token> |
| ローカル (stdio) | jenks mcp / jenks mcp --admin |
env JENKSGUO_ADMIN_TOKEN(管理用) |
トランスポート: Streamable HTTP、ステートレス、POST 上の JSON-RPC 2.0(プロトコル 2025-06-18)。いずれの URL への GET でもディスカバリードキュメントを返します。サーバー名は jenksguo、バージョンは 1.1.0 です。
curl -s https://jenksguo.xyz/mcp -H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_brief","arguments":{}}}'
パブリックツール
get_brief — Jenks のブリーフを取得
Jenks Guo の 1 ページ Markdown ブリーフです: ポジショニング、現在の役割、キャリアの軌跡、強み、言語、連絡先、さらに深掘りする方法をまとめています。ここから始めてください。
- MCP:
get_briefonhttps://jenksguo.xyz/mcp - REST:
GET /api/v1/brief - CLI:
jenks brief
引数はありません。
curl -s "https://jenksguo.xyz/api/v1/brief"
list_experience — 経験を一覧表示
Jenks の経験・プロジェクト・コミュニティでの役割・学歴を(新しい順で)一覧表示し、業界タグ・ロールレンズ・種類で任意にフィルタリングできます。短い形式(タイトル、組織、期間、概要、主要成果、ページ URL)を返します。
- MCP:
list_experienceonhttps://jenksguo.xyz/mcp - REST:
GET /api/v1/entries?tag=&lens=&kind=&locale= - CLI:
jenks list [--tag it] [--lens solution-architect] [--kind project]
| 引数 | 型 | 必須 | 備考 |
|---|---|---|---|
tag |
it · engineering · ai · devrel · web3 · business · marketing · consulting · hospitality · community · creative |
いいえ | |
lens |
head-of-ai · ai-transformation-consultant · engineering-manager · solution-architect · system-integrator · support-engineer · ict-specialist · developer-advocate · developer-evangelist · digital-marketer · hospitality |
いいえ | |
kind |
experience · education · community · project |
いいえ | |
locale |
en · zh · zh-hant · ja · fr · es · eo |
いいえ | 翻訳フィールドの言語(既定 en)です。 |
curl -s "https://jenksguo.xyz/api/v1/entries"
get_entry — 1 件のエントリを取得
スラッグで指定した経験・プロジェクト・コミュニティでの役割・学歴エントリの長文解説です: 概要、Jenks が行ったこと、成果、雇用主にとっての重要性、主要結果、スキル、証跡リンクを含みます。
- MCP:
get_entryonhttps://jenksguo.xyz/mcp - REST:
GET /api/v1/entries/{slug}?locale= - CLI:
jenks get <slug>
| 引数 | 型 | 必須 | 備考 |
|---|---|---|---|
slug |
string | はい | エントリのスラッグ。例: xero-developer-evangelist |
locale |
en · zh · zh-hant · ja · fr · es · eo |
いいえ | 翻訳フィールドの言語(既定 en)です。 |
curl -s "https://jenksguo.xyz/api/v1/entries/xero-developer-evangelist"
list_lenses — ロールレンズを一覧表示
雇用主が Jenks をどのロール観点で見られるか(Head of AI、solution architect、developer advocate、digital marketer、hospitality…)を、ピッチ、正直なギャップ、エビデンス数とともに示します。
- MCP:
list_lensesonhttps://jenksguo.xyz/mcp - REST:
GET /api/v1/lenses?locale= - CLI:
jenks lenses
| 引数 | 型 | 必須 | 備考 |
|---|---|---|---|
locale |
en · zh · zh-hant · ja · fr · es · eo |
いいえ | 翻訳フィールドの言語(既定 en)です。 |
curl -s "https://jenksguo.xyz/api/v1/lenses"
search_jenks — コーパスを検索
すべてのエントリとドキュメントを横断してキーワード検索します。最も一致度の高いパッセージとそのスラッグを返します。
- MCP:
search_jenksonhttps://jenksguo.xyz/mcp - REST:
GET /api/v1/search?q= - CLI:
jenks search "<query>"
| 引数 | 型 | 必須 | 備考 |
|---|---|---|---|
query |
string | はい |
curl -s "https://jenksguo.xyz/api/v1/search"
get_document — ドキュメントを取得
Jenks のリファレンスドキュメントのいずれかです: profile(中核プロフィール)、credentials(学歴・認定)、capabilities(能力 → エビデンスの対応表)、talks(講演・ポッドキャスト・執筆)、thinking(世界観)。
- MCP:
get_documentonhttps://jenksguo.xyz/mcp - REST:
GET /api/v1/documents/{name}?locale= - CLI:
jenks doc <name>
| 引数 | 型 | 必須 | 備考 |
|---|---|---|---|
name |
profile · credentials · capabilities · talks · thinking |
はい | |
locale |
en · zh · zh-hant · ja · fr · es · eo |
いいえ | 翻訳フィールドの言語(既定 en)です。 |
curl -s "https://jenksguo.xyz/api/v1/documents/credentials"
ask_jenks — Jenks のアシスタントに質問
Ask Jenks アシスタントに自然言語で質問します(ロール適合、コンサルのスコーピング、AI トランスフォーメーション助言、STAR ストーリー、ガバナンス…)。コーパス上で独自のツールを実行し、要求言語で回答します。レート制限があります。
- MCP:
ask_jenksonhttps://jenksguo.xyz/mcp - REST:
POST /api/v1/ask - CLI:
jenks ask "<question>"
| 引数 | 型 | 必須 | 備考 |
|---|---|---|---|
question |
string | はい | |
locale |
en · zh · zh-hant · ja · fr · es · eo |
いいえ | 翻訳フィールドの言語(既定 en)です。 |
history |
array | いいえ | 以前のターンを任意で渡せます。 |
curl -s -X POST https://jenksguo.xyz/api/v1/ask \
-H 'content-type: application/json' \
-d '{"question":"Is Jenks a fit for a Head of AI role?"}'
管理ツール
admin_schema — コンテンツスキーマ
コンテンツモデルです: エントリのフィールドとルール、タグ、レンズ、種類、書き込み可能なパス、ドキュメント、編集規約。書き込む前にお読みください。
- MCP:
admin_schemaonhttps://jenksguo.xyz/mcp/admin - REST:
GET /api/admin/schema(admin token) - CLI:
jenks admin schema
引数はありません。
curl -s "https://jenksguo.xyz/api/admin/schema" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_list_files — コンテンツファイルを一覧表示
ブランチ上の編集可能なコンテンツファイル(パス、サイズ、sha)を一覧表示します。content/corpus/experiences のような 1 つのフォルダ内に限定することもできます。
- MCP:
admin_list_filesonhttps://jenksguo.xyz/mcp/admin - REST:
GET /api/admin/files?dir=&branch=(admin token) - CLI:
jenks admin ls [dir]
| 引数 | 型 | 必須 | 備考 |
|---|---|---|---|
dir |
string | いいえ | 例: content/corpus/projects(既定: すべてのコンテンツ) |
branch |
main · dev |
いいえ | main は jenksguo.xyz に公開、dev は dev.jenksguo.xyz でプレビュー(既定 main)です。 |
curl -s "https://jenksguo.xyz/api/admin/files" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_read_file — コンテンツファイルを読み取り
コンテンツファイルの生の Markdown/JSON ソース(およびその sha)を読み取ります。path を渡すか、エントリ・レンズ・スキルには slug を渡します。
- MCP:
admin_read_fileonhttps://jenksguo.xyz/mcp/admin - REST:
GET /api/admin/file?path=&slug=&branch=(admin token) - CLI:
jenks admin get <slug|path>
| 引数 | 型 | 必須 | 備考 |
|---|---|---|---|
path |
string | いいえ | |
slug |
string | いいえ | |
branch |
main · dev |
いいえ | main は jenksguo.xyz に公開、dev は dev.jenksguo.xyz でプレビュー(既定 main)です。 |
curl -s "https://jenksguo.xyz/api/admin/file" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_validate — 変更を検証
コミットせずにファイル内容をコンテンツスキーマに対して検証します。問題の一覧を返します(空 = 有効)。
- MCP:
admin_validateonhttps://jenksguo.xyz/mcp/admin - REST:
POST /api/admin/validate(admin token) - CLI:
jenks admin validate <path> <file>
| 引数 | 型 | 必須 | 備考 |
|---|---|---|---|
path |
string | はい | |
content |
string | はい |
curl -s -X POST https://jenksguo.xyz/api/admin/validate \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"path":"content/corpus/projects/example.md","content":"<content>"}'
admin_write_file — コンテンツファイルを作成・更新
単一のコンテンツファイルを検証してコミットします(作成または置換)。公開は自動です: CI が変更されたエントリをすべての言語に再翻訳し、数分でリビルドとデプロイを行います(main → jenksguo.xyz、dev → dev.jenksguo.xyz)。
- MCP:
admin_write_fileonhttps://jenksguo.xyz/mcp/admin - REST:
PUT /api/admin/file(admin token) - CLI:
jenks admin put <path> <file> -m <message>
| 引数 | 型 | 必須 | 備考 |
|---|---|---|---|
path |
string | はい | |
content |
string | はい | |
message |
string | はい | コミットメッセージ |
branch |
main · dev |
いいえ | main は jenksguo.xyz に公開、dev は dev.jenksguo.xyz でプレビュー(既定 main)です。 |
curl -s -X PUT https://jenksguo.xyz/api/admin/file \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"path":"content/corpus/projects/example.md","content":"<content>","message":"<message>"}'
admin_delete_file — コンテンツファイルを削除
単一のコンテンツファイル(例: エントリの削除)をコミットメッセージ付きで削除します。Git の履歴により復元可能です。
- MCP:
admin_delete_fileonhttps://jenksguo.xyz/mcp/admin - REST:
DELETE /api/admin/file?path=&message=&branch=(admin token) - CLI:
jenks admin rm <path> -m <message>
| 引数 | 型 | 必須 | 備考 |
|---|---|---|---|
path |
string | はい | |
message |
string | はい | |
branch |
main · dev |
いいえ | main は jenksguo.xyz に公開、dev は dev.jenksguo.xyz でプレビュー(既定 main)です。 |
curl -s -X DELETE https://jenksguo.xyz/api/admin/file \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"path":"content/corpus/projects/example.md","message":"<message>"}'
admin_commit_changes — 複数ファイルを一括コミット
複数のファイル変更を1つのコミットとして検証・コミットします。各変更は {path, content} または {path, delete: true} です。
- MCP:
admin_commit_changesonhttps://jenksguo.xyz/mcp/admin - REST:
POST /api/admin/changes(admin token) - CLI:
jenks admin commit <changes.json> -m <message>
| 引数 | 型 | 必須 | 備考 |
|---|---|---|---|
changes |
array | はい | |
message |
string | はい | |
branch |
main · dev |
いいえ | main は jenksguo.xyz に公開、dev は dev.jenksguo.xyz でプレビュー(既定 main)です。 |
curl -s -X POST https://jenksguo.xyz/api/admin/changes \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"changes":"<changes>","message":"<message>"}'
admin_ai_edit — AI で編集案を作成
サイトのモデルに、英語の平易な指示から 1 つのコンテンツファイルを書き直すよう依頼します。提案内容、diff、検証上の問題を返します。コミットはしません — レビューしてから admin_write_file を呼び出してください。
- MCP:
admin_ai_editonhttps://jenksguo.xyz/mcp/admin - REST:
POST /api/admin/ai-edit(admin token) - CLI:
jenks admin ai-edit <slug|path> "<instruction>" [--apply]
| 引数 | 型 | 必須 | 備考 |
|---|---|---|---|
path |
string | いいえ | |
slug |
string | いいえ | |
instruction |
string | はい | |
branch |
main · dev |
いいえ | main は jenksguo.xyz に公開、dev は dev.jenksguo.xyz でプレビュー(既定 main)です。 |
content |
string | いいえ | 下書きのための未保存ファイルテキストを任意で渡せます(既定: 保存済みファイル)。 |
curl -s -X POST https://jenksguo.xyz/api/admin/ai-edit \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{"instruction":"<instruction>"}'
admin_deploy_status — デプロイ状況
最近の CI 実行(translate → build → deploy)を、ステータス、ブランチ、コミット、リンクとともに表示します。
- MCP:
admin_deploy_statusonhttps://jenksguo.xyz/mcp/admin - REST:
GET /api/admin/deploys?branch=(admin token) - CLI:
jenks admin deploys
| 引数 | 型 | 必須 | 備考 |
|---|---|---|---|
branch |
main · dev |
いいえ | main は jenksguo.xyz に公開、dev は dev.jenksguo.xyz でプレビュー(既定 main)です。 |
curl -s "https://jenksguo.xyz/api/admin/deploys" \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN"
admin_promote — dev を本番へ昇格
dev ブランチを main にマージし、dev.jenksguo.xyz でプレビューされている内容を jenksguo.xyz に公開します。
- MCP:
admin_promoteonhttps://jenksguo.xyz/mcp/admin - REST:
POST /api/admin/promote(admin token) - CLI:
jenks admin promote
| 引数 | 型 | 必須 | 備考 |
|---|---|---|---|
message |
string | いいえ |
curl -s -X POST https://jenksguo.xyz/api/admin/promote \
-H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
-H 'content-type: application/json' \
-d '{}'
.mdこのページはAIの支援で翻訳されています。正式な肩書は英語のままです。