Confluence

Servidor MCP do Confluence

Um servidor Model Context Protocol (MCP) que fornece acesso seguro ao Atlassian Confluence por meio de sua API REST.

Como usar com o Claude Code

Para usar este servidor MCP com o Claude Code, adicione-o ao seu arquivo de configuração MCP:

Opção 1: Usando o comando claude mcp add-json (recomendado)

A maneira mais fácil de adicionar este servidor é usando o comando claude mcp add-json:

# First, build the server
npm run build

# Then add it using claude mcp add-json
claude mcp add-json confluence

Quando solicitado, cole a seguinte configuração JSON:

{
  "command": "node",
  "args": ["/path/to/confluence_mcp/dist/index.js"],
  "env": {
    "CONFLUENCE_BASE_URL": "https://your-domain.atlassian.net",
    "CONFLUENCE_USERNAME": "your-email@domain.com",
    "CONFLUENCE_API_TOKEN": "your-api-token",
    "ALLOWED_SPACES": "SPACE1,SPACE2,SPACE3"
  }
}

Opção 2: Configuração manual

Alternativamente, você pode editar manualmente seu arquivo de configuração MCP (~/.config/claude-code/mcp_servers_config.json):

{
  "mcpServers": {
    "confluence": {
      "command": "node",
      "args": ["/path/to/confluence_mcp/dist/index.js"],
      "env": {
        "CONFLUENCE_BASE_URL": "https://your-domain.atlassian.net",
        "CONFLUENCE_USERNAME": "your-email@domain.com",
        "CONFLUENCE_API_TOKEN": "your-api-token",
        "ALLOWED_SPACES": "SPACE1,SPACE2,SPACE3"
      }
    }
  }
}

Opção 3: Usando tsx para desenvolvimento

Para desenvolvimento ou se você preferir executar TypeScript diretamente:

{
  "command": "npx",
  "args": ["tsx", "/path/to/confluence_mcp/src/index.ts"],
  "env": {
    "CONFLUENCE_BASE_URL": "https://your-domain.atlassian.net",
    "CONFLUENCE_USERNAME": "your-email@domain.com",
    "CONFLUENCE_API_TOKEN": "your-api-token",
    "ALLOWED_SPACES": "SPACE1,SPACE2,SPACE3"
  }
}

Notas de configuração

• Substitua as variáveis de ambiente pelas suas credenciais reais do Confluence
• O ALLOWED_SPACES deve ser uma lista separada por vírgulas das chaves de espaço às quais você deseja permitir acesso
• Reinicie o Claude Code após atualizar a configuração
• Certifique-se de ter compilado o projeto primeiro com npm run build se estiver usando a Opção 1

Uma vez configurado, você pode usar comandos como:

• "Pesquisar documentação da API no Confluence"
• "Criar uma nova página no espaço DEV"
• "Mostrar todas as páginas no espaço PROJ"

Início rápido

1. Instalar dependências:

   npm install
   

2. Configurar o ambiente:

   cp .env.example .env
   # Edit .env with your Confluence credentials
   

3. Compilar e executar:

   npm run build
   npm start
   

   Ou para desenvolvimento:

   npm run dev
   

Configuração

Crie um arquivo .env com suas credenciais do Confluence:

CONFLUENCE_BASE_URL=https://your-domain.atlassian.net
CONFLUENCE_USERNAME=your-email@domain.com
CONFLUENCE_API_TOKEN=your-api-token
ALLOWED_SPACES=SPACE1,SPACE2,SPACE3
DEBUG=false

Obtendo um token de API

1. Acesse Configurações da conta Atlassian
2. Clique em "Criar token de API"
3. Dê a ele um rótulo descritivo
4. Copie o token gerado (salve-o com segurança!)

Ferramentas disponíveis

• search_confluence - Pesquisar conteúdo nos espaços permitidos
• get_page - Recuperar uma página específica por ID
• create_page - Criar uma nova página
• update_page - Atualizar uma página existente
• delete_page - Excluir uma página
• list_spaces - Listar espaços acessíveis
• get_space_content - Obter páginas de um espaço específico

Recursos de segurança

• Autenticação por token de API - Acesso seguro usando tokens de API da Atlassian
• Restrições de espaço - Lista configurável de espaços permitidos
• Validação de permissões - Respeita as permissões do Confluence
• Validação de solicitações - Validação e sanitização de entrada

Desenvolvimento

# Type checking
npm run typecheck

# Linting
npm run lint

# Testing
npm test

# Build
npm run build