# Entrar no dsgit (API, token, Git, CLI, MCP e shell) — 5 passos

Para **um** usuário, na máquina dele. Windows 11 (PowerShell ou Git Bash), Linux ou macOS.
Precisa de: Git ≥ 2.36 (no Windows, Git for Windows, que já traz o Git Bash e o cofre de credenciais) e `curl`. Claude Code é opcional (sem ele o MCP não é registrado).

1. **Entre** em <https://dsgit.dsmarketing.com.br> com o usuário que o administrador criou (troque a senha no 1º login).
2. **Crie o seu token**: avatar → Configurações → Aplicações → *Gerar novo token*. Nome: `pc-<sua-máquina>`. Escopos (mínimo para o dia a dia):

   | Escopo | Nível | Para quê |
   |---|---|---|
   | `repository` | leitura e escrita | clone/push, PRs, execuções, logs, reexecutar |
   | `issue` | leitura e escrita | issues e comentários em PR |
   | `user` | leitura | o kit conferir quem é você |
   | `organization` | leitura | listar organizações e times |
   | `notification` | leitura | avisos (MCP) |
   | `package` | leitura | baixar pacotes |

   Nada de `admin`, nem escrita em `user`/`organization`. O token pode ser **restrito a repositórios específicos** na mesma tela (use isso em token de automação) [não testado aqui]. Copie o token: ele aparece uma vez só.
3. **Rode o kit** (nesta pasta):
   - Windows / PowerShell: `.\entrar.ps1` (se o Windows bloquear: `powershell -ExecutionPolicy Bypass -File .\entrar.ps1`)
   - Linux, macOS ou Git Bash: `bash entrar.sh`

   Cole o token quando pedir (não aparece na tela). Rodar de novo é seguro: reaproveita o token do cofre.
4. **Confira o autoteste** no fim: 5 linhas `PASS` (API, `git ls-remote`, CLI, MCP, Claude Code) e `0 FAIL`. Para repetir depois: `dsgit teste`.
5. **Use** (abra um terminal novo):

   | Comando | Faz |
   |---|---|
   | `git clone https://dsgit.dsmarketing.com.br/<dono>/<repo>.git` | Git por HTTPS, sem pedir senha (SSH do Git é desligado) |
   | `dsgit-prs [dono/repo]` | PRs abertos (sem argumento: o repositório da pasta atual) |
   | `dsgit-runs [dono/repo]` | execuções do Actions (`#N` é o número usado abaixo) |
   | `dsgit-log <N> [dono/repo] [etapa]` | log dos jobs da execução (ou só de uma etapa) |
   | `dsgit-rerun <N> [dono/repo]` | reexecuta |
   | `dsgit-api /user` | API direta (aceita opções do `curl`) |
   | `tea pulls create`, `tea issues`, `tea repos ls` | CLI `tea` (login `dsgit`) |
   | Claude Code | ferramentas `mcp__dsgit__*` (ver `AGENTE-IA.md`) |

**Sair / desfazer tudo:** `.\sair.ps1` ou `bash sair.sh`, e apague o token em Configurações → Aplicações.

## O que o kit põe na máquina (e onde fica o token)
| Item | Onde | Token? |
|---|---|---|
| Token | cofre de credenciais do sistema, pelo `git credential`: Gerenciador de Credenciais (Windows), Keychain (macOS), libsecret (Linux; sem ele, arquivo `~/.dsgit/git-credentials` 600 com aviso) | sim |
| CLI `tea` 0.16.0 (sha256 do release conferido) | `~/.dsgit/bin` | a `tea` guarda o token **em texto** na configuração dela no perfil do usuário (`%LOCALAPPDATA%\tea\config.yml` / `~/.config/tea/config.yml`); é limite da ferramenta, `sair` remove |
| MCP `forgejo-mcp` 2.30.2 (sha256 conferido) | `~/.dsgit/bin` | não: recebe o token do cofre a cada início |
| Comando `dsgit` | `~/.dsgit/bin/dsgit` | não |
| Git | `~/.gitconfig`: 3 chaves só para este host (`credential.https://dsgit…` e um `includeIf`); nome/e-mail da conta em `~/.dsgit/gitconfig`, valendo só em clones do dsgit | não |
| Claude Code | servidor MCP `dsgit` em escopo de usuário (os outros servidores não são tocados) | não |
| Shell | bloco marcado `# >>> dsgit … # <<< dsgit <<<` em `~/.bashrc` (e `~/.zshrc`) e no `$PROFILE` do PowerShell; variável de usuário `DSGIT_URL` | não |

## Avisos
- **Windows, 1ª vez:** o `forgejo-mcp` não publica `.exe`; o kit compila a versão fixada com Go portátil em pasta temporária (nada é instalado) e confere o sha256. Leva de 4 a 13 minutos (medido; depende da carga da máquina) e baixa ~75 MB. Quando o `.exe` for publicado como pacote do dsgit, o kit baixa em vez de compilar.
- VPN da Under em **túnel completo** não abre o dsgit; use a VPN dividida.
- `tea actions runs view/logs` **não funciona** com o Forgejo 17 (formato diferente do Gitea); use `dsgit-runs` / `dsgit-log`.
- O token do dia a dia **não cria repositório** (isso pede escrita em `user`); peça ao administrador ou crie pela tela.
- Trocar de token: gere outro, rode `DSGIT_TOKEN_FILE=<arquivo> bash entrar.sh` (ou `sair` e `entrar`) e apague o antigo.
