Confluence MCP Server

Confluence MCP Server

Um servidor baseado em FastMCP que oferece integração contínua com a API REST do Confluence, permitindo acesso programático a espaços, páginas e funcionalidade de busca de conteúdo do Confluence.

Recursos Principais

• Gerenciamento de Espaços: Listar e filtrar espaços do Confluence
• Operações de Página: Recuperar e gerenciar conteúdo de páginas
• Funcionalidade de Busca: Executar buscas CQL (Confluence Query Language)
• Navegação de Espaços: Listar todas as páginas em espaços específicos
• Autenticação: Acesso seguro baseado em token de API

Requisitos do Sistema

• Python 3.8+
• pip (gerenciador de pacotes Python)
• Instância ativa do Confluence com acesso à API
• Token de API válido do Confluence

Instalação

Instalação via Smithery

Para instalar o confluence-mcp-server para o Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @MahithChigurupati/confluence-mcp-server --client claude

Instalação Manual

1. Clone o Repositório

   git clone https://github.com/MahithChigurupati/Confluence-MCP-Server.git
   cd Confluence-MCP-Server
   

2. Configure o Ambiente Virtual (Recomendado)

   python -m venv venv
   source venv/bin/activate  # On macOS/Linux
   # or
   .\venv\Scripts\activate  # On Windows
   

3. Instale as Dependências

   pip install -r requirements.txt
   

Configuração

1. Crie o Arquivo de Ambiente

   cp .env.example .env
   

2. Configure as Variáveis de Ambiente

   CONFLUENCE_BASE_URL=https://your-instance.atlassian.net/wiki/rest/api
   USERNAME=your.email@company.com
   API_TOKEN=your-api-token-here
   

3. Obtenha o Token de API do Confluence

   1. Visite Atlassian API Tokens
   2. Clique em "Create API Token"
   3. Insira um rótulo significativo (ex.: "MCP Server Access")
   4. Copie o token gerado imediatamente (ele não será exibido novamente)

Guia de Uso

Iniciando o Servidor

python confluence.py

Métodos de API Disponíveis

1. Listar Espaços

response = await list_spaces(
    query="engineering",  # Optional: Filter spaces by name
    limit=25,            # Optional: Maximum number of spaces to return
    start=0             # Optional: Starting index for pagination
)

2. Obter Conteúdo de Página

response = await get_page_content(
    page_id="123456",   # Required: Confluence page ID
    version=2           # Optional: Specific version number
)

3. Buscar Conteúdo

response = await search_content(
    query="project plan",    # Required: Search query
    space_key="TEAM",       # Optional: Limit search to specific space
    limit=50,               # Optional: Maximum results
    start=0                 # Optional: Starting index
)

4. Listar Páginas em um Espaço

response = await list_pages_in_space(
    space_key="TEAM",       # Required: Space key
    limit=100,             # Optional: Maximum pages to return
    start=0               # Optional: Starting index
)

Integração com Clientes MCP

Configuração do Claude Desktop

{
  "mcpServers": {
    "confluence": {
      "command": "python path",
      "args": ["/path/to/Confluence-MCP-Server/confluence.py"]
    }
  }
}

Localização: ~/.claude/claude_desktop_config.json (macOS/Linux) ou %USERPROFILE%\.claude\config.json (Windows)

Configuração do Cursor

{
  "mcpServers": {
    "confluence": {
      "command": "python path",
      "args": ["/path/to/Confluence-MCP-Server/confluence.py"]
    }
  }
}

use which python para encontrar o caminho do python

use pwd dentro do repositório clonado para obter o caminho. Não esqueça de adicionar confluence.py no final.

Localização: ~/.cursor/mcp.json (macOS/Linux) ou %USERPROFILE%\.cursor\config.json (Windows)

Tratamento de Erros

Códigos de erro comuns e seus significados:

• 401: Token de API ou credenciais inválidos
• 403: Permissões insuficientes
• 404: Recurso não encontrado
• 429: Limite de taxa excedido

Solução de Problemas

1. Problemas de Conexão

   • Verifique o formato do CONFLUENCE_BASE_URL
   • Verifique a conectividade de rede
   • Confirme a validade do token de API

2. Erros de Autenticação

   • Certifique-se de que USERNAME corresponde ao email da conta Atlassian
   • Verifique se o API_TOKEN foi copiado corretamente
   • Verifique se há caracteres especiais no arquivo .env

3. Erros de Permissão

   • Confirme que o usuário tem as permissões necessárias no Confluence
   • Verifique os direitos de acesso ao espaço e à página

Suporte

Para problemas e solicitações de recursos, crie uma issue no rastreador de issues do repositório.

Licença

Licença MIT. Consulte o arquivo LICENSE para obter os termos completos.