Metadata-Version: 2.4
Name: treasy-mcp
Version: 0.0.0.dev0
Summary: Servidor MCP do Treasy: o seu Treasy FP&A dentro do Claude Code, com login pelo navegador
Author: Treasy
License-Expression: LicenseRef-Treasy-Proprietaria
Keywords: treasy,mcp,claude,fpa,orcamento
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Operating System :: OS Independent
Classifier: Natural Language :: Portuguese (Brazilian)
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp<1.27,>=1.5.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: jsonschema>=4.0
Requires-Dist: openpyxl>=3.1
Dynamic: license-file

# treasy-mcp: o seu Treasy dentro do Claude Code

O `treasy-mcp` liga o Claude Code à sua conta do Treasy FP&A. Depois de instalado, você pede ao
Claude, em português, o que hoje faz no Treasy, e ele consulta os seus dados com o seu usuário.

Em produção o pacote é **somente leitura**: ele consulta, nunca altera.

## 1. Instale o `uv` (uma vez por computador)

O `uv` é o programa que baixa e roda o `treasy-mcp`. Se o comando `uv --version` já responde,
pule para o passo 2.

**Windows** (no PowerShell):

```powershell
winget install --id astral-sh.uv -e
```

**macOS** (no Terminal):

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

**Linux** (no terminal):

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

Feche e abra o terminal depois de instalar.

## 2. Ligue o Treasy ao Claude Code (a linha da instalação)

```bash
claude mcp add treasy -- uvx treasy-mcp
```

## 3. Entre com o seu usuário do Treasy (a linha do login)

```bash
uvx treasy-mcp login
```

O navegador abre na página de login do Treasy. Entre com o seu e-mail e a sua senha de sempre.
A senha fica só no navegador: o `treasy-mcp` guarda uma sessão no seu computador, na pasta
`.treasy` da sua pasta de usuário, e nunca vê a senha.

## 4. Pronto: peça ao Claude

Abra o Claude Code e peça, por exemplo: "liste as minhas empresas no Treasy".

## Quando algo não funciona

Rode o diagnóstico e mande as seis linhas ao suporte da Treasy (elas não têm segredo):

```bash
uvx treasy-mcp doctor
```

| O que aparece | O que fazer |
|---|---|
| `sem sessão de prod` | Rode `uvx treasy-mcp login`. |
| `a sessão de prod venceu` | Rode `uvx treasy-mcp login` de novo. |
| `porta 47650 ocupada` | Feche o programa que usa a porta 47650 e rode o login de novo. |
| `não respondeu` no SSO ou na API | Confira a internet, o proxy ou o firewall da empresa para `*.treasy.com.br`. |

Outros comandos:

```bash
uvx treasy-mcp status     # mostra a sessão gravada (nunca o token)
uvx treasy-mcp sair       # apaga a sessão deste computador
uvx treasy-mcp --version  # a versão instalada
```

Para usar outro ambiente que a Treasy lhe indicar (`qa` ou `sandbox`), acrescente o nome ao
login (`uvx treasy-mcp login sandbox`) e ligue o Claude com a variável do ambiente:
`claude mcp add treasy -e TREASY_AMBIENTE=sandbox -- uvx treasy-mcp`.
