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.

6. Envie recursos às respostas de pedidos de e-SIC existentes.

Pré-requisitos

• Node.js (recomendado v20+)

• npm

Related MCP server: MCP Compras.gov.br

Instalação

1. Clone ou copie este repositório para o seu sistema.

2. Execute o comando npm install na pasta do projeto:

   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").

6. send_sic_recurso

Envia recurso à resposta de um Pedido de Informação existente.

• Parâmetros:

  • idSic (string, obrigatório): ID positivo do pedido, retornado no campo Id de list_sics.

  • recurso (string, obrigatório): Texto do recurso, não vazio, com até 10000 caracteres.

  • token (string, opcional): Token de acesso (se omitido, utiliza o token ativo da sessão).

Contrato observado no portal em 02/10/2026:

POST https://eouve.com.br/api/sic/cadastrarrecurso
Authorization: bearer <token da sessão>
Content-Type: application/json;charset=UTF-8

{"Recurso":"Texto do recurso","IdSic":"98907","tipo":"RP"}

Resposta de sucesso: HTTP 200, {"Message":"Dados gravados com sucesso."}. O tipo RP corresponde ao recurso à resposta observado neste fluxo; outros tipos não foram verificados. Não repita o envio após uma falha de conexão sem consultar list_sics: o portal pode já ter registrado o recurso.

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:

{
  "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.