Automação do Confluence via Rube MCP

Automatize operações do Confluence, incluindo criação e atualização de páginas, busca de conteúdo com CQL, gerenciamento de espaços, marcação com rótulos e navegação na hierarquia de páginas através do kit de ferramentas Confluence da Composio.

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa com o Confluence via RUBE_MANAGE_CONNECTIONS com o kit de ferramentas confluence
• 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 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 kit de ferramentas confluence
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar o OAuth do Confluence
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Criar e Atualizar Páginas

Quando usar: O usuário deseja criar nova documentação ou atualizar páginas existentes do Confluence

Sequência de ferramentas:

1. CONFLUENCE_GET_SPACES - Listar espaços para encontrar o ID do espaço de destino [Pré-requisito]
2. CONFLUENCE_SEARCH_CONTENT - Encontrar página existente para evitar duplicatas ou localizar o pai [Opcional]
3. CONFLUENCE_GET_PAGE_BY_ID - Obter conteúdo e número da versão da página atual antes de atualizar [Pré-requisito para atualizações]
4. CONFLUENCE_CREATE_PAGE - Criar uma nova página em um espaço [Obrigatório para criação]
5. CONFLUENCE_UPDATE_PAGE - Atualizar uma página existente com novo conteúdo e versão incrementada [Obrigatório para atualizações]
6. CONFLUENCE_ADD_CONTENT_LABEL - Marcar a página com rótulos após a criação [Opcional]

Parâmetros chave:

• spaceId: ID ou chave do espaço (por exemplo, "DOCS", "12345678") — as chaves de espaço são convertidas automaticamente em IDs
• title: Título da página (deve ser único dentro de um espaço)
• parentId: ID da página pai para criar páginas filhas; omita para colocar sob a página inicial do espaço
• body.storage.value: Conteúdo em formato de armazenamento do Confluence (HTML/XHTML)
• body.storage.representation: Deve ser "storage" para operações de criação
• version.number: Para atualizações, deve ser a versão atual + 1
• version.message: Descrição opcional da alteração

Armadilhas:

• O Confluence impõe títulos de página únicos por espaço; criar uma página com um título duplicado falhará
• UPDATE_PAGE requer version.number definido como a versão atual + 1; sempre obtenha a versão atual primeiro com GET_PAGE_BY_ID
• O conteúdo deve estar no formato de armazenamento do Confluence (XHTML), não texto puro ou Markdown
• CREATE_PAGE usa body.storage.value enquanto UPDATE_PAGE usa body.value com body.representation
• GET_PAGE_BY_ID requer um ID numérico longo, não um UUID ou string

2. Buscar Conteúdo

Quando usar: O usuário deseja encontrar páginas, posts de blog ou conteúdo em todo o Confluence

Sequência de ferramentas:

1. CONFLUENCE_SEARCH_CONTENT - Busca por palavra-chave com classificação de relevância inteligente [Obrigatório]
2. CONFLUENCE_CQL_SEARCH - Busca avançada usando a Linguagem de Consulta do Confluence [Alternativa]
3. CONFLUENCE_GET_PAGE_BY_ID - Obter conteúdo completo para resultados de busca selecionados [Opcional]
4. CONFLUENCE_GET_PAGES - Navegar por páginas ordenadas por data quando a relevância da busca for fraca [Fallback]

Parâmetros chave para SEARCH_CONTENT:

• query: Texto de busca correspondido contra títulos de página com classificação inteligente
• spaceKey: Limitar a busca a um espaço específico
• limit: Máximo de resultados (padrão 25, máximo 250)
• start: Deslocamento de paginação (baseado em 0)

Parâmetros chave para CQL_SEARCH:

• cql: String de consulta CQL (por exemplo, text ~ "API docs" AND space = DOCS AND type = page)
• expand: Propriedades separadas por vírgula (por exemplo, content.space, content.body.storage)
• excerpt: highlight, indexed ou none
• limit: Máximo de resultados (máximo 250; reduzido para 25-50 ao usar expansões de corpo)

Operadores e campos CQL:

• Campos: text, title, label, space, type, creator, lastModified, created, ancestor
• Operadores: =, !=, ~ (contém), !~, >, <, >=, <=, IN, NOT IN
• Funções: currentUser(), now("-7d"), now("-30d")
• Exemplo: title ~ "meeting" AND lastModified > now("-7d") ORDER BY lastModified DESC

Armadilhas:

• CONFLUENCE_SEARCH_CONTENT busca até 300 páginas e aplica filtragem no lado do cliente — não é uma busca de texto completo real
• CONFLUENCE_CQL_SEARCH é a busca de texto completo real; use text ~ "term" para busca no corpo do conteúdo
• Limites de taxa HTTP 429 podem ocorrer; limite para ~2 requisições/segundo com backoff

…