microCMS

Gestiona contenido en el CMS headless microCMS usando sus APIs de contenido y administración.

Documentación

Servidor MCP de microCMS (Local)

[!WARNING] Este servidor MCP local no se actualizará en principio en el futuro.

Para nuevos usos, se recomienda utilizar el servidor MCP remoto alojado por microCMS.

Este es un servidor MCP (Model Context Protocol) que funciona en el entorno local de microCMS. Permite que asistentes de IA como Claude interactúen con el sistema de gestión de contenidos de microCMS.

Requisitos

ID de servicio y clave de API de microCMS

Configuración

Método 1: Usar MCP Bundle (archivo DXT anterior)

Para instalar en Claude Desktop, puede instalarlo fácilmente usando el archivo mcpb.

Descargue el último microcms-mcp-server.mcpb desde la página de lanzamientos
Abra el archivo mcpb descargado con doble clic
Configure el ID de servicio y la clave de API

Método 2: Usar npx (servicio único)

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

Reemplace <MICROCMS_SERVICE_ID> y <MICROCMS_API_KEY> con los suyos propios.

Después de actualizar la configuración, reinicie el cliente.

Método 3: Usar múltiples servicios

Para conectarse a múltiples servicios de microCMS, configure la información del servicio en formato JSON en la variable de entorno MICROCMS_SERVICES.

{
  "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\"}]"
      }
    }
  }
}

Funcionamiento del modo de múltiples servicios

En el modo de múltiples servicios, el parámetro serviceId es obligatorio en cada herramienta.

Los nombres de las herramientas tienen el mismo formato microcms_* que en el modo de servicio único
Especifique serviceId en cada llamada a una herramienta para seleccionar el servicio
La lista de servicios configurados se puede consultar con la herramienta microcms_get_services
También se puede obtener información similar desde el recurso MCP microcms://services

Compatibilidad hacia atrás

Método de configuración	Modo	Parámetro serviceId
`MICROCMS_SERVICE_ID` + `MICROCMS_API_KEY`	Servicio único	Opcional (usa automáticamente el servicio predeterminado)
`MICROCMS_SERVICES` (JSON)	Múltiples servicios	Obligatorio

Si usa la configuración de variables de entorno tradicional, funcionará como antes sin especificar serviceId
Si ambas configuraciones existen, MICROCMS_SERVICES tiene prioridad

Método de uso

Consultar el contenido de microCMS

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

Crear y enviar contenido a microCMS

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

Obtener contenido de microCMS y solicitar una revisión

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

Subir imágenes a la lista de medios de microCMS

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

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

Ejemplo de uso en modo de múltiples servicios

En el modo de múltiples servicios, puede operar cada servicio especificando el ID del servicio.

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

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

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

Consulta de la lista de servicios

Al leer el recurso microcms://services, puede consultar los servicios configurados y la lista de API (endpoints) de cada servicio. El agente de IA puede usar esta información para determinar a qué servicio pertenece un endpoint especificado.

{
  "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" }
      ]
    }
  ]
}

Método 4: Usar como servidor MCP remoto (HTTP)

Puede iniciar como servidor MCP remoto usando transporte HTTP. Es útil para uso compartido con miembros del equipo o herramientas externas.

En modo HTTP, MCP_AUTH_TOKEN es obligatorio. Si no está configurado, está vacío o contiene solo espacios, el inicio fallará. No es necesario en modo stdio. Si usaba conexiones HTTP sin autenticación en versiones anteriores, configure el token del servidor y el encabezado Authorization: Bearer <token> del cliente antes de actualizar.

Inicio del lado del servidor

# 単一サービス
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

Configuración del lado del cliente (a través de mcp-remote)

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

Inicio con Docker

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

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

📖 Para más detalles sobre la configuración con Docker, la configuración de conexión por cliente y la resolución de problemas, consulte DOCKER.md.

Opciones de CLI

Opción	Variable de entorno	Predeterminado	Descripción
`--transport`	`MCP_TRANSPORT`	`stdio`	Modo de transporte (`stdio` o `http`)
`--port`	`MCP_HTTP_PORT`	`3000`	Número de puerto del servidor HTTP
`--host`	`MCP_HTTP_HOST`	`0.0.0.0`	Host del servidor HTTP
-	`MCP_AUTH_TOKEN`	-	Token de autenticación Bearer (obligatorio en HTTP, no necesario en stdio)

Uso más detallado

Los siguientes artículos presentan un uso más detallado.

Licencia

MIT