Atlassian MCP Server

Servidor MCP da Atlassian

Um servidor de Model Context Protocol (MCP) somente leitura para produtos Atlassian (Confluence e Jira).

Instalação

pip install -e .

Configuração

Defina suas credenciais da Atlassian como variáveis de ambiente:

export ATLASSIAN_DOMAIN=your-company.atlassian.net
export ATLASSIAN_EMAIL=your-email@company.com

# Separate tokens for each service (recommended)
export ATLASSIAN_CONFLUENCE_TOKEN=your-confluence-token
export ATLASSIAN_JIRA_TOKEN=your-jira-token

# OR for backward compatibility, single token (if it has access to both)
export ATLASSIAN_API_TOKEN=your-api-token

Criando Tokens de API

1. Acesse: https://id.atlassian.com/manage-profile/security/api-tokens
2. Clique em "Create API token"

Para Confluence:

• Ao criar um token do Confluence, selecione estes escopos:
  • read:content:confluence - Visualizar páginas, postagens de blog, comentários, anexos
  • read:content-details:confluence - Visualizar metadados e propriedades de conteúdo

Para Jira:

• Ao criar um token do Jira, você verá opções de escopo diferentes. Procure por:
  • Escopos que permitam ler issues e projetos
  • Capacidades de pesquisa para consultas JQL
  • Permissões básicas de navegação

Nota: Os nomes exatos dos escopos podem variar na interface da Atlassian. Escolha os escopos mínimos somente leitura que permitam visualizar issues, projetos e pesquisar. Se não tiver certeza, você pode começar com permissões de leitura mais amplas e restringi-las depois.

Uso

Inicie o servidor MCP:

atlassian-mcp

Ferramentas Disponíveis

Confluence

• confluence_get_page - Obter uma página por ID
• confluence_get_page_by_url - Obter uma página por URL
• confluence_search_pages - Pesquisar páginas
• confluence_list_spaces - Listar todos os espaços

Jira

• jira_get_issue - Obter uma issue pela chave (ex.: PROJ-123)
• jira_get_issue_by_url - Obter uma issue por URL
• jira_search_issues - Pesquisar issues usando JQL
• jira_list_projects - Listar todos os projetos

URLs Suportadas

Páginas do Confluence

• https://domain.atlassian.net/wiki/spaces/SPACE/pages/123456/Page+Title
• https://domain.atlassian.net/wiki/display/SPACE/Page+Title?pageId=123456
• https://domain.atlassian.net/wiki/pages/viewpage.action?pageId=123456

Issues do Jira

• https://domain.atlassian.net/browse/PROJ-123
• https://domain.atlassian.net/jira/software/projects/PROJ/boards/1?selectedIssue=PROJ-123

Configuração do Cliente MCP

{
  "mcpServers": {
    "atlassian": {
      "command": "python",
      "args": ["-m", "atlassian_mcp.server"],
      "cwd": "/path/to/your/atlassian_mcp",
      "env": {
        "ATLASSIAN_DOMAIN": "your-company.atlassian.net",
        "ATLASSIAN_EMAIL": "your-email@company.com",
        "ATLASSIAN_CONFLUENCE_TOKEN": "your-confluence-token",
        "ATLASSIAN_JIRA_TOKEN": "your-jira-token"
      }
    }
  }
}

Endpoints de API Utilizados

Este servidor utiliza os seguintes endpoints da API REST da Atlassian:

API REST do Confluence:

• GET /wiki/rest/api/content/{id} - Obter conteúdo da página
• GET /wiki/rest/api/content/search - Pesquisar páginas usando CQL
• GET /wiki/rest/api/space - Listar espaços

API REST v3 do Jira:

• GET /rest/api/3/issue/{issueIdOrKey} - Obter detalhes da issue
• GET /rest/api/3/search - Pesquisar issues usando JQL
• GET /rest/api/3/project - Listar projetos

Todos os endpoints são somente leitura e exigem autenticação básica com seu e-mail e token de API.