Contentstack

Interaja com a API de Gerenciamento de Conteúdo do Contentstack para gerenciar seu conteúdo de CMS.

Documentação

Contentstack MCP Server

Este servidor Model Context Protocol (MCP) integra-se à API de Gerenciamento de Conteúdo do Contentstack, permitindo que assistentes de IA como o Claude interajam com seu CMS Contentstack por meio de um protocolo padronizado.

Nota: Esta é uma versão inicial do Contentstack MCP Server. Consulte o Roadmap para melhorias futuras e recursos planejados.

Recursos

Recursos Disponíveis

content-types: Listar todos os tipos de conteúdo (URI: contentstack://content-types)
content-type: Obter tipo de conteúdo por UID (URI: contentstack://content-type/{uid})
entries: Obter entradas por tipo de conteúdo (URI: contentstack://entries/{content_type_uid})
entry: Obter entrada específica (URI: contentstack://entry/{content_type_uid}/{entry_uid})
assets: Listar todos os ativos (URI: contentstack://assets)

Gerenciamento de Tipos de Conteúdo

Criar, atualizar e excluir tipos de conteúdo
Definir esquemas, opções, regras de campo e taxonomias
Gerenciar campos globais

Gerenciamento de Entradas

Criar, atualizar e excluir entradas
Publicar e despublicar entradas em todos os ambientes
Consultar entradas com opções de filtragem, paginação e ordenação

Gerenciamento de Campos Globais

Criar e atualizar campos globais para reutilização entre tipos de conteúdo
Recuperar campos globais com opções de paginação

Fluxos de Trabalho de Conteúdo

Fluxos de trabalho guiados para criação de conteúdo
Análise e insights de conteúdo
Assistência no planejamento de migração

Instalação

Pré-requisitos

Node.js (v16.0.0 ou superior)
Uma conta Contentstack
Credenciais de API (Chave de API e Token de Gerenciamento)

Instalação via NPM

A maneira mais fácil de usar este servidor MCP é via NPM:

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

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

Instalação Manual

Clone o repositório:

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

Instale as dependências:
```
npm install
```

Configure as variáveis de ambiente:

cp .env.example .env

Edite o arquivo .env com suas credenciais do 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

Compile e inicie o servidor:
```
npm run build
npm start
```

Instalação via Smithery CLI

Você também pode instalar este servidor MCP usando a Smithery CLI:

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

Consulte a documentação da Smithery CLI para mais detalhes e uso avançado.

Desenvolvimento

Configuração para Desenvolvimento

Para desenvolvimento, você pode usar:

npm run dev

Isso inicia o servidor usando ts-node para um ciclo de desenvolvimento mais rápido.

Qualidade do Código

Este projeto usa Biome.js para lint e formatação. Ele fornece um estilo de código consistente e ajuda a identificar problemas potenciais antecipadamente.

Comandos Disponíveis

Lint do Código:
```
npm run lint
```
Lint e Correção:
```
npm run lint:fix
```
Formatar Código:
```
npm run format
```
Formatar e Corrigir:
```
npm run format:fix
```

Configuração

Autenticação

Este servidor requer autenticação com a API do Contentstack:

Token de Gerenciamento (Obrigatório):

Token de nível de stack com permissões predefinidas
Definido via variável de ambiente CONTENTSTACK_MANAGEMENT_TOKEN
Gerado no painel do Contentstack: Configurações > Tokens > Tokens de Gerenciamento

Chave de API (Obrigatória):

Chave de API do stack para autenticação
Definida via variável de ambiente CONTENTSTACK_API_KEY

Suporte a Branch

Se sua conta Contentstack usa branches, você pode especificar um branch:

CONTENTSTACK_BRANCH=develop

Integração com Assistentes de IA

Claude for Desktop

Para usar este servidor com o Claude for Desktop:

Edite o arquivo de configuração do Claude for Desktop:
- Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

Adicione este servidor à seção 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"
      }
    }
  }
}

Reinicie o Claude for Desktop

Cursor

Para usar este servidor com o Cursor, adicione a configuração do servidor MCP 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 com Smithery

Você também pode instalar este servidor MCP usando a Smithery CLI com o cliente de sua escolha:

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

Clientes disponíveis incluem:

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

Consulte a documentação da Smithery CLI para mais detalhes e uso avançado.

Roadmap

Agradecimento

Agradecimento especial a Ivo Toby. Este projeto e seu autor são fortemente inspirados pelo trabalho dele nessa área.

Licença

MIT

Aviso: Este projeto não é afiliado, endossado ou apoiado pela Contentstack. É um projeto independente de código aberto projetado para funcionar com a API do Contentstack.