MCP サーバーを有効にする(設定項目の一覧)
この機能は Ver. 3.3.0 で追加予定の、リリース前の機能です
このページは、アルファ版(Ver. 3.3.0-alpha.1)時点の内容です。正式版までに仕様や設定項目が変わる可能性があります。本番サイトでは使わず、検証環境でお試しください。
MCP サーバーは既定で無効です。このページの手順で有効にします。設定はブログごとで、ルートブログで設定すると子ブログにも効き、子ブログで上書きできます。
設定画面を開く
MCP サーバーの設定は、コンフィグの「REST API設定」の画面にあります。ブログの管理者のユーザーで操作します。
管理画面の「コンフィグ」で、ブログが使っているコンフィグセットの「REST API設定」を開きます(コンフィグセットを使っていない場合は「このブログのコンフィグ(レガシー設定)」の「REST API設定」)。
使っていないコンフィグを編集しないでください
コンフィグセットを設定しているブログでは、「このブログのコンフィグ(レガシー設定)」は使われません。そちらで「MCP サーバーを利用する」をオンにしても、MCP サーバーは有効になりません。画面の上部の「コンフィグセット」の表示で、編集しているコンフィグを確かめてください。
MCP サーバーを有効にする手順
「REST API設定」の「MCP サーバー」の「MCP サーバーを利用する」にチェックを入れます。
「MCP で許可する操作」を選びます。AI に読ませるだけなら「読み取りのみ(デフォルト)」、エントリーの作成・更新もさせるなら「作成・更新まで(削除はできない)」にします。
「ツールの出し方」を選びます。ふつうは「まとめて(compact。デフォルト)」のままにします。
ブラウザ上のアプリから接続するときだけ「許可する Origin」を、接続元を絞るときは「接続元 IP アドレス」(CIDR 表記)を設定します。
「REST API」の「API・MCP を使える権限」に、AI が使うユーザーの権限種別が含まれているかを確かめます(既定は管理者・編集者・投稿者)。
保存します。
有効になったかは、トークンを付けずに MCP サーバーへ POST して確かめられます。有効なら 401、無効なら 404 が返ります。
curl -i -X POST https://example.com/mcp/ \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"ping"}'有効なときの応答の例です(OAuth 認可サーバーが有効なときは、WWW-Authenticate に resource_metadata が付きます)。
HTTP/2 401
content-type: application/problem+json; charset=utf-8
cache-control: no-store
www-authenticate: Bearer realm="a-blog cms", scope="read write", resource_metadata="https://example.com/.well-known/oauth-protected-resource/mcp/"
{"type":"https://developer.a-blogcms.jp/rest-api/problems/missing-token","title":"認証情報がありません。","status":401,"instance":"/mcp/","code":"missing_token"}この確認は監査ログに「MCP の認証に失敗しました」(レベル「注意」)として 1 件残ります。
設定項目(MCP サーバー)
「REST API設定」の画面の「MCP サーバー」の見出しにある項目です。設定キーは、コンフィグのエクスポートや private/config.system.yaml で使う名前です。
項目(画面の名前) | 設定キー | 既定値 | 説明・入力例 |
|---|---|---|---|
MCP サーバー有効化(MCP サーバーを利用する) |
|
|
|
MCP で許可する操作 |
|
| MCP からできる操作の上限です。 |
ツールの出し方 |
|
|
|
許可する Origin |
| 空 | ブラウザ上のアプリから接続するときに許可する Origin です。例: |
接続元 IP アドレス |
| 空 | MCP サーバーに接続できる IP アドレスを CIDR 表記で制限します。例: |
MCP にも効くほかの設定
次の設定は REST API と MCP で共通です。「REST API設定」の画面の「REST API」の見出しにあります。
項目(画面の名前) | 設定キー | 既定値 | MCP への効き方 |
|---|---|---|---|
REST API の外部からの利用(外部からの REST API の利用を許可する) |
|
| MCP サーバーには影響しません。オフのままでも MCP は使えます。 |
API・MCP を使える権限 |
| 管理者・編集者・投稿者 | チェックの無い権限種別のユーザーのトークンは、MCP でも 403( |
接続元 IP アドレス |
| 空 | MCP の「接続元 IP アドレス」が空のときだけ、MCP にも使います。 |
リクエスト上限 |
|
| トークンごとの 1 分あたりの上限です。超えると 429( |
匿名のリクエスト上限 |
|
| トークンを使わないリクエストの上限です。MCP は常にトークンで認証するため、MCP のツールの呼び出しには関係しません。 |
管理画面からのリクエスト上限 |
|
| ログイン中のブラウザからの呼び出しの上限です。MCP には関係しません。 |
認証失敗の上限 |
|
| 接続元 IP アドレスごとの 1 分あたりの認証の失敗の上限です。達すると 10 分間 429 になります。トークンを貼り間違えたまま試し続けると、正しいトークンでも 10 分間つながりません。 |
削除などの操作の上限 |
|
| 削除などの操作の、トークンごとの 1 時間あたりの上限です。0 は上限なしです。MCP の削除にも効きます。 |
(画面にはありません) |
|
| MCP のリクエストの本文の上限(バイト)です。超えると 413( |
画面に無い設定は private/config.system.yaml に書きます。
# private/config.system.yaml(画面に無い設定を変えるときだけ書く)
rest_api_max_body_size: 4194304新しい接続(OAuth でアプリを接続した・API トークンを発行した)を本人へ知らせるメールは、コンフィグの「メール設定」の「API の接続の通知」で設定します。
項目(画面の名前) | 設定キー | 既定値 | 説明・入力例 |
|---|---|---|---|
通知(新しい接続をメールで知らせる) |
|
| OAuth でアプリを接続したときと、API トークンを発行したときに、本人へメールで知らせます。 |
From |
|
| 差出人です。既定のままでは届かないことが多いため、サイトのアドレスに変えます。 |
To |
| 空 | 本人のほかにも知らせる宛先です。カンマ区切りで複数指定できます。例: |
件名テンプレート |
|
| メールの件名のテンプレートの場所です。 |
本文テンプレート(TEXT) |
|
| テキストの本文のテンプレートの場所です。 |
本文テンプレート(HTML) |
|
| HTML の本文のテンプレートの場所です。 |
MCP で許可する操作
トークンのスコープや OAuth の同意とは別に、サイトの管理者が「MCP からできる操作の上限」をブログごとに決めます。プロンプトインジェクション・同意の誤り・トークンの漏えいがあっても、MCP からの被害をこの上限で抑えるためです。MCP サーバーは削除の前に人へ確認を求められないため、削除を許すかどうかはここで決めます。
画面の選択肢 | 値 | MCP からできること |
|---|---|---|
読み取りのみ(デフォルト) |
| 読み取りだけ |
作成・更新まで(削除はできない) |
| 読み取り・作成・更新。削除と、削除に準じる影響の大きい変更はできません |
削除を含むすべての操作 |
| 削除を含むすべての操作 |
操作の種類は HTTP のメソッドで決まります。
GETは読み取り、POST・PUT・PATCHは作成・更新、DELETEは削除です。ルートが「影響の大きい変更」と宣言したものは、POSTなどでも削除と同じ扱いです。上限を超える操作のツールは、ツールの一覧にも
acms_searchの結果にも出ません。名前を指定して呼んでも実行されず、次の 403(forbidden)の結果になります: 「この操作(write)は、サイトの設定「MCP で許可する操作」で止められています(今の上限: read)。必要なら、サイトの管理者に設定の変更を依頼してください。」「作成・更新まで」以下では、エントリーをゴミ箱へ移す更新(本文の
statusをtrashにする更新)も、削除と同じく止まります。トークンのスコープとこの上限は独立して判定し、両方を満たす操作だけを実行します。上限を広げても、トークンに無いスコープの操作はできません。
REST API(
/rest-api/)には掛かりません。今の上限は、
acms_site_overviewの結果のmcp(access_levelと、呼べる操作の種類のallowed_kinds)で確かめられます。
URL の区切り(mcp)を変える
mcp が既存のブログ・カテゴリー・エントリーのコードと重なる場合は、config.server.php で区切りを変えます。REST_API_SEGMENT・MCP_SEGMENT・OAUTH_SEGMENT は互いに同じ値にできません。書かなければ rest-api・mcp・oauth になります。
<?php
// config.server.php(例: mcp の区切りを ai-mcp に変える)
define('REST_API_SEGMENT', 'rest-api');
define('MCP_SEGMENT', 'ai-mcp');
define('OAUTH_SEGMENT', 'oauth');Apache で同梱の .htaccess を使っている場合は、「最後にスラッシュをつける」規則の除外も同じ値に書き換えます。書き換えないと、末尾に / の無い URL への POST が 301 になり、本文が失われます。
# .htaccess の「最後にスラッシュをつける」規則(mcp を ai-mcp に書き換えた例)
RewriteCond %{ENV:has_encoded_query} !1
RewriteCond %{REQUEST_URI} !(^|/)(rest-api|ai-mcp|oauth)(/|$)
RewriteCond %{REQUEST_URI} !^/\.well-known/(oauth-authorization-server|openid-configuration|oauth-protected-resource)(/|$)
RewriteCond %{REQUEST_URI} !/$
RewriteCond %{REQUEST_URI} !\.[^/\.]+$
RewriteRule ^.+[^/]$ %{REQUEST_SCHEME}://%{HTTP_HOST}%{REQUEST_URI}/ [R=301,L].htaccess のほかの確認点は OAuth のメタデータの URL と .htaccess を参照してください。
よくある質問・つまずき
症状 | 原因と確かめ方 |
|---|---|
保存したのに MCP サーバーの URL が 404 のまま | 使っていないコンフィグ(コンフィグセットを使うブログの「このブログのコンフィグ(レガシー設定)」など)を編集していないか、画面の上部の「コンフィグセット」の表示で確かめます。子ブログの URL で接続している場合は、子ブログの設定で無効になっていないかを確かめます。 |
書き込みのツールが出ない・ | 「MCP で許可する操作」が「読み取りのみ」です。トークンのスコープだけでは書き込めません。 |
設定を変えたのに AI のツールの一覧が変わらない | クライアントがツールの一覧を覚えています。Claude Code なら |
403( | 「API・MCP を使える権限」に、トークンのユーザーの権限種別が入っていません(ロールを使うユーザーは、ロールの「API・MCP の接続」)。 |
403( | 接続元 IP アドレスが「接続元 IP アドレス」の範囲の外です。MCP の欄が空なら、REST API の欄の値が使われていることに注意します。 |
403( | リクエストに |
429( | リクエスト上限・認証失敗の上限・削除などの操作の上限のどれかに達しています。認証失敗の上限は 10 分間続きます。 |
