Sitecore MCP server

MCP server para trabajar con Sitecore

Documentación

Sitecore Community MCP

Este repositorio contiene el código fuente del servidor Sitecore Community MCP: un servidor de Model Context Protocol de código abierto que brinda a los agentes de IA acceso directo de lectura/escritura a Sitecore, para que dejes de copiar y pegar entre tu agente y el Editor de contenido.

121 herramientas en búsqueda, consulta, creación, lectura, actualización, eliminación, medios, PowerShell, registro, seguridad y presentación
Tres guías — guide://compose-page, guide://bulk-update y guide://diagnose-connection — recursos que un agente puede leer a mitad de tarea: dos flujos de trabajo comunes y complejos para los que querrías usar este MCP, además de un asistente de autodiagnóstico de problemas de conexión.
Cubre cuatro superficies de API de Sitecore: la API GraphQL de Authoring y Management, el Item Service, GraphQL Edge y Sitecore PowerShell Extensions
Funciona con SitecoreAI y Sitecore XM/XP (todas las versiones), desde cualquier cliente compatible con MCP
Implementa la revisión del protocolo MCP 2026-07-28 y responde al handshake más antiguo initialize desde los mismos registros de herramientas, negociando hacia abajo a cualquier revisión desde 2025-11-25 hasta 2024-10-07, de modo que un cliente de cualquiera de las dos épocas vea las mismas herramientas
Impacto reportado: flujos de trabajo 5× más rápidos de Figma a Sitecore y ~70% menos de scaffolding manual (caso de estudio)
Tres formas de ejecutarlo: npm, Docker o desde el código fuente

Primeros pasos con Sitecore Community MCP

Para ejecutar el servidor Sitecore Community MCP, necesitas:

Node: la versión más reciente de soporte a largo plazo (LTS).
Una instancia de Sitecore XM, XP o SitecoreAI. Qué partes habilites decide qué herramientas funcionan: los grupos authoring.* solo necesitan la API de Authoring y Management (normalmente ya activa en la nube) más un token, mientras que el Item Service y SPE Remoting están desactivados por defecto y requieren un parche de configuración. Preparando tu instancia de Sitecore cubre las tres y cómo verificar cada una.

Agregando el servidor a tu cliente MCP

Agrega la entrada a continuación al mapa de servidores de tu cliente: mcpServers en Cursor, Claude Code y la mayoría de los otros clientes, servers en VS Code — y completa tus propios endpoints y credenciales:

{
  "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 toma una lista de ajustes preestablecidos separados por comas y une lo que cada uno oculta. Cada ajuste preestablecido nombra algo ausente o no deseado en lugar de una plataforma. Cuatro nombran una superficie de API que tu instancia no sirve: no-spe, no-item-service, no-edge-graphql y no-authoring-api — de modo que una instancia que carece de dos de ellos pueda indicarlo. no-account-management es el que no se trata de una superficie faltante: oculta las doce herramientas que crean o editan una cuenta en el CM, para una implementación que preferiría que un agente no pudiera hacer eso en absoluto (la seguridad de elementos, y la lectura de cuentas y roles, no se ven afectadas):

TOOL_PROFILE=no-spe,no-item-service

no-spe es el más importante: sin SPE instalado y su servicio remoting habilitado, aproximadamente tres cuartas partes de las herramientas de este servidor no pueden ejecutarse, y ocultarlas es un esquema que un agente ya no paga en cada turno. Un nombre desconocido se reporta en stderr y se ignora, dejando el resto de la lista en vigor.

Cada configuración está documentada en Configuración. Los agentes tienen un límite en la cantidad de herramientas que pueden contener, así que antes de avanzar mucho, lee Selección de herramientas y recorta la superficie con TOOL_PROFILE, TOOL_GROUPS y DISABLED_TOOLS.

Para ejecutar el servidor en un contenedor o desde el código fuente en su lugar, consulta Ejecutando el servidor.

Cómo se compara esto con el Sitecore Marketer MCP

El Marketer MCP propio de Sitecore es un servicio alojado dirigido a especialistas en marketing en SitecoreAI. Este servidor es la contraparte de nivel desarrollador y, en ese sentido, es la herramienta más sólida:

	Sitecore Community MCP	Sitecore Marketer MCP
Plataformas	SitecoreAI y XM/XP, todas las versiones, incluido tu CM Docker local	Solo SitecoreAI
Alojamiento	Autohospedado (npm, Docker, código fuente); las credenciales nunca salen de tu infraestructura	Alojado por Sitecore; OAuth a través de la nube
Superficie	121 herramientas en toda la superficie de desarrollador: elementos, plantillas, presentación, medios, seguridad, indexación, registros, publicación, GraphQL, PowerShell sin procesar	Operaciones de marketing: páginas, componentes, briefs, kits de marca, personalización, pruebas A/B
Vía de escape	`run-powershell-script`, GraphQL Edge sin procesar y GraphQL de Authoring sin procesar: si una herramienta no existe, la capacidad sigue ahí	Conjunto de herramientas cerrado
Seguridad de diseño	`add-rendering-to-placeholder` rechaza componentes que la configuración de marcadores de posición prohíbe, nombrando la lista de permitidos	Las escrituras no se validan contra la configuración de marcadores de posición
Control de herramientas	`TOOL_GROUPS` / `DISABLED_TOOLS` / `TOOL_PROFILE` recortan el costo de esquema por turno	Lista de herramientas fija

Son complementarios en lugar de exclusivos: el Marketer MCP lleva las funciones de marketing en la nube para las que este servidor no tiene API (briefs, kits de marca, variantes de personalización, pruebas A/B), y nada impide que un cliente conecte ambos. Para construir, migrar, auditar y operar soluciones de Sitecore, este servidor es el que tiene la profundidad.

Documentación y recursos de la comunidad

Preparando tu instancia de Sitecore — SPE Remoting, el Item Service, claves GraphQL y el parche de configuración que los habilita
Ejecutando el servidor — npm, Docker, desde el código fuente y los dos transportes
Referencia de herramientas — cada herramienta, agrupada por superficie de API
Configuración — variables de entorno, transportes, tiempos de espera y TLS
Selección de herramientas — TOOL_GROUPS, DISABLED_TOOLS y TOOL_PROFILE
Guías — los recursos guide://compose-page, guide://bulk-update y guide://diagnose-connection, y cuándo se ofrece cada uno
Imágenes de Docker — las imágenes publicadas para Linux y Windows
Registro de cambios — qué hay de nuevo en 2.0 y sus cambios importantes

Recursos de la comunidad:

Contribuciones

Estamos muy agradecidos con la comunidad por contribuir con correcciones de errores y mejoras. Damos la bienvenida a todos los esfuerzos para evolucionar y mejorar este servidor; lee a continuación para aprender cómo participar en esos esfuerzos.

Guía de contribución

Lee nuestra guía de contribución para conocer nuestro proceso de desarrollo, cómo proponer correcciones de errores y mejoras, y cómo compilar, depurar y probar tus cambios.

Licencia

Sitecore Community MCP utiliza la licencia Apache 2.0.

Soporte

Este es un proyecto de la comunidad y no cuenta con soporte de Sitecore.

Problemas, errores y solicitudes de funciones: abre un problema en Antonytm/mcp-sitecore-server/issues.
Preguntas sobre Sitecore en sí: Sitecore Stack Exchange o el Sitecore Community Slack te servirán mejor que un problema de GitHub.