MCPで利用できる操作を調べる
公式資料を検索するMCPと、自分のサイトを操作するMCPを区別します。接続先、認証、権限、操作前の確認を説明します。
目次
MCPは、AIが道具を使うための接続方法
MCPは、AIアプリが外部の情報や操作を使うための共通の接続方式です。EmDashでは「使い方を調べる接続」と「自分の記事を操作する接続」があります。
公式資料を調べたいなら資料検索のMCP、自分の記事を読み書きさせたいなら自分のサイトのMCPを接続します。
接続先は2種類
| 接続先 | できること | 認証 |
|---|---|---|
https://docs.emdashcms.com/mcp | EmDash公式ドキュメントの検索 | 不要。公開・読み取り専用 |
自分のサイトの/_emdash/api/mcp | 記事、分類、画像、設定などの操作 | Bearerトークンが必要 |
公式資料のMCPには、search_docsという検索用の道具があります。検索語に関連する本文と出典URLが返るので、AIにコード例の根拠を調べさせるときに使えます。検索語は外部のサービスへ送られるため、パスワードなどの秘密情報や、非公開の顧客データは入力しません。
自分のサイトを接続する流れ
- 接続するサイトのURLを確かめます。検証サイトか公開サイトかも区別します。
- 使うAIアプリが、認証付きのリモートMCPに対応しているか確認します。
- サイトの
/_emdash/api/mcpを接続先として登録します。 - 対応するOAuth画面で認証するか、専用のBearerトークンを設定します。
- 最初にツール一覧と、読み取り操作の結果を確認します。
OAuthは、ブラウザーで許可する範囲を確認し、パスワードそのものを渡さずにアプリを接続する方式です。Bearerトークンは、接続時に渡す認証用の文字列です。EmDashの管理画面へログインしていても、MCPの接続には別に認証が必要です。
画面上の設定場所はAIアプリと版で変わるため、各アプリの現在の案内に合わせます。EmDash側の接続仕様は公式MCPリファレンス(別タブで開く)が根拠です。
権限を、目的から選ぶ
| やりたいこと | 主なscope |
|---|---|
| 記事や分類を読む | content:read |
| 記事を作る・変える | content:write |
| 画像情報を読む | media:read |
| 画像を登録・変更する | media:write |
| 入力欄の定義を読む | schema:read |
| 入力欄を変更する | schema:write |
| 共通設定を読む | settings:read |
| 共通設定を変える | settings:manage |
| サイト転送の解析だけをする | transfer:analyze |
scopeは接続に許した操作、roleは管理者・編集者など利用者の役割です。たとえば、記事を書く人に設定変更を許していない場合、接続側だけ設定変更のscopeを付けても操作できません。下書きの読み取りなどにも、利用者側の権限が必要です。
adminはEmDash本体の広い範囲の操作を含みます。プラグインが追加したMCPツールには、mcp:toolsやプラグインごとのscopeが別に必要なので、使いたい道具の権限も確認してください。
よく使うツール
| ツール | 操作 |
|---|---|
content_list・content_get | 記事を探して読む |
content_create・content_update | 記事を作る・変更する |
content_publish | 記事を公開する |
content_compare | 公開版と下書きを比較する |
content_delete | ゴミ箱へ移す |
content_permanent_delete | 完全削除する |
schema_list_collections | コレクションを調べる |
media_list・media_upload | 画像などを調べる・送る |
taxonomy_list・menu_list | 分類やメニューを読む |
この表は代表例です。各ツールへ渡す値を引数と呼びます。AIアプリは接続先のtools/listからツール一覧と引数の仕様を取得できるため、実際の操作では、そのサイトの現在の仕様を確認して使います。
実際に引数を調べて記事を1件読み取る手順は、MCPのツール一覧を調べて、記事を1件読むで試せます。
AIへ依頼するときの書き方
「週末ノートの検証サイトで、コーヒー道具の記事を下書きとして1件作成。公開はせず、作成後のIDと本文を確認」のように、接続先・対象・到達状態を伝えます。
既存の記事を変えるなら、先に現在の本文と公開状態を読ませ、残す内容を指定します。「いい感じに整理」だけでは、分類変更なのか削除なのかまで決まりません。
処理の後は、AIの完了文だけでなく管理画面で対象を開きます。公開した場合は、ログアウトした読者向けページも確認します。
接続エラーを読む
MCPのURLを普通のブラウザーで開くと、405エラーになる場合があります。ブラウザーでURLを開く方法はGETですが、サイトMCPはPOSTという方法で、JSON-RPC形式の命令を受け付けるためです。この405だけでは故障と判断せず、MCPに対応するAIアプリから接続を確認します。
401エラーなら認証情報、403エラーならscopeとroleを確認します。使いたいツールが見つからない場合は、サイトで有効にした機能とプラグイン、取得したツール一覧を調べます。接続を使わなくなったら、アプリ側の登録を外し、不要になったトークンも無効にします。