ComposioHQ/Contentful-Automation

Automação Contentful

Gerencie seus espaços de CMS headless Contentful diretamente do Claude Code. Liste espaços, recupere metadados e atualize configurações de espaços sem sair do terminal.

Documentação do toolkit: composio.dev/toolkits/contentful

---

Configuração

1. Adicione o servidor MCP do Composio à sua configuração:

   https://rube.app/mcp
   

2. Conecte sua conta do Contentful quando solicitado. O agente fornecerá um link de autenticação. Certifique-se de que seu token de acesso tenha escopos de gerenciamento de espaços.

---

Fluxos de Trabalho Principais

1. Listar Todos os Espaços

Descubra todos os espaços do Contentful acessíveis à sua conta autenticada. Esta é tipicamente a primeira operação, já que a maioria das outras ações requer um space_id.

Ferramenta: CONTENTFUL_LIST_SPACES

Parâmetros principais:

• limit (1-1000) — número máximo de espaços a retornar (padrão: 100)
• skip — número de espaços a pular para paginação
• order — ordenar por campo, ex.: sys.createdAt ou -sys.createdAt para decrescente

Exemplo de prompt: "Liste todos os meus espaços do Contentful"

---

2. Obter Detalhes do Espaço

Recupere metadados detalhados de um espaço específico, incluindo seu sys.version atual, que é necessário para atualizações.

Ferramenta: CONTENTFUL_GET_SPACE

Parâmetros principais:

• space_id (obrigatório) — o ID do espaço a ser recuperado (alfanumérico, 1-64 caracteres)

Exemplo de prompt: "Obtenha detalhes do espaço Contentful abc123def"

---

3. Atualizar Nome do Espaço

Atualize o nome de um espaço específico. Requer o número da versão atual para bloqueio otimista, evitando conflitos de modificação concorrente.

Ferramenta: CONTENTFUL_UPDATE_SPACE

Parâmetros principais:

• space_id (obrigatório) — ID do espaço a ser atualizado
• name (obrigatório) — novo nome para o espaço (1-255 caracteres)
• version (obrigatório) — versão atual do espaço de sys.version (deve ser > 0)

Exemplo de prompt: "Renomeie o espaço Contentful abc123def para 'Production Content Hub'"

---

4. Auditoria de Inventário de Espaços

Combine a listagem de espaços e a recuperação de detalhes para auditar os espaços Contentful da sua organização.

Ferramentas: CONTENTFUL_LIST_SPACES depois CONTENTFUL_GET_SPACE

Fluxo de trabalho:

1. Liste todos os espaços para obter IDs e nomes
2. Busque detalhes de cada espaço para obter informações de versão, datas de criação e metadados

Exemplo de prompt: "Audite todos os espaços do Contentful — liste-os com suas datas de criação e versões atuais"

---

Armadilhas Conhecidas

• Conflitos de versão na atualização: CONTENTFUL_UPDATE_SPACE requer o sys.version mais recente de CONTENTFUL_GET_SPACE. Se outra pessoa modificou o espaço entre sua leitura e escrita, a atualização falhará com um conflito de versão. Sempre busque o espaço imediatamente antes de atualizar.
• Paginação para muitos espaços: CONTENTFUL_LIST_SPACES usa os parâmetros limit e skip. Quando você tem muitos espaços, itere incrementando skip até que nenhum resultado adicional seja retornado para evitar perder espaços.
• Limitações de escopo: Essas ferramentas gerenciam apenas metadados de nível de espaço (nomes). Elas não podem criar ou modificar entradas, tipos de conteúdo ou ativos dentro de um espaço.
• Incompatibilidade de autenticação/permissões: Atualizações via CONTENTFUL_UPDATE_SPACE falharão se seu token não tiver escopos de gerenciamento de espaços, mesmo que leituras via CONTENTFUL_GET_SPACE sejam bem-sucedidas. Verifique se seu token tem permissões de escrita.
• Formato do ID do espaço: O space_id deve corresponder ao padrão ^[a-zA-Z0-9-_.]{1,64}$. Caracteres inválidos serão rejeitados.

---

Referência Rápida

Slug da Ferramenta	Descrição
CONTENTFUL_LIST_SPACES	Lista todos os espaços acessíveis à sua conta
CONTENTFUL_GET_SPACE	Recupera metadados detalhados de um único espaço
CONTENTFUL_UPDATE_SPACE	Atualiza o nome de um espaço (requer versão)

---

Desenvolvido por Composio