Atlassian

MCP Atlassian

Servidor Model Context Protocol (MCP) para produtos Atlassian (Confluence e Jira). Suporta implantações Cloud e Server/Data Center.

https://github.com/user-attachments/assets/35303504-14c6-4ae4-913b-7c25ea511c3e

Demonstração do Confluence

https://github.com/user-attachments/assets/7fe9c488-ad0c-4876-9b54-120b666bb785

Início Rápido

1. Obtenha Seu Token de API

Acesse https://id.atlassian.com/manage-profile/security/api-tokens e crie um token.

Para Server/Data Center, use um Personal Access Token. Consulte Autenticação.

2. Configure Sua IDE

Adicione à configuração MCP do seu Claude Desktop ou Cursor:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      }
    }
  }
}

Usuários de Server/Data Center: Use JIRA_PERSONAL_TOKEN em vez de JIRA_USERNAME + JIRA_API_TOKEN. Consulte Autenticação para detalhes.

Autohand Code

Use o mesmo servidor uvx com suas credenciais Atlassian:

autohand mcp add mcp-atlassian env \
  JIRA_URL=https://your-company.atlassian.net \
  JIRA_USERNAME=your.email@company.com \
  JIRA_API_TOKEN=your_api_token \
  CONFLUENCE_URL=https://your-company.atlassian.net/wiki \
  CONFLUENCE_USERNAME=your.email@company.com \
  CONFLUENCE_API_TOKEN=your_api_token \
  uvx mcp-atlassian

Adicione --scope project após add para manter a configuração no projeto atual. Consulte Autohand Code para detalhes atuais de instalação e CLI.

3. Comece a Usar

Peça ao seu assistente de IA para:

• "Encontrar problemas atribuídos a mim no projeto PROJ"
• "Pesquisar no Confluence por documentos de integração"
• "Criar um ticket de bug para o problema de login"
• "Atualizar o status de PROJ-123 para Concluído"

Documentação

A documentação completa está disponível em mcp-atlassian.soomiles.com.

A documentação também está disponível no formato llms.txt, que LLMs podem consumir facilmente:

• llms.txt — mapa do site da documentação
• llms-full.txt — documentação completa

Tópico	Descrição
Instalação	uvx, Docker, pip, a partir do código-fonte
Autenticação	Tokens de API, PAT, OAuth 2.0
Configuração	Configuração da IDE, variáveis de ambiente
Transporte HTTP	SSE, streamable-http, multi-usuário
Referência de Ferramentas	Todas as ferramentas do Jira e Confluence
Solução de Problemas	Problemas comuns e depuração

Compatibilidade

Produto	Implantação	Suporte
Confluence	Cloud	Totalmente suportado
Confluence	Server/Data Center	Suportado (v6.0+)
Jira	Cloud	Totalmente suportado
Jira	Server/Data Center	Suportado (v8.14+)

Ferramentas Principais

Jira	Confluence
jira_search - Pesquisar com JQL	confluence_search - Pesquisar com CQL
jira_get_issue - Obter detalhes do problema	confluence_get_page - Obter conteúdo da página
jira_create_issue - Criar problemas	confluence_create_page - Criar páginas
jira_update_issue - Atualizar problemas	confluence_update_page - Atualizar páginas
jira_transition_issue - Alterar status	confluence_add_comment - Adicionar comentários

98 ferramentas no total — Consulte Referência de Ferramentas para a lista completa.

Segurança

Nunca compartilhe tokens de API. Mantenha os arquivos .env seguros. Consulte SECURITY.md.

Contribuindo

Consulte CONTRIBUTING.md para a configuração de desenvolvimento.

Licença

MIT - Consulte LICENSE. Não é um produto oficial da Atlassian.