microCMS MCP Server

Interaja com a API do CMS headless microCMS, permitindo que assistentes de IA gerenciem conteúdo.

GitHub
22
Experimente este MCPPatrocinado

Documentação

Servidor MCP do microCMS

Servidor MCP (Model Context Protocol) do microCMS.
Permite que assistentes de IA, como o Claude, interajam com o sistema de gerenciamento de conteúdo do microCMS.

Pré-requisitos

  • ID do serviço e chave de API do microCMS

Configuração

Método 1: Usando o MCP Bundle (antigo arquivo DXT)

Para instalar no Claude Desktop, você pode usar o arquivo mcpb para uma instalação simples.

  1. Baixe o microcms-mcp-server.mcpb mais recente na página de releases
  2. Abra o arquivo mcpb baixado com um duplo clique
  3. Configure o ID do serviço e a chave de API

Método 2: Usando npx (serviço único)

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

Substitua <MICROCMS_SERVICE_ID> e <MICROCMS_API_KEY> pelos seus próprios valores.

Após atualizar a configuração, reinicie o cliente.

Método 3: Usando vários serviços

Para conectar a vários serviços do microCMS, configure as informações dos serviços em formato JSON na variável de ambiente 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\"}]"
      }
    }
  }
}

Comportamento do modo multi-serviço

No modo multi-serviço, o parâmetro serviceId é obrigatório em cada ferramenta.

  • Os nomes das ferramentas seguem o mesmo formato microcms_* do modo de serviço único
  • Especifique o serviceId em cada chamada de ferramenta para selecionar o serviço
  • A lista de serviços configurados pode ser verificada com a ferramenta microcms_get_services
  • Informações semelhantes também podem ser obtidas pelo recurso MCP microcms://services

Compatibilidade reversa

Método de configuraçãoModoParâmetro serviceId
MICROCMS_SERVICE_ID + MICROCMS_API_KEYServiço únicoOpcional (usa o serviço padrão automaticamente)
MICROCMS_SERVICES (JSON)Multi-serviçoObrigatório
  • Se você usar as configurações de variáveis de ambiente tradicionais, o comportamento permanece o mesmo, sem precisar especificar o serviceId
  • Se ambas as configurações existirem, MICROCMS_SERVICES terá prioridade

Como usar

Verificar o conteúdo do microCMS

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

Criar e enviar conteúdo para o microCMS

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

Obter conteúdo do microCMS para revisão

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

Enviar imagens para a lista de mídia do microCMS

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

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

Exemplo de uso no modo multi-serviço

No modo multi-serviço, você pode operar cada serviço especificando o ID do serviço.

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

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

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

Verificando a lista de serviços

Ao ler o recurso microcms://services, você pode verificar os serviços configurados e a lista de APIs (endpoints) de cada serviço. O agente de IA pode usar essas informações para determinar a qual serviço um endpoint especificado pertence.

{
  "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: Usando como servidor MCP remoto (HTTP)

Você pode iniciar como um servidor MCP remoto usando transporte HTTP. É útil para compartilhar com membros da equipe ou ferramentas externas.

Iniciando no lado do 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

Configuração no lado do cliente (via mcp-remote)

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

Iniciando com Docker

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

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

📖 Para detalhes sobre configuração com Docker, configuração de conexão por cliente e solução de problemas, consulte DOCKER.md.

Opções de CLI

OpçãoVariável de ambientePadrãoDescrição
--transportMCP_TRANSPORTstdioModo de transporte (stdio ou http)
--portMCP_HTTP_PORT3000Número da porta do servidor HTTP
--hostMCP_HTTP_HOST0.0.0.0Host do servidor HTTP
-MCP_AUTH_TOKEN-Token de autenticação Bearer (autenticação ativada somente quando configurado)

Uso mais detalhado

Os artigos abaixo apresentam usos mais detalhados.

Licença

MIT