Automação do Canva via Rube MCP

Automatize operações de design do Canva através do toolkit do Canva da Composio via Rube MCP.

Pré-requisitos

• O Rube MCP deve estar conectado (ferramentas RUBE_SEARCH_TOOLS disponíveis)
• Conexão ativa com o Canva via RUBE_MANAGE_CONNECTIONS com o toolkit canva
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obtenha o Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na sua configuração de cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o toolkit canva
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar o OAuth do Canva
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Listar e Navegar por Designs

Quando usar: O usuário deseja encontrar designs existentes ou navegar em sua biblioteca do Canva

Sequência de ferramentas:

1. CANVA_LIST_USER_DESIGNS - Listar todos os designs com filtros opcionais [Obrigatório]

Parâmetros chave:

• query: Termo de busca para filtrar designs por nome
• continuation: Token de paginação da resposta anterior
• ownership: Filtrar por 'owned', 'shared' ou 'any'
• sort_by: Campo de ordenação (ex: 'modified_at', 'title')

Armadilhas:

• Os resultados são paginados; siga o token continuation até que ele desapareça
• Designs excluídos podem aparecer brevemente; verifique o status do design
• A busca é baseada em substring, não em correspondência aproximada

2. Criar e Projetar

Quando usar: O usuário deseja criar um novo design do Canva do zero ou a partir de um modelo

Sequência de ferramentas:

1. CANVA_ACCESS_USER_SPECIFIC_BRAND_TEMPLATES_LIST - Navegar por modelos de marca disponíveis [Opcional]
2. CANVA_CREATE_CANVA_DESIGN_WITH_OPTIONAL_ASSET - Criar um novo design [Obrigatório]

Parâmetros chave:

• design_type: Tipo de design (ex: 'Presentation', 'Poster', 'SocialMedia')
• title: Nome para o novo design
• asset_id: Recurso opcional para incluir no design
• width / height: Dimensões personalizadas em pixels

Armadilhas:

• O tipo de design deve corresponder exatamente aos tipos predefinidos do Canva
• Dimensões personalizadas têm limites mínimo e máximo
• O recurso deve ser carregado primeiro via CANVA_CREATE_ASSET_UPLOAD_JOB antes de ser referenciado

3. Carregar Recursos

Quando usar: O usuário deseja carregar imagens ou arquivos para o Canva para uso em designs

Sequência de ferramentas:

1. CANVA_CREATE_ASSET_UPLOAD_JOB - Iniciar o upload do recurso [Obrigatório]
2. CANVA_FETCH_ASSET_UPLOAD_JOB_STATUS - Consultar até que o upload seja concluído [Obrigatório]

Parâmetros chave:

• name: Nome de exibição para o recurso
• url: URL pública do arquivo a ser carregado (para uploads baseados em URL)
• job_id: ID do trabalho de upload retornado da etapa 1 (para consulta de status)

Armadilhas:

• O upload é assíncrono; você DEVE consultar o status do trabalho até que ele seja concluído
• Formatos suportados incluem PNG, JPG, SVG, MP4, GIF
• Limites de tamanho de arquivo se aplicam; arquivos grandes podem levar mais tempo para processar
• O job_id de CREATE retorna o ID necessário para consulta de status
• Valores de status: 'in_progress', 'success', 'failed'

4. Exportar Designs

Quando usar: O usuário deseja baixar ou exportar um design do Canva como PDF, PNG ou outro formato

Sequência de ferramentas:

1. CANVA_LIST_USER_DESIGNS - Encontrar o design para exportar [Pré-requisito]
2. CANVA_CREATE_CANVA_DESIGN_EXPORT_JOB - Iniciar o processo de exportação [Obrigatório]
3. CANVA_GET_DESIGN_EXPORT_JOB_RESULT - Consultar até que a exportação seja concluída e obter o URL de download [Obrigatório]

Parâmetros chave:

• design_id: ID do design a ser exportado
• format: Formato de exportação ('pdf', 'png', 'jpg', 'svg', 'mp4', 'gif', 'pptx')
• pages: Números de página específicos para exportar (array)
• quality: Qualidade de exportação ('regular', 'high')
• job_id: ID do trabalho de exportação para consulta de status

Armadilhas:

• A exportação é assíncrona; você DEVE consultar o resultado do trabalho até que ele seja concluído
• URLs de download de exportações concluídas expiram após um tempo limitado
• Designs grandes com muitas páginas levam mais tempo para exportar
• Nem todos os formatos suportam todos os tipos de design (ex: MP4 apenas para animações)
• Intervalo de consulta: espere 2-3 segundos entre as verificações de status

5. Organizar com Pastas

Quando usar: O usuário deseja criar pastas ou organizar designs em pastas

Sequência de ferramentas:

1. CANVA_POST_FOLDERS - Criar uma nova pasta [Obrigatório]
2. CANVA_MOVE_ITEM_TO_SPECIFIED_FOLDER - Mover designs para pastas [Opcional]

Parâmetros chave:

• name: Nome da pasta
• parent_folder_id: Pasta pai para organização aninhada
• item_id: ID do design ou recurso a ser movido
• folder_id: ID da pasta de destino

Armadilhas:

…