本文へスキップ
GENNAI
導入の相談をする

Model Context Protocol

MCP

AI エージェントが、管理画面と同じデータを直接読み書きするための API です。記事・パーツ・画像・SEO データ・タスク・Wiki を 43 のツールで扱えます。

  • 43ツール
  • 6カテゴリ
  • スコープでトークンごとに権限

しくみ

1

AI エージェント

Claude などの MCP クライアント。スキルが手順を持つ

2

MCP サーバー

manifest からツールを自動生成（stdio / Streamable HTTP）

3

GENNAI CMS

/api/mcp/*（Bearer トークン + スコープ）

トークンとスコープ

  • ・トークンは管理画面「MCP 連携」で発行。用途ごとに分けて作れます
  • ・読み取り（posts.read）と書き込み（posts.write）など、スコープ単位で許可
  • ・画像の発注だけ・レポートを読むだけ、といった最小権限のエージェントを作れます
  • ・プラグインは自分のツールとスコープを追加できます（cms.mcp.tools / cms.mcp.scopes）
ツールの一覧を取得する
curl -H "Authorization: Bearer <トークン>" \
  http://localhost:<CMSポート>/api/mcp/manifest

MCP サーバーは起動時にこの manifest を読んでツールを作るので、CMS 側にツールを足せば、エージェント側は設定を変えずに使えるようになります。

ツール一覧

記事5

posts.read / posts.write
  • GETposts.list記事一覧（検索・並べ替え）
  • GETposts.get記事を本文ごと取得
  • POSTposts.create記事を新規作成（全項目）
  • PATCHposts.updateリライト・メタ情報・パーツの紐付けを更新
  • GETcategories.listカテゴリ一覧

パーツ10

parts.read / parts.write
  • GETparts.listパーツ一覧
  • GETparts.getパーツを取得
  • POSTparts.createパーツを作成
  • PATCHparts.updateパーツを更新
  • POSTparts.preview変数を当てて HTML をプレビュー
  • GETpart_groups.listパーツグループ一覧
  • GETpart_groups.getグループを中身ごと取得
  • POSTpart_groups.createグループを作成
  • PATCHpart_groups.updateグループを更新（中身を同期）
  • POSTpart_groups.previewグループの HTML をプレビュー

クリエイティブ（画像）10

creatives.read / creatives.write
  • GETcreatives.listクリエイティブ一覧
  • GETcreatives.getクリエイティブを取得
  • POSTcreatives.create画像を発注
  • PATCHcreatives.updateクリエイティブを更新
  • POSTcreatives.insert_to_post記事本文の指定位置に挿入
  • GETcreatives.versions_listバージョン一覧
  • POSTcreatives.set_final_version納品するバージョンを確定
  • GETcreative_codex_jobs.list生成ジョブ一覧
  • POSTcreative_codex_jobs.claim生成ジョブを引き受ける（ワーカー用）
  • PATCHcreative_codex_jobs.update生成結果を報告

SEO・分析5

reports.read / analytics.read
  • GETreports.listSEO 日報の一覧
  • GETreports.getSEO 日報の詳細
  • GETreports.latest最新の SEO 日報
  • GETsearch.performanceSearch Console の検索パフォーマンス
  • GETkeywords.listターゲットキーワード一覧

タスク・Wiki12

tasks.* / wiki.*
  • GETepics.listエピック一覧
  • GETepics.getエピックを取得
  • POSTepics.createエピックを作成
  • PATCHepics.updateエピックを更新
  • GETtasks.listタスク一覧（状態・優先度で絞り込み）
  • GETtasks.getタスクを取得
  • POSTtasks.createタスクを起票
  • PATCHtasks.updateタスクを更新（ステータス遷移など）
  • GETwiki.listWiki ページ一覧
  • GETwiki.getWiki ページを取得
  • POSTwiki.createWiki ページを作成
  • PATCHwiki.updateWiki ページを更新

コンテンツの書き出し1

content.export
  • POSTcontent.exportDB のコンテンツをファイルに書き出して git にコミット
MCP を使うスキルを見るプラグインでツールを足す