Contentstack

Interactúa con la API de gestión de contenido de Contentstack para administrar tu contenido del CMS.

Documentación

Servidor MCP de Contentstack

Este servidor del Protocolo de Contexto de Modelo (MCP) se integra con la API de Gestión de Contenido de Contentstack, permitiendo que asistentes de IA como Claude interactúen con tu CMS de Contentstack a través de un protocolo estandarizado.

Nota: Esta es una versión temprana del Servidor MCP de Contentstack. Consulta la Hoja de Ruta para conocer las próximas mejoras y funciones planificadas.

Características

Recursos Disponibles

content-types: Listar todos los tipos de contenido (URI: contentstack://content-types)
content-type: Obtener tipo de contenido por UID (URI: contentstack://content-type/{uid})
entries: Obtener entradas por tipo de contenido (URI: contentstack://entries/{content_type_uid})
entry: Obtener entrada específica (URI: contentstack://entry/{content_type_uid}/{entry_uid})
assets: Listar todos los activos (URI: contentstack://assets)

Gestión de Tipos de Contenido

Crear, actualizar y eliminar tipos de contenido
Definir esquemas, opciones, reglas de campos y taxonomías
Gestionar campos globales

Gestión de Entradas

Crear, actualizar y eliminar entradas
Publicar y despublicar entradas en diferentes entornos
Consultar entradas con opciones de filtrado, paginación y ordenación

Gestión de Campos Globales

Crear y actualizar campos globales para reutilizarlos en varios tipos de contenido
Recuperar campos globales con opciones de paginación

Flujos de Trabajo de Contenido

Flujos de trabajo guiados para la creación de contenido
Análisis y perspectivas de contenido
Asistencia en la planificación de migraciones

Instalación

Requisitos Previos

Node.js (v16.0.0 o superior)
Una cuenta de Contentstack
Credenciales de API (API Key y Management Token)

Instalación mediante NPM

La forma más fácil de usar este servidor MCP es mediante NPM:

# Install globally
npm install -g @drossman/contentstack-mcp

# Or use directly via npx
npx @drossman/contentstack-mcp

Instalación Manual

Clona el repositorio:

git clone https://github.com/darekrossman/contentstack-mcp.git
cd contentstack-mcp

Instala las dependencias:
```
npm install
```

Configura las variables de entorno:

cp .env.example .env

Edita el archivo .env con tus credenciales de Contentstack:

CONTENTSTACK_API_KEY=your_api_key_here
CONTENTSTACK_MANAGEMENT_TOKEN=your_management_token_here
# Optional: Specify branch if using branches
CONTENTSTACK_BRANCH=your_branch_name

Compila y inicia el servidor:
```
npm run build
npm start
```

Instalación mediante Smithery CLI

También puedes instalar este servidor MCP usando la CLI de Smithery:

npx @smithery/cli install contentstack-mcp --client claude

Consulta la documentación de Smithery CLI para más detalles y uso avanzado.

Desarrollo

Configuración para Desarrollo

Para desarrollo, puedes usar:

npm run dev

Esto inicia el servidor usando ts-node para un ciclo de desarrollo más rápido.

Calidad del Código

Este proyecto utiliza Biome.js para linting y formateo. Proporciona un estilo de código consistente y ayuda a detectar problemas potenciales de manera temprana.

Comandos Disponibles

Lint de Código:
```
npm run lint
```
Lint y Corregir:
```
npm run lint:fix
```
Formatear Código:
```
npm run format
```
Formatear y Corregir:
```
npm run format:fix
```

Configuración

Autenticación

Este servidor requiere autenticación con la API de Contentstack:

Management Token (Requerido):

Token a nivel de stack con permisos predefinidos
Configurado mediante la variable de entorno CONTENTSTACK_MANAGEMENT_TOKEN
Generar desde el panel de Contentstack: Ajustes > Tokens > Management Tokens

API Key (Requerida):

Clave de API del stack para autenticación
Configurada mediante la variable de entorno CONTENTSTACK_API_KEY

Soporte de Ramas

Si tu cuenta de Contentstack utiliza ramas, puedes especificar una rama:

CONTENTSTACK_BRANCH=develop

Integración con Asistentes de IA

Claude para Escritorio

Para usar este servidor con Claude para Escritorio:

Edita tu archivo de configuración de Claude para Escritorio:
- Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

Añade este servidor a la sección mcpServers:

{
  "mcpServers": {
    "contentstack": {
      "command": "npx",
      "args": ["-y", "@drossman/contentstack-mcp"],
      "env": {
        "CONTENTSTACK_API_KEY": "your_api_key_here",
        "CONTENTSTACK_MANAGEMENT_TOKEN": "your_management_token_here"
      }
    }
  }
}

Reinicia Claude para Escritorio

Cursor

Para usar este servidor con Cursor, añade la configuración del servidor MCP de Contentstack:

{
   "mcpServers": {
      "contentstack": {
      "command": "npx",
      "args": ["-y", "@drossman/contentstack-mcp"],
      "env": {
         "CONTENTSTACK_API_KEY": "your_api_key_here",
         "CONTENTSTACK_MANAGEMENT_TOKEN": "your_management_token_here",
      }
      }
   }
}

Instalar con Smithery

También puedes instalar este servidor MCP usando la CLI de Smithery con el cliente de tu preferencia:

npx -y @smithery/cli install @drossman/contentstack-mcp --client claude

Los clientes disponibles incluyen:

claude
cline
windsurf
roocode
witsy
enconvo
cursor
vscode
vscode-insiders
boltai
amazon-bedrock
amazonq

Consulta la documentación de Smithery CLI para más detalles y uso avanzado.

Hoja de Ruta

Agradecimiento

Un agradecimiento especial a Ivo Toby. Este proyecto y su autor están fuertemente inspirados por su trabajo en este ámbito.

Licencia

MIT

Aviso legal: Este proyecto no está afiliado, respaldado ni soportado por Contentstack. Es un proyecto independiente de código abierto diseñado para trabajar con la API de Contentstack.