MCP.Market

Claro Gerencial MCP server

by hlgurgel·io.github.hlgurgel/ws-claro-gerencial·v0.1.0
No reviews yet

Servidor MCP para integração com os WebServices SOAP do Claro Gerencial (Redeinova)

B78/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B78/100

full report

Adoption
New

0 stars15 downloads/wk

Reviews

Write one

Nobody has reviewed Claro Gerencial yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Claro Gerencial tools

No tool declarations could be read from the package source. They show once the server is installed.

Public scan report

scanner v0.1.10 · 2026-10-14 · same rubric, same numbers if you re-run it

no findings
  • Code scan10 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 34 days ago12/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 78/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Claro Gerencial compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
78/100
higher than 57% of 48,255 servers
Downloads a week
15
more than 4% of 12,191 servers with a package

Install Claro Gerencial in Claude Code, Cursor or VS Code

claude mcp add ws-claro-gerencial -- uvx ws-claro-gerencial-mcp
Add to Cursor

What the publisher says

From the Claro Gerencial repository's README, as published. We do not edit it. Read it on GitHub

ws-claro-gerencial-mcp

<!-- mcp-name: io.github.hlgurgel/ws-claro-gerencial -->

Servidor MCP (Model Context Protocol) para integração com os WebServices SOAP do Claro Gerencial (plataforma da Claro gerenciada pela Redeinova Tecnologia).

Este servidor permite que agentes de IA (como o opencode, Claude Code, etc.) interajam diretamente com o Claro Gerencial, realizando consultas e envios de dados de forma autônoma.

Funcionalidades

O servidor expõe 6 ferramentas via MCP:

  • listarentidades** — Lista todas as entidades disponíveis e suas direções (input/output)
  • obterregistros** — Consulta registros de qualquer entidade (completa ou incremental)
  • gerararquivo** — Solicita geração de arquivo FTP a partir de um ticket de consulta
  • enviarregistros** — Envia XML para importação de registros
  • obterstatus** — Consulta status de processamento de um envio
  • obterschemaxml — Obtém schema XSD para validação antes do envio

Entidades disponíveis

  • Cidades, Bairros, Clientes (PDVs), ClientesVisitas, Empresas, Gerentes, Supervisores
  • Vendedores, Setores, Grupos de Produtos, MotivosVisitas, Produtos, Segmentos
  • TiposClientes, TiposSinalizações, ClientesSinalizações, Visitas
  • Integradores, Pedidos, ChipsVendedor, MotivosICCIDS, ICCID, RedesPDV
  • VendasBandaLarga, ReleiturasICCID

Instalação

pip install ws-claro-gerencial-mcp

Ou, sem instalar nada (executa direto do PyPI com cache):

uvx --from ws-claro-gerencial-mcp ws-claro-gerencial-mcp

Ou para desenvolvimento:

git clone https://github.com/hlgurgel/ws-claro-gerencial-mcp.git
cd ws-claro-gerencial-mcp
pip install -e .

Configuração

Crie um arquivo .env na raiz do projeto ou defina as variáveis de ambiente:

CLARO_USUARIO=seu_usuario
CLARO_SENHA=sua_senha
CLARO_AMBIENTE=homologacao

Variáveis de ambiente

Uso com clientes MCP

Claude Desktop

Adicione ao claudedesktopconfig.json:

{
  "mcpServers": {
    "claro-gerencial": {
      "command": "uvx",
      "args": ["--from", "ws-claro-gerencial-mcp", "ws-claro-gerencial-mcp"],
      "env": {
        "CLARO_USUARIO": "seu_usuario",
        "CLARO_SENHA": "sua_senha",
        "CLARO_AMBIENTE": "homologacao"
      }
    }
  }
}

OpenCode

Adicione ao opencode.json do seu projeto:

{
  "mcp": {
    "claro-gerencial": {
      "type": "local",
      "command": ["ws-claro-gerencial-mcp"],
      "environment": {
        "CLARO_USUARIO": "seu_usuario",
        "CLARO_SENHA": "sua_senha",
        "CLARO_AMBIENTE": "homologacao"
      }
    }
  }
}

Exemplos de uso

> Liste as entidades disponíveis no Claro Gerencial.

> Consulte os clientes ativos (entidade: 'clientes') de forma completa.

> Envie um novo cliente:
<Clientes>
  <Cliente>
    <Empresa>1</Empresa>
    <Sequencial>999</Sequencial>
    <Nome>NOVO PDV</Nome>
    <DbAcao>I</DbAcao>
  </Cliente>
</Clientes>

Requisitos de segurança

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Claro Gerencial: common questions

Is Claro Gerencial MCP server safe?
Mostly: it is graded B (78/100). Read the Claro Gerencial safety report
How do I install Claro Gerencial?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Claro Gerencial need an API key?
Yes. The registry entry asks for CLARO_SENHA.
Is Claro Gerencial maintained?
The last commit was 54 days ago (2026-09-10). The latest release is v0.1.0.
How does Claro Gerencial compare with other MCP servers?
safety score 78/100 (higher than 57% of 48,255 servers); downloads a week 15 (more than 4% of 12,191 servers with a package). Full comparison.