Automação do Contentful

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

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

Configuração

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

   https://rube.app/mcp
   

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

Fluxos de Trabalho Principais

1. Listar Todos os Espaços

Descubra todos os espaços Contentful acessíveis à sua conta autenticada. Esta é tipicamente a primeira operação, pois 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 serem retornados (padrão: 100)
• skip -- número de espaços a serem pulados para paginação
• order -- ordenar por campo, por exemplo, sys.createdAt ou -sys.createdAt para decrescente

Exemplo de prompt: "Listar todos os meus espaços Contentful"

2. Obter Detalhes do Espaço

Recupere metadados detalhados para um espaço específico, incluindo sua sys.version atual, que é necessária 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: "Obter detalhes para o 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, a fim de evitar 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: "Renomear o espaço Contentful abc123def para 'Production Content Hub'"

4. Auditar 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 e depois CONTENTFUL_GET_SPACE

Fluxo de trabalho:

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

Exemplo de prompt: "Auditar todos os espaços Contentful -- listá-los com suas datas de criação e versões atuais"

Armadilhas Conhecidas

• Conflitos de versão na atualização: CONTENTFUL_UPDATE_SPACE requer a 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 a perda de espaços.
• Limitações de escopo: Essas ferramentas gerenciam apenas metadados em 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: As atualizações via CONTENTFUL_UPDATE_SPACE falharão se seu token não tiver os escopos de gerenciamento de espaço, mesmo que as 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

Alimentado por Composio