ws-claro-gerencial-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CLARO_SENHA | Yes | Senha de acesso ao webservice | |
| CLARO_USUARIO | Yes | Usuário de acesso ao webservice | |
| CLARO_AMBIENTE | No | Ambiente: homologacao ou producao | homologacao |
| CLARO_URL_BASE_INPUT | No | URL base do WS de Input | https://clarogerencial.redeinova.com.br/wsinput |
| CLARO_URL_BASE_OUTPUT | No | URL base do WS de Output | https://clarogerencial.redeinova.com.br/wsoutput |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| listar_entidadesA | Lista todas as entidades disponíveis no Claro Gerencial, indicando quais suportam consulta (output) e quais suportam envio (input). Use esta ferramenta para descobrir quais entidades existem antes de usar as demais. |
| obter_registrosA | Obtém registros de uma entidade do Claro Gerencial (WebService de Output). Use esta ferramenta para consultar/baixar dados do sistema. Parâmetros:
Retorna um ticket que pode ser usado em 'gerar_arquivo' para gerar um arquivo FTP. Se a quantidade de registros retornados atingir o limite, faça novas chamadas com completa=False até que o retorno venha vazio. |
| gerar_arquivoA | Gera um arquivo FTP com os registros obtidos anteriormente via 'obter_registros'. Use o ticket retornado por 'obter_registros' para solicitar que o conteúdo seja disponibilizado via FTP. O arquivo ficará disponível em até 2 horas. Parâmetros:
|
| enviar_registrosA | Envia registros em XML para importação no Claro Gerencial (WebService de Input). Use esta ferramenta para inserir, alterar ou excluir registros no sistema. O XML deve seguir o schema XSD da entidade (use 'obter_schema_xml' para validar). Cada registro no XML deve conter o campo DbAcao: I (Inclusão), A (Alteração), E (Exclusão). Parâmetros:
Retorna um ticket para acompanhar o status via 'obter_status'. |
| obter_statusA | Consulta o status de um envio de registros pelo ticket (WebService de Input). Use após 'enviar_registros' para acompanhar o processamento. Códigos de status: 0 - Na Fila para importação 1 - Registros sendo transferidos para o SGR 2 - Verificar preenchimento das informações 3 - Verificar se registros de exclusão existem 4 - Verificar registros de inclusão repetidos 5 - Verificar campos de cadastros relacionados 6 - Atualizar log para Inclusão 7 - Atualizar log para Alteração 8 - Atualizar log para Exclusão 9 - Envio Finalizado 99 - Erro ao Enviar Quando status=9 (Envio Finalizado), o campo Conteudo traz o log detalhado com registros importados e eventuais erros. |
| obter_schema_xmlA | Obtém o schema XSD (XML Schema Definition) de uma entidade para validação antes do envio (WebService de Input). Use esta ferramenta para verificar a estrutura esperada do XML antes de chamar 'enviar_registros'. O schema define os campos obrigatórios, tipos e formato esperado para cada entidade. Parâmetros:
|
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool has a clearly distinct role: discovery, querying output records, generating FTP files, sending input XML, checking input status, and retrieving schemas. The only closely related pair (obter_registros/gerar_arquivo and enviar_registros/obter_status) is explicitly chained via tickets, so there is no real ambiguity.
All tool names follow the same Portuguese snake_case verb_noun pattern: listar_entidades, obter_registros, gerar_arquivo, enviar_registros, obter_status, obter_schema_xml. This is highly predictable and makes the API easy to navigate.
Six tools is well-scoped for an integration server covering both output (query/download) and input (send/status) workflows plus discovery and schema validation. Every tool serves a necessary step in the intended process without redundancy.
The tool surface covers the full lifecycle: discover entities, query output records, generate the FTP artifact, retrieve the XSD schema, submit input records, and poll status until completion. No obvious dead ends remain for the stated Claro Gerencial integration purpose.