> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.basement.chat/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.basement.chat/_mcp/server.

# Jira e Confluence

O Jira é a ferramenta de demandas e projetos da [Atlassian](https://www.atlassian.com/br/software/jira). O Confluence é a base de páginas da mesma empresa. O Gateway usa o servidor MCP da própria Atlassian. Não precisa de configuração do administrador: cada pessoa conecta a própria conta Atlassian.

## O que o assistente faz

| Com só leitura                                                                                                                                           | Com leitura e escrita                                                                              |
| -------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| Busca itens (issues) por texto ou por filtro (JQL). Lê um item: título, descrição, situação, responsável, comentários. Busca e lê páginas do Confluence. | Tudo da leitura. Cria itens. Altera campos e situação. Adiciona comentários. Cria e edita páginas. |

O assistente vê só os projetos e páginas que a sua conta Atlassian vê.

## Conectar a sua conta

Em **Conexões**, no cartão **Jira**, toque em **Conectar minha conta**. Há duas formas:

#### Entrar com a Atlassian (recomendado)

1. Toque em **Entrar com a Atlassian**.
2. Entre na Atlassian. Escolha o site (por exemplo `suaempresa.atlassian.net`) e autorize o Basement.
3. Volte ao Gateway. O cartão mostra **Conectado**.

Se a Atlassian bloquear a entrada, o administrador do seu site Atlassian precisa permitir o Basement uma vez: em [admin.atlassian.com](https://admin.atlassian.com), **Rovo › Rovo MCP server › Domains › Add domain**, e adicionar o domínio que o Gateway mostra na tela.

#### Token de API

1. Abra a página [Tokens de API da Atlassian](https://id.atlassian.com/manage-profile/security/api-tokens). Toque em **Create API token with scopes**. Um token simples (sem escopos) não funciona.
2. Dê um nome ao token. Selecione o app **Atlassian MCP V2** e marque todos os escopos dele. Crie e copie o token.
3. No Gateway, cole o token e informe o e-mail da sua conta Atlassian. Toque em **Conectar**.

O administrador do seu site Atlassian precisa permitir tokens de API uma vez: **admin.atlassian.com › Rovo › Rovo MCP server › Authentication › API token**.

## Exemplos de pergunta

* "Quais itens do projeto OPS estão em andamento no meu nome?"
* "Resuma o item OPS-12 e os comentários."
* "Crie um item no projeto OPS: 'Revisar a integração X', prioridade alta." (precisa de leitura e escrita)
* "O que diz a página 'Procedimento de deploy' no Confluence?"

## Se não funcionar

| Mensagem                             | O que fazer                                                                               |
| ------------------------------------ | ----------------------------------------------------------------------------------------- |
| A Atlassian recusou a entrada        | Peça ao administrador do site Atlassian a liberação do Basement (acima).                  |
| O token não funciona                 | Confira se o token foi criado **com escopos** e com o app **Atlassian MCP V2**.           |
| O assistente não vê um projeto       | A sua conta Atlassian não tem acesso a esse projeto.                                      |
| Uma escrita responde "não permitido" | O seu nível de acesso tem só leitura no Jira. Peça ao administrador um nível com escrita. |