What can you do with this server?

The microCMS MCP Server enables AI assistants like Claude to programmatically manage microCMS content, media, and API configurations across one or more services. Content Retrieval * Fetch lists or specific content entries with filtering, sorting, pagination, and full-text search * Retrieve content with management metadata (status, createdBy, updatedBy, reservationTime, etc.) * Preview draft content by ID Content Creation * Create and immediately publish content, or save as draft * Bulk create multiple content items at once (published or draft), with per-item success/failure reporting Content Update * Fully update or partially patch existing content * Change publication status (publish/draft), update the createdBy field Content Deletion * Delete specific content entries Media Management * List media files with pagination and filename/image filtering * Upload media via base64-encoded data or external URLs * Delete media files by URL API & Schema Information * Retrieve schema details for specific API endpoints * List all available APIs and their types Member Management * Retrieve information about specific team members Multi-Service Support * Connect to multiple microCMS services simultaneously using MICROCMS_SERVICES * Select the target service per request via a serviceId parameter Flexible Deployment * Run locally via npx or MCP Bundle * Deploy as a remote HTTP server or via Docker for shared team access, with configurable transport, port, host, and authentication

Which integrations are available for this server?

Enables configuration of microCMS credentials through environment variables loaded from a .env file. Provides code linting capabilities for the project, available through npm scripts. Serves as the runtime environment for the MCP server, with a minimum requirement of Node.js 18.0.0 or higher. Used for package management and running scripts to build, start, and develop the MCP server. Offers code formatting functionality for the project, available through npm scripts. Used as the development language for the MCP server, with build scripts to compile TypeScript to JavaScript.

How do I use microCMS MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@microCMS MCP Server get the latest 5 blog posts from microCMS" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

microCMS MCP Server

microCMS のMCP（Model Context Protocol）サーバーです。
ClaudeなどのAIアシスタントがmicroCMSのコンテンツ管理システムとやり取りできるようにします。

必要なもの

microCMSのサービスIDとAPIキー

Related MCP server: Aider MCP Server

セットアップ

方法1: MCP Bundle (旧DXTファイル) を使う

Claude Desktopに導入する場合、mcpbファイルを使って簡単にインストールできます。

リリースページから最新の microcms-mcp-server.mcpb をダウンロード
ダウンロードしたmcpbファイルをダブルクリックで開く
サービスIDとAPIキーを設定する

方法2: npx をつかう（単一サービス）

{
  "mcpServers": {
    "microcms": {
      "command": "npx",
      "args": ["-y", "microcms-mcp-server@latest"],
      "env": {
        "MICROCMS_SERVICE_ID": "<MICROCMS_SERVICE_ID>",
        "MICROCMS_API_KEY": "<MICROCMS_API_KEY>"
      }
    }
  }
}

<MICROCMS_SERVICE_ID>, <MICROCMS_API_KEY> はご自身のものに置き換えてください。

設定更新後はクライアントを再起動してください。

方法3: 複数サービスを使う

複数のmicroCMSサービスに接続する場合は、MICROCMS_SERVICES 環境変数にJSON形式でサービス情報を設定します。

{
  "mcpServers": {
    "microcms-multi": {
      "command": "npx",
      "args": ["-y", "microcms-mcp-server@latest"],
      "env": {
        "MICROCMS_SERVICES": "[{\"id\":\"blog\",\"apiKey\":\"xxx-api-key\"},{\"id\":\"shop\",\"apiKey\":\"yyy-api-key\"}]"
      }
    }
  }
}

複数サービスモードの動作

複数サービスモードでは、各ツールに serviceId パラメータが必須になります。

ツール名は単一サービスモードと同じ microcms_* 形式です
各ツール呼び出し時に serviceId を指定してサービスを選択します
設定済みサービスの一覧は microcms_get_services ツールで確認できます
MCPリソース microcms://services からも同様の情報を取得できます

後方互換性

