MCP Atlassian Server

MCP Atlassian Server

Servidor MCP para integração de produtos Atlassian (Confluence, Jira) com o Model Context Protocol. Esta ferramenta permite acesso fácil ao seu conteúdo do Confluence e aos tickets do Jira diretamente pela interface MCP.

Recursos

Confluence

• Pesquisa de conteúdo usando CQL (Confluence Query Language)
• Acesso a páginas, anexos e comentários
• Filtragem por espaço (space)

Jira

• Pesquisa de issues usando JQL (Jira Query Language)
• Obtenção de detalhes sobre issues, incluindo status, atribuição e carimbos de data/hora

Instalação

Instalação via Smithery

Para instalar o Atlassian Integration Server para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @petrsovadina/mcp-atlassian --client claude

Instalação Manual

git clone https://github.com/petrsovadina/mcp-atlassian.git
cd mcp-atlassian
npm install
npm run build

Configuração

Defina as seguintes variáveis de ambiente:

Confluence

CONFLUENCE_URL=https://your-domain.atlassian.net/wiki
CONFLUENCE_USERNAME=your-email@domain.com
CONFLUENCE_API_TOKEN=your-api-token

Jira

JIRA_URL=https://your-domain.atlassian.net
JIRA_USERNAME=your-email@domain.com
JIRA_API_TOKEN=your-api-token

Uso no MCP

Adicione a seguinte configuração ao seu arquivo de configurações do MCP:

{
  "mcpServers": {
    "atlassian": {
      "command": "node",
      "args": ["/path/to/mcp-atlassian/build/index.js"],
      "env": {
        "CONFLUENCE_URL": "your-confluence-url",
        "CONFLUENCE_USERNAME": "your-username",
        "CONFLUENCE_API_TOKEN": "your-api-token",
        "JIRA_URL": "your-jira-url",
        "JIRA_USERNAME": "your-username",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

Ferramentas disponíveis

confluence_search

Pesquisa no conteúdo do Confluence usando CQL.

{
  "query": "type=page AND space='Engineering'", // CQL dotaz
  "limit": 10 // volitelný limit výsledků (1-50)
}

jira_search

Pesquisa de issues do Jira usando JQL.

{
  "jql": "project = ENG AND status = Open", // JQL dotaz
  "fields": "summary,status,assignee", // volitelné pole
  "limit": 10 // volitelný limit výsledků (1-50)
}

Modelos de Recursos

Página do Confluence

confluence://{space_key}/pages/{title}

Issue do Jira

jira://{project_key}/issues/{issue_key}

Exemplos de uso

Pesquisa no Confluence

const result = await mcp.use('confluence_search', {
  query: "type=page AND space='Engineering' ORDER BY created DESC",
  limit: 5
});

Pesquisa no Jira

const result = await mcp.use('jira_search', {
  jql: "project = ENG AND status = 'In Progress'",
  fields: "summary,status,assignee,created",
  limit: 5
});

Contribuição

Se você quiser contribuir para o desenvolvimento, você pode:

1. Fazer fork do repositório
2. Criar uma branch de funcionalidade
3. Fazer commit das suas alterações
4. Enviar a branch (push)
5. Criar um Pull Request

Licença

MIT