# mcp-eouve

Servidor Model Context Protocol (MCP) para integração com o portal **eOuve** (Ouvidoria Municipal & e-SIC).

Ele permite que você:
1. Autentique-se com credenciais ou com um token JWT.
2. Liste os acompanhamentos de Ouvidoria.
3. Liste as solicitações de e-SIC (Pedido de Informação).
4. Envie/Cadastre novos pedidos de e-SIC.
5. Liste os órgãos (secretarias) e assuntos cadastrados para qualquer município/cidade suportada.

---

## Pré-requisitos

- [Node.js](https://nodejs.org/) (recomendado v20+)
- `npm`

---

## Instalação

1. Clone ou copie este repositório para o seu sistema.
2. Execute o comando `npm install` na pasta do projeto:
   ```bash
   npm install
   ```

---

## Ferramentas Expostas (Tools)

### 1. `login`
Autentica no sistema eOuve e armazena o token de acesso para a sessão ativa.
- **Parâmetros:**
  - `username` (string, obrigatório): E-mail ou CPF/CNPJ.
  - `password` (string, obrigatório): Senha de login.
  - `cityId` (string, opcional, padrão: `"2355"` para Olinda).

### 2. `list_ouvidorias`
Lista as manifestações ativas de Ouvidoria associadas ao usuário.
- **Parâmetros:**
  - `token` (string, opcional): Token de acesso (se omitido, utiliza o token ativo da sessão).

### 3. `list_sics`
Lista os Pedidos de Informação (e-SIC) ativos associados ao usuário.
- **Parâmetros:**
  - `token` (string, opcional): Token de acesso (se omitido, utiliza o token ativo da sessão).

### 4. `list_secretarias`
Obtém as secretarias e IDs de assuntos cadastrados para a cidade especificada.
- **Parâmetros:**
  - `cityId` (string, opcional): Padrão: cidade da sessão ou `"2355"`.
  - `token` (string, opcional): Token de acesso.

### 5. `send_sic`
Envia um novo Pedido de Informação (e-SIC).
- **Parâmetros:**
  - `pergunta` (string, obrigatório): O conteúdo do pedido de informação.
  - `idSecretaria` (string, obrigatório): ID da secretaria de destino.
  - `idSecretariaAssunto` (string, obrigatório): ID do assunto específico.
  - `token` (string, opcional): Token de acesso.
  - `idUnidade` (string, opcional, padrão: `""`).
  - `dadosSigilosos` (string, opcional, padrão: `"N"`).
  - `urgente` (string, opcional, padrão: `"N"`).

---

## Integração com o Claude Desktop

Para configurar este servidor no Claude Desktop, edite o seu arquivo de configuração:

- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

Adicione a configuração do servidor:
```json
{
  "mcpServers": {
    "eouve": {
      "command": "node",
      "args": ["/caminho/absoluto/para/mcp-eouve/index.js"],
      "env": {}
    }
  }
}
```

Substitua `/caminho/absoluto/para/mcp-eouve/index.js` pelo caminho real da pasta do projeto em sua máquina.