microCMS MCPを利用すると、MCP（Model Context Protocol）に対応したAIから、自然言語でmicroCMSのコンテンツやサービス情報を取得・操作できます。
microCMSがMCPサーバーをホスティングするため、利用者自身でローカル環境にMCPサーバーを起動する必要はありません。サービスの接続先URLとAPIキーをMCPクライアントに設定することで利用できます。

利用可能なツール

microCMS MCPで利用可能なツール（提供する機能や操作の単位）と、各ツールに対応するAPIです。
利用できるツールは、設定したAPIキーの権限に従います。書き込み操作を行うツールを利用するには、対象操作に必要な権限を持つAPIキーが必要です。

設定

認証方式

microCMS MCPは、APIキーによるHTTP Bearer認証を使用します。OAuth認証は現時点では未対応です。

microCMS側の設定

microCMS MCPで利用するサービスのサービスIDとAPIキーを取得します。
APIキーには、利用したいツールに対応するAPIを実行するために必要な権限を付与してください。設定方法の詳細は「APIキー（APIの認証と権限管理）」をご参照ください。

MCPクライアント側の設定

ここでは、いくつかのクライアントでの設定例を紹介します。

ChatGPTアプリ

1. ChatGPTアプリで設定を開きます。
2. プラグインを開き、MCPタブを選択します。
3. 追加から[MCPサーバーを追加]を選択します。
4. 接続方式として[ストリーミング可能なHTTP]を選択します。
5. 以下を入力して保存します。${MICROCMS_SERVICE_ID}と${MICROCMS_API_KEY}は、ご自身のサービスIDとAPIキーに置換してください。

Codex

~/.codex/config.tomlに以下を追加します。${MICROCMS_SERVICE_ID}と${MICROCMS_API_KEY}は、ご自身のサービスIDとAPIキーに置換してください。

[mcp_servers.microcms]
url = "https://mcp.microcms.io/mcp/${MICROCMS_SERVICE_ID}"
http_headers = { Authorization = "Bearer ${MICROCMS_API_KEY}" }

Claude Code

以下のコマンドを実行します。${MICROCMS_SERVICE_ID}と${MICROCMS_API_KEY}は、ご自身のサービスIDとAPIキーに置換してください。

claude mcp add --transport http microcms \
  https://mcp.microcms.io/mcp/${MICROCMS_SERVICE_ID} \
  --header "Authorization: Bearer ${MICROCMS_API_KEY}"

Cursor

~/.cursor/mcp.jsonに以下を追加します。${MICROCMS_SERVICE_ID}と${MICROCMS_API_KEY}は、ご自身のサービスIDとAPIキーに置換してください。

{
  "mcpServers": {
    "microcms": {
      "url": "https://mcp.microcms.io/mcp/${MICROCMS_SERVICE_ID}",
      "headers": {
        "Authorization": "Bearer ${MICROCMS_API_KEY}"
      }
    }
  }
}

Notionカスタムエージェント

1. 対象のカスタムエージェントを開きます。
2. 設定からツールとアクセスを開きます。
3. [接続を追加]から[カスタムMCPを追加]を選択します。
4. 以下を入力して[接続]をクリックします。${MICROCMS_SERVICE_ID}と${MICROCMS_API_KEY}は、ご自身のサービスIDとAPIキーに置換してください。

安全に利用するための権限設定

microCMS MCPでは、意図しない操作を防ぐため、microCMS側のAPIキーの権限とMCPクライアント側で有効にするツールの2つのレイヤーで、許可する操作を必要最小限に絞ることを推奨します。

1. APIキーの権限を制限する

microCMS MCPを利用する際は、本番環境などで使用しているAPIキーとは分けて、AI操作専用のAPIキーを作成することを推奨します。
microCMS MCPで実行できる操作は、設定したAPIキーの権限に従います。AI操作専用のAPIキーには、利用目的に必要な権限のみを付与してください。

2. MCPクライアントで利用するツールを制限する

MCPクライアント側でツールを個別に有効・無効にできる場合は、AIが利用できるツールを必要なものだけに制限してください。
たとえば、コンテンツの取得のみを行う場合は、取得に必要な権限のみを付与したAPIキーを使用し、MCPクライアント側でも作成・更新・削除に関するツールを無効にします。

このように、APIキーでmicroCMS MCPで実行できる操作を制限し、MCPクライアント側でAIが利用できるツールを制限することで、必要最小限の権限でmicroCMS MCPを利用できます。

注意事項

• メディアのアップロードは、MCPクライアントによるファイルデータの処理方法によって、処理に時間がかかったり、正常に完了しなかったりする場合があります。
• microCMS MCP経由のAPIリクエストはmicroCMSがホスティングするMCPサーバーから送信されます。送信元IPアドレスは固定されていないため、APIのIPアドレス制限を設定しているサービスでは利用できない場合があります。
• microCMS MCP経由でコンテンツを操作した場合、API経由の操作として扱われます。
• ローカル環境で利用するMCPサーバーについては、GitHubリポジトリを参照してください。