Permet aux assistants IA de gérer du contenu, de récupérer des articles et de télécharger des médias directement au sein du CMS headless microCMS.
Aussi connu sous microcmsio/microcms-mcp-server
- Étoiles
- 22
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- —
- Dernier commit
- 12 nov. 2026
- Licence
- MIT
Qu'est-ce que microCMS MCP ?
Permet aux assistants IA de gérer du contenu, de récupérer des articles et de télécharger des médias directement au sein du CMS headless microCMS.
Résumé généré à partir du README du projet
À propos du MCP server microCMS
La gestion du contenu d'un CMS headless via des assistants IA est possible grâce à ce MCP server local. Il permet à Claude et à d'autres clients d'interagir directement avec microCMS pour récupérer des articles, créer du nouveau contenu et télécharger des fichiers média. Les développeurs peuvent le configurer en utilisant un seul service ID et une clé API, ou gérer plusieurs services simultanément en fournissant une configuration JSON via la variable d'environnement MICROCMS_SERVICES.
Les utilisateurs peuvent déployer cet outil via npx, un fichier MCP Bundle ou Docker. Pour les environnements d'équipe, il prend en charge un mode de transport HTTP qui nécessite un MCP_AUTH_TOKEN pour un accès distant sécurisé. En mode multi-services, le paramètre serviceId devient obligatoire pour tous les appels d'outils, permettant à l'IA de distinguer différents référentiels de contenu, comme un blog et une boutique. L'outil microcms_get_services et la ressource microcms://services aident l'assistant à identifier les points de terminaison disponibles et la structure des services.
Ce que vous pouvez faire avec
- 1Récupérer les derniers articlesDemandez à votre assistant IA de récupérer les dix articles les plus récents d'un point de terminaison d'actualités spécifique.
- 2Automatiser la création de contenuDemandez à l'IA de faire des recherches sur un sujet et de rédiger un article de fond directement dans le service blog de votre CMS.
- 3Réviser le contenu existantUtilisez l'assistant pour vérifier les erreurs grammaticales ou les formulations peu naturelles dans vos entrées CMS.
- 4Télécharger des fichiers médiaDemandez à l'IA de télécharger une liste d'URL d'images vers votre bibliothèque média microCMS.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer microCMS MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller microCMS MCP dans Claude Code
$ claude mcp add microcms-mcp-server -- npx -y microcms-mcp-serverInstaller microCMS MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"microcms-mcp-server": {
"command": "npx",
"args": [
"-y",
"microcms-mcp-server"
]
}
}
}Installer microCMS MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"microcms-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"microcms-mcp-server"
]
}
}
}Installer microCMS MCP dans VS Code CLI
$ code --add-mcp '{"name":"microcms-mcp-server","type":"stdio","command":"npx","args":["-y","microcms-mcp-server"]}'Installer microCMS MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"microcms-mcp-server": {
"command": "npx",
"args": [
"-y",
"microcms-mcp-server"
]
}
}
}Installer microCMS MCP dans Codex
$ codex mcp add microcms-mcp-server -- npx -y microcms-mcp-serverInstaller microCMS MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.microcms-mcp-server] command = "npx" args = ["-y", "microcms-mcp-server"]
Installer microCMS MCP dans Gemini CLI
$ gemini mcp add -s user microcms-mcp-server npx -- -y microcms-mcp-serverInstaller microCMS MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"microcms-mcp-server": {
"command": "npx",
"args": [
"-y",
"microcms-mcp-server"
]
}
}
}Configuration
MCP_AUTH_TOKENMCP_TRANSPORTMICROCMS_API_KEYMICROCMS_SERVICESMICROCMS_SERVICE_ID
| Nom | Description | Type |
|---|---|---|
| MCP_AUTH_TOKEN | — | |
| MCP_TRANSPORT | — | |
| MICROCMS_API_KEY | — | |
| MICROCMS_SERVICES | — | |
| MICROCMS_SERVICE_ID | — |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessiblemicrocmsio/microcms-mcp-server is public and reachablegithub.com/microcmsio/microcms-mcp-server ↗Réussi
- Le nom du package correspond au dépôt sourcemicrocms-mcp-server names microcmsio/microcms-mcp-server as sourcenpmjs.com/package/microcms-mcp-server ↗Réussi
- Provenance du build (attestation Sigstore)Sigstore attestation for microcms-mcp-servernpmjs.com/package/microcms-mcp-server/v/0.12.0#provenance ↗Réussi
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-12github.com/microcmsio/microcms-mcp-server ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from microcms-mcp-serverRéussi
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHubmicroCMS MCP Server (Local)
[!WARNING] このローカルMCPサーバーは、原則として今後更新されません。
新規利用には、microCMSがホストするリモートMCPサーバーの利用を推奨します。
microCMS のローカル環境で動作するMCP(Model Context Protocol)サーバーです。 ClaudeなどのAIアシスタントがmicroCMSのコンテンツ管理システムとやり取りできるようにします。
必要なもの
- microCMSのサービスIDとAPIキー
セットアップ
方法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サーバーとして起動できます。チームメンバーや外部ツールから共有利用する場合に便利です。
HTTPモードでは MCP_AUTH_TOKEN が必須です。未設定・空文字・空白のみの場合は起動に失敗します。stdioモードでは不要です。
以前のバージョンで認証なしのHTTP接続を利用していた場合は、更新前にサーバーのトークンとクライアントの Authorization: Bearer <token> ヘッダーを設定してください。
サーバー側の起動
# 単一サービス
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で起動
# ビルド
npm run build
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認証トークン(HTTPでは必須、stdioでは不要) |
より詳しい使い方
以下の記事でより詳しい使い方を紹介しています。
ライセンス
MIT
Questions sur microCMS MCP
Comment ajouter microCMS MCP à Claude Code ?
Exécutez claude mcp add microcms-mcp-server -- npx -y microcms-mcp-server dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter microCMS MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Puis-je me connecter à plusieurs services microCMS simultanément ?
Oui, en utilisant la variable d'environnement MICROCMS_SERVICES avec un tableau JSON contenant vos identifiants de service et vos clés API.
Un jeton d'authentification est-il requis pour le mode de transport HTTP ?
Oui, le MCP_AUTH_TOKEN est obligatoire lors de l'utilisation du mode de transport HTTP ; s'il n'est pas défini ou s'il est vide, le serveur ne pourra pas démarrer.