MCPで利用できる操作を調べる

公式資料を検索するMCPと、自分のサイトを操作するMCPを区別します。接続先、認証、権限、操作前の確認を説明します。

目次

MCPは、AIが道具を使うための接続方法

MCPは、AIアプリが外部の情報や操作を使うための共通の接続方式です。EmDashでは「使い方を調べる接続」と「自分の記事を操作する接続」があります。

公式資料を調べたいなら資料検索のMCP、自分の記事を読み書きさせたいなら自分のサイトのMCPを接続します。

接続先は2種類

接続先できること認証
https://docs.emdashcms.com/mcpEmDash公式ドキュメントの検索不要。公開・読み取り専用
自分のサイトの/_emdash/api/mcp記事、分類、画像、設定などの操作Bearerトークンが必要

公式資料のMCPには、search_docsという検索用の道具があります。検索語に関連する本文と出典URLが返るので、AIにコード例の根拠を調べさせるときに使えます。検索語は外部のサービスへ送られるため、パスワードなどの秘密情報や、非公開の顧客データは入力しません。

自分のサイトを接続する流れ

  1. 接続するサイトのURLを確かめます。検証サイトか公開サイトかも区別します。
  2. 使うAIアプリが、認証付きのリモートMCPに対応しているか確認します。
  3. サイトの/_emdash/api/mcpを接続先として登録します。
  4. 対応するOAuth画面で認証するか、専用のBearerトークンを設定します。
  5. 最初にツール一覧と、読み取り操作の結果を確認します。

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を確認します。使いたいツールが見つからない場合は、サイトで有効にした機能とプラグイン、取得したツール一覧を調べます。接続を使わなくなったら、アプリ側の登録を外し、不要になったトークンも無効にします。

公式の参照元

関連ガイド

メニュー
ホーム公式ドキュメント (別タブで開く)

キーワードを入力すると、ガイドの内容から探せます。