Sitecore MCP server

Servidor MCP para trabalhar com Sitecore

Documentação

Sitecore Community MCP

Este repositório contém o código-fonte do servidor Sitecore Community MCP — um servidor de Model Context Protocol de código aberto que dá a agentes de IA acesso direto de leitura/escrita ao Sitecore, para que você pare de copiar e colar entre seu agente e o Content Editor.

121 ferramentas em busca, consulta, criação, leitura, atualização, exclusão, mídia, PowerShell, logging, segurança e apresentação
Três guias — guide://compose-page, guide://bulk-update e guide://diagnose-connection — recursos que um agente pode ler no meio da tarefa: dois fluxos de trabalho comuns e complexos para os quais você usaria este MCP, além de um auxiliar de autodiagnóstico de problemas de conexão.
Cobre quatro superfícies de API do Sitecore: a API GraphQL de Authoring e Management, o Item Service, o GraphQL Edge e as Sitecore PowerShell Extensions
Funciona com SitecoreAI e Sitecore XM/XP (todas as versões), a partir de qualquer cliente compatível com MCP
Implementa a revisão do protocolo MCP 2026-07-28 e responde ao handshake mais antigo initialize a partir dos mesmos registros de ferramentas — negociando para baixo até qualquer revisão de 2025-11-25 a 2024-10-07, para que um cliente de qualquer era veja as mesmas ferramentas
Impacto relatado: fluxos de trabalho 5× mais rápidos de Figma para Sitecore e ~70% menos scaffolding manual (estudo de caso)
Três formas de executá-lo: npm, Docker ou a partir do código-fonte

Primeiros passos com o Sitecore Community MCP

Para executar o servidor Sitecore Community MCP, você precisa de:

Node — a versão mais recente de suporte de longo prazo (LTS).
Uma instância Sitecore XM, XP ou SitecoreAI. Quais partes você habilita decide quais ferramentas funcionam: os grupos authoring.* precisam apenas da API de Authoring e Management (normalmente já ativada na nuvem) além de um token, enquanto o Item Service e o SPE Remoting estão desativados por padrão e precisam de um patch de configuração. Preparando sua instância do Sitecore cobre todos os três e como verificar cada um.

Adicionando o servidor ao seu cliente MCP

Adicione a entrada abaixo ao mapa de servidores do seu cliente — mcpServers no Cursor, Claude Code e na maioria dos outros clientes, servers no VS Code — e preencha com seus próprios endpoints e credenciais:

{
  "mcpServers": {
    "sitecore-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["@antonytm/mcp-sitecore-server@latest"],
      "env": {
        "TRANSPORT": "stdio",
        "GRAPHQL_ENDPOINT": "https://xmcloudcm.localhost/sitecore/api/graph/",
        "GRAPHQL_SCHEMAS": "edge",
        "GRAPHQL_API_KEY": "{6D3F291E-66A5-4703-887A-D549AF83D859}",
        "GRAPHQL_HEADERS": "",
        "ITEM_SERVICE_DOMAIN": "sitecore",
        "ITEM_SERVICE_USERNAME": "admin",
        "ITEM_SERVICE_PASSWORD": "b",
        "ITEM_SERVICE_SERVER_URL": "https://xmcloudcm.localhost/",
        "POWERSHELL_DOMAIN": "sitecore",
        "POWERSHELL_USERNAME": "admin",
        "POWERSHELL_PASSWORD": "b",
        "POWERSHELL_SERVER_URL": "https://xmcloudcm.localhost/",
        "AUTHORING_CLIENT_ID": "",
        "AUTHORING_CLIENT_SECRET": "",
        "TOOL_PROFILE": ""
      }
    }
  }
}

TOOL_PROFILE aceita uma lista separada por vírgulas de predefinições e une o que cada uma oculta. Cada predefinição nomeia algo ausente ou indesejado, em vez de uma plataforma. Quatro nomeiam uma superfície de API que sua instância não atende — no-spe, no-item-service, no-edge-graphql e no-authoring-api — para que uma instância sem duas delas possa informar isso. no-account-management é a que não trata de uma superfície ausente: ela oculta as doze ferramentas que criam ou editam uma conta no CM, para uma implantação que prefere que um agente não possa fazer isso de forma alguma (segurança de itens e leitura de contas e funções permanecem intactas):

