Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@ahreas-mcp find the Ahreas method that lists units in a condominium"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Servidor MCP para o ERP Ahreas (Ahreas / Superlógica), o sistema de gestão de condomínios. Ele lê o catálogo de métodos direto do WSDL da sua própria instalação, descreve o que cada um faz e executa consultas e operações via SOAP com a credencial de web service da administradora. É o primeiro MCP de Ahreas — não existe hoje nenhum outro, oficial ou de comunidade.
A ideia é a mesma de manter a verdade na fonte: em vez de uma lista de métodos escrita à mão dentro do projeto, o servidor pergunta ao próprio Ahreas o que ele publica. Uma instalação real expõe cerca de 139 métodos entre os dois web services, e os módulos que a sua administradora não contratou aparecem como "sem acesso" — a mesma resposta que o ERP dá, não um erro.
Listar o catálogo de métodos lido dos WSDL de administracaoweb e
Condominioweb, com busca por texto.
Descrever um método: parâmetros, formato esperado, se lê ou escreve.
Executar um método com a credencial de web service, devolvendo o conteúdo normalizado.
Diagnosticar a instalação: se os dois serviços respondem e se a credencial é aceita.
Related MCP server: anythingmcp
Módulo não contratado não executa. Se a licença não cobre um método, o Ahreas recusa com "não possui acesso" e o servidor repassa isso como resposta.
Ele não emula regra de negócio. Nunca reproduz um método por conta própria; se o Ahreas não expõe, o servidor diz que não expõe.
Há dois modos, e a autenticação do Ahreas é a mesma dos dois: cada chamada leva
usuario + senha da pessoa e a chave da administradora. O Ahreas valida o
usuário e a senha individualmente, então as permissões aplicadas são as daquela
pessoa.
Remoto (HTTP + OAuth), multiusuário. É o modo do produto. A pessoa conecta
o MCP no cliente dela (Claude, GPT, Cursor) pela URL pública; ao autorizar,
abre uma tela pedindo o usuário e a senha do Ahreas dela. A chave fica no
servidor. Cada sessão executa com a credencial de quem logou.
Local (stdio), pessoal. Uma pessoa só, com AHREAS_USUARIO/AHREAS_SENHA
no ambiente.
As sessões vivem na memória do processo. O deploy do modo remoto tem de rodar um processo só — não subir réplicas sem um armazenamento de sessão compartilhado.
A credencial nunca é parâmetro de ferramenta. A chave entra por variável
de ambiente; o usuário e a senha vêm do login (remoto) ou do ambiente (stdio).
Nenhuma tool as recebe, então o modelo não as vê e elas não aparecem no
histórico da conversa.
A senha da sessão fica só na memória. O Ahreas autentica por chamada, sem token de sessão do lado dele; então a senha de quem logou fica na memória do processo enquanto a sessão vive, some no logout e na expiração, e nunca é registrada em log.
Escrita vem desligada. AHREAS_PERMITIR_ESCRITA é false por padrão. Toda
operação com efeito exige, além disso, uma confirmação explícita.
Não versione o .env. Ele já está no .gitignore.
Todas as variáveis usam o prefixo AHREAS_. Copie o .env.example como ponto de
partida.
Variável | Obrigatória | Padrão | Para que serve |
| sim | — | Endereço do Ahreas, ex. |
| sim | — | Chave de acesso da integração (da administradora). |
| só no stdio | — | Usuário do Ahreas, no modo local. |
| só no stdio | — | Senha desse usuário, no modo local. |
| só no remoto | — | URL pública do servidor; âncora do OAuth. |
| não |
| Validade da sessão antes de novo login. |
| não |
| Tempo máximo por chamada SOAP. |
| não |
| Tentativas num soluço de rede. |
| não |
| Validade do catálogo lido do WSDL. |
| não |
| Libera operações que gravam no ERP. |
MIT.
Projeto independente, sem qualquer vínculo com a Ahreas ou a Superlógica. Ahreas é marca de seus detentores, citada aqui apenas para identificar o sistema com o qual este servidor se comunica.
Detalha um método: serviço, parâmetros, formato e se lê ou grava.
Inputs: nome (required). Returns: object
Detalha uma tela: os campos que ela pede e as ações (botões) disponíveis.
Inputs: caminho (required). Returns: object
O que está de pé: os dois web services, o catálogo e a credencial.
Inputs: no named parameters. Returns: object
Confere se o modo telas está de pé: login web, catálogo e forma das telas.
Por ser replay de tela, o modo telas depende da forma do painel. Esta
ferramenta faz login, conta as telas do menu e abre uma amostra delas para
confirmar que ainda têm forma reconhecível (campos e ações) — um alarme caso
a Ahreas mude o painel. Passe caminho para checar uma tela específica antes
de uma operação importante nela.
Inputs: caminho. Returns: object
Aciona uma tela: preenche os campos e dispara o botão, por HTTP.
Consulta roda direto. Ação que altera o ERP exige confirmar=true e AHREAS_PERMITIR_ESCRITA, e antes disso mostre à pessoa o que vai rodar.
Inputs: acao (required), caminho (required), campos, confirmar. Returns: object
Executa um método do Ahreas com a credencial da instalação.
Leitura roda direto. Método que grava (ou de efeito incerto) exige confirmar=true, e escrita ainda depende de AHREAS_PERMITIR_ESCRITA.
Inputs: nome (required), confirmar, parametros. Returns: object
Sobe um arquivo em QUALQUER tela de importação e, com confirmação, processa.
Serve para toda tela que recebe arquivo (leitura de consumo, retorno bancário,
lote de lançamentos, etc.) — nada é específico de um fluxo. Descubra a tela em
listar_telas e os botões em descrever_tela (acao_processar é o que grava;
acao_reconhecer, se existir, é o que a tela dispara ao aceitar o arquivo).
Primeiro chame SEM confirmar: o arquivo é enviado e a tela o reconhece — o próprio Ahreas pode preencher campos a partir dele — sem gravar; mostre o resultado à pessoa. Só depois do sim dela, chame de novo com confirmar=true.
Inputs: caminho (required), conteudo (required), nome_arquivo (required), acao_processar (required), +3 more. Returns: object
Passo 1 para RELATÓRIOS e CONSULTAS financeiras rápidas (web service).
Use quando a pessoa quer DADOS: inadimplência, contas a pagar, fluxo de caixa, boletos, vencimentos, lançamentos. Busque pela intenção dela (ex.: 'boleto', 'inadimplencia') e depois chame descrever_metodo no que achar. Para OPERAR o Ahreas como no painel (importar consumo, emitir, cadastrar), use listar_telas.
Inputs: busca, limite, apenas_leitura. Returns: object
Passo 1 para OPERAR o Ahreas como no painel web (383 telas da instalação).
Use quando a pessoa quer FAZER algo que se faz na tela: importar leitura de consumo (gás/água), emitir boleto, lançar, cadastrar, processar emissão, gerar remessa — ou quando listar_metodos não achou um método para a consulta. Busque pela intenção (ex.: 'consumo', 'boleto', 'emissão') e chame descrever_tela no caminho que achar para ver os campos e as ações.
Inputs: busca, limite. Returns: object
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 9 tools
Tools are organized into two parallel sets (methods vs screens) with clear descriptions guiding usage. However, diagnostico and diagnostico_web could be confused, and the parallel naming might cause initial hesitation.
Names mostly follow verb_noun pattern in Portuguese, but there are inconsistencies: executar_metodo vs executar_acao_tela, and diagnostico_web vs diagnostico without verb. Still largely consistent and readable.
9 tools is well-scoped for the domain, covering listing, describing, executing for two modes plus import and diagnostics. Each tool has a distinct role.
The surface covers the full lifecycle for both web service methods and screen actions, including file import and health checks. No obvious gaps for the stated purpose.
Linux server administration over OAuth MCP: shell, Docker, systemd, files and monitoring.
Query, browse, and automate OmegaAI workspaces from any MCP client. Streamable HTTP with OAuth 2.0.
Remote MCP for 1,500+ APIs. Vault-managed credentials; OAuth or API key. Search, load, and execute.
Toolstile is a managed MCP gateway that connects remote MCP servers behind one endpoint, with per-agent permissions, shared accounts and activity logs. Connect at https://mcp.toolstile.com/mcp over Streamable HTTP with OAuth; sign in at https://toolstile.com, select a workspace and connect your upstream servers. Available tools, resources and prompts depend on that workspace and the agent's granted access.
