Automação do Miro via Rube MCP

Automatize operações do quadro branco Miro através do kit de ferramentas Miro da Composio via Rube MCP.

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão Miro ativa via RUBE_MANAGE_CONNECTIONS com o kit de ferramentas miro
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obter Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu 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 kit de ferramentas miro
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar o OAuth do Miro
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 Quadros

Quando usar: O usuário deseja encontrar quadros ou obter detalhes do quadro

Sequência de ferramentas:

1. MIRO_GET_BOARDS2 - Listar todos os quadros acessíveis [Obrigatório]
2. MIRO_GET_BOARD - Obter informações detalhadas para um quadro específico [Opcional]

Parâmetros principais:

• query: Termo de pesquisa para filtrar quadros por nome
• sort: Ordenar por 'default', 'last_modified', 'last_opened', 'last_created', 'alphabetically'
• limit: Número de resultados por página (máximo 50)
• offset: Deslocamento da paginação
• board_id: ID específico do quadro para recuperação detalhada

Armadilhas:

• A paginação usa uma abordagem baseada em deslocamento, não em cursor
• Máximo de 50 quadros por página; itere com deslocamento para obter a lista completa
• IDs de quadro são strings alfanuméricas longas; sempre resolva por pesquisa primeiro

2. Criar Quadros e Itens

Quando usar: O usuário deseja criar um novo quadro ou adicionar itens a um quadro existente

Sequência de ferramentas:

1. MIRO_CREATE_BOARD - Criar um novo quadro vazio [Opcional]
2. MIRO_CREATE_STICKY_NOTE_ITEM - Adicionar notas adesivas a um quadro [Opcional]
3. MIRO_CREATE_FRAME_ITEM2 - Adicionar quadros para organizar o conteúdo [Opcional]
4. MIRO_CREATE_ITEMS_IN_BULK - Adicionar vários itens de uma vez [Opcional]

Parâmetros principais:

• name / description: Nome e descrição do quadro (para CREATE_BOARD)
• board_id: ID do quadro de destino (obrigatório para toda criação de item)
• data: Objeto de conteúdo com campo content para texto de nota adesiva
• style: Objeto de estilo com fillColor para cor da nota adesiva
• position: Objeto com coordenadas x e y
• geometry: Objeto com width e height

Armadilhas:

• board_id é obrigatório para TODAS as operações de item; resolva via GET_BOARDS2 primeiro
• As cores das notas adesivas usam códigos hexadecimais (por exemplo, '#FF0000') no campo fillColor
• As coordenadas de posição usam o sistema de coordenadas do quadro (origem no centro)
• A criação em MASSA tem um limite máximo de itens por solicitação; verifique o esquema atual
• Itens de quadro exigem geometry com largura e altura

3. Navegar e Gerenciar Itens do Quadro

Quando usar: O usuário deseja visualizar, encontrar ou organizar itens em um quadro

Sequência de ferramentas:

1. MIRO_GET_BOARD_ITEMS - Listar todos os itens em um quadro [Obrigatório]
2. MIRO_GET_CONNECTORS2 - Listar conexões entre itens [Opcional]

Parâmetros principais:

• board_id: ID do quadro de destino (obrigatório)
• type: Filtrar por tipo de item ('sticky_note', 'shape', 'text', 'frame', 'image', 'card')
• limit: Número de itens por página
• cursor: Cursor de paginação da resposta anterior

Armadilhas:

• Os resultados são paginados; siga cursor até que esteja ausente para obter a lista completa de itens
• Os tipos de item devem corresponder exatamente aos tipos predefinidos do Miro
• Quadros grandes podem ter milhares de itens; use a filtragem por tipo para refinar os resultados
• Conectores são separados dos itens; use GET_CONNECTORS2 para dados de relacionamento

4. Compartilhar e Colaborar em Quadros

Quando usar: O usuário deseja compartilhar um quadro com membros da equipe ou gerenciar o acesso

Sequência de ferramentas:

1. MIRO_GET_BOARDS2 - Encontrar o quadro para compartilhar [Pré-requisito]
2. MIRO_SHARE_BOARD - Compartilhar o quadro com usuários [Obrigatório]
3. MIRO_GET_BOARD_MEMBERS - Verificar membros atuais do quadro [Opcional]

Parâmetros principais:

• board_id: Quadro para compartilhar (obrigatório)
• emails: Matriz de endereços de e-mail para convidar
• role: Nível de acesso ('viewer', 'commenter', 'editor')
• message: Mensagem de convite opcional

Armadilhas:

• Endereços de e-mail devem ser válidos; e-mails inválidos fazem com que toda a solicitação falhe
• A função deve ser um dos valores predefinidos; diferenciação de maiúsculas e minúsculas
• Compartilhar com usuários fora da organização pode exigir aprovação do administrador
• GET_BOARD_MEMBERS retorna todos os membros, incluindo o proprietário

5. Criar Conexões Visuais

Quando usar: O usuário deseja conectar itens em um quadro com linhas ou setas

…