TOOL_PROFILE=no-spe,no-item-service

no-spe é a mais importante: sem o SPE instalado e seu serviço remoting habilitado, aproximadamente três quartos das ferramentas deste servidor não podem ser executadas, e ocultá-las é um esquema que um agente não paga mais a cada turno. Um nome desconhecido é relatado no stderr e ignorado, mantendo o restante da lista em vigor.

Toda configuração está documentada em Configuração. Agentes têm um limite de quantas ferramentas podem manter, então antes de avançar muito, leia Seleção de ferramentas e reduza a superfície com TOOL_PROFILE, TOOL_GROUPS e DISABLED_TOOLS.

Para executar o servidor em um contêiner ou a partir do código-fonte, veja Executando o servidor.

Como isso se compara ao Sitecore Marketer MCP

O Marketer MCP da própria Sitecore é um serviço hospedado voltado para profissionais de marketing no SitecoreAI. Este servidor é a contraparte de nível de desenvolvedor e, nesse aspecto, é a ferramenta mais robusta:

	Sitecore Community MCP	Sitecore Marketer MCP
Plataformas	SitecoreAI e XM/XP, todas as versões — incluindo seu CM Docker local	Somente SitecoreAI
Hospedagem	Autohospedado (npm, Docker, código-fonte); as credenciais nunca saem da sua infraestrutura	Hospedado pela Sitecore; OAuth pela nuvem
Superfície	121 ferramentas em toda a superfície de desenvolvedor: itens, modelos, apresentação, mídia, segurança, indexação, logs, publicação, GraphQL, PowerShell bruto	Operações de marketing: páginas, componentes, briefs, kits de marca, personalização, testes A/B
Válvula de escape	`run-powershell-script`, GraphQL Edge bruto e GraphQL de Authoring bruto — se uma ferramenta não existe, a capacidade ainda existe	Conjunto de ferramentas fechado
Segurança de layout	`add-rendering-to-placeholder` recusa componentes que as configurações de espaço reservado proíbem, nomeando a lista de permissões	Gravações não são validadas contra configurações de espaço reservado
Controle de ferramentas	`TOOL_GROUPS` / `DISABLED_TOOLS` / `TOOL_PROFILE` reduzem o custo de esquema por turno	Lista de ferramentas fixa

Elas são complementares, não exclusivas: o Marketer MCP carrega os recursos de marketing na nuvem para os quais este servidor não tem API (briefs, kits de marca, variantes de personalização, testes A/B), e nada impede um cliente de conectar ambos. Para construir, migrar, auditar e operar soluções Sitecore, este servidor é o que tem profundidade.

Documentação e recursos da comunidade

Preparando sua instância do Sitecore — SPE Remoting, Item Service, chaves GraphQL e o patch de configuração que os habilita
Executando o servidor — npm, Docker, a partir do código-fonte e os dois transportes
Referência de ferramentas — todas as ferramentas, agrupadas por superfície de API
Configuração — variáveis de ambiente, transportes, timeouts e TLS
Seleção de ferramentas — TOOL_GROUPS, DISABLED_TOOLS e TOOL_PROFILE
Guias — os recursos guide://compose-page, guide://bulk-update e guide://diagnose-connection, e quando cada um é oferecido
Imagens Docker — as imagens publicadas para Linux e Windows
Changelog — o que há de novo na versão 2.0 e suas mudanças que quebram compatibilidade

Recursos da comunidade:

Contribuições

Somos muito gratos à comunidade por contribuir com correções de bugs e melhorias. Acolhemos todos os esforços para evoluir e melhorar este servidor; leia abaixo para saber como participar desses esforços.

Guia de Contribuição

Leia nosso guia de contribuição para aprender sobre nosso processo de desenvolvimento, como propor correções de bugs e melhorias, e como compilar, depurar e testar suas alterações.

Licença

O Sitecore Community MCP usa a licença Apache 2.0.

Suporte

Este é um projeto da comunidade e não é suportado pela Sitecore.

Problemas, bugs e solicitações de recursos: abra um problema em Antonytm/mcp-sitecore-server/issues.
Perguntas sobre o próprio Sitecore: Sitecore Stack Exchange ou o Sitecore Community Slack atenderão você melhor do que um problema no GitHub.