設定方法	モード	serviceIdパラメータ
`MICROCMS_SERVICE_ID` + `MICROCMS_API_KEY`	単一サービス	省略可（自動でデフォルトサービスを使用）
`MICROCMS_SERVICES` (JSON)	複数サービス	必須

従来の環境変数設定をそのまま使う場合、serviceIdを指定せずに今まで通り動作します
両方の設定が存在する場合、MICROCMS_SERVICES が優先されます

利用方法

microCMSのコンテンツを確認する

microCMSの news から最新の記事を10件取得してください

microCMSにコンテンツを作成して入稿する

MCPサーバーの概要や利用例について調べ、それを1000文字程度でまとめてmicroCMSの blogs に入稿してください

microCMSのコンテンツを取得してレビューしてもらう

microCMSの xxxxxx のコンテンツを取得して、日本語的におかしい部分があれば指摘して

microCMSのメディア一覧に画像をアップロードする

次の画像をmicroCMSにアップロードして。

- https://example.com/sample-image-1.png
- https://example.com/sample-image-2.png
- https://example.com/sample-image-3.png

複数サービスモードでの使用例

複数サービスモードでは、サービスIDを指定して各サービスを操作できます。

blogサービスの記事一覧を取得して

shopサービスに新しい商品を追加して

blogの最新記事をshopの商品説明にコピーして

サービス一覧の確認

microcms://services リソースを読み取ることで、設定済みサービスと各サービスのAPI（エンドポイント）一覧を確認できます。AIエージェントはこの情報を使って、指定されたendpointがどのサービスに属するか判断できます。

{
  "mode": "multi",
  "description": "Multi service mode - serviceId parameter is required for all tools. Use the serviceId that contains the endpoint you need.",
  "services": [
    {
      "id": "blog",
      "apis": [
        { "name": "ブログ記事", "endpoint": "blogs", "type": "list" },
        { "name": "カテゴリー", "endpoint": "categories", "type": "list" }
      ]
    },
    {
      "id": "shop",
      "apis": [
        { "name": "商品", "endpoint": "products", "type": "list" },
        { "name": "注文", "endpoint": "orders", "type": "list" }
      ]
    }
  ]
}

方法4: リモートMCPサーバー（HTTP）として使う

HTTPトランスポートを使って、リモートMCPサーバーとして起動できます。チームメンバーや外部ツールから共有利用する場合に便利です。

サーバー側の起動

# 単一サービス
MICROCMS_SERVICE_ID=my-blog \
MICROCMS_API_KEY=your-api-key \
MCP_TRANSPORT=http \
MCP_AUTH_TOKEN=my-shared-secret \
npx microcms-mcp-server

# 複数サービス
MICROCMS_SERVICES='[{"id":"blog","apiKey":"key1"},{"id":"shop","apiKey":"key2"}]' \
MCP_TRANSPORT=http \
MCP_AUTH_TOKEN=my-shared-secret \
npx microcms-mcp-server

クライアント側の設定（mcp-remote経由）

{
  "mcpServers": {
    "microcms-remote": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "http://your-server:3000/mcp",
        "--header", "Authorization:Bearer my-shared-secret"
      ]
    }
  }
}

Dockerで起動

# ビルド
docker build -t microcms-mcp .

# 起動
MCP_AUTH_TOKEN=my-secret \
MICROCMS_SERVICES='[{"id":"blog","apiKey":"key1"}]' \
docker compose up -d

📖 Docker を使ったセットアップ、クライアント別の接続設定、トラブルシューティングの詳細は DOCKER.md を参照してください。

CLIオプション

オプション	環境変数	デフォルト	説明
`--transport`	`MCP_TRANSPORT`	`stdio`	トランスポートモード（`stdio` または `http`）
`--port`	`MCP_HTTP_PORT`	`3000`	HTTPサーバーのポート番号
`--host`	`MCP_HTTP_HOST`	`0.0.0.0`	HTTPサーバーのホスト
-	`MCP_AUTH_TOKEN`	-	Bearer認証トークン（設定時のみ認証が有効）