Os MCPs (Model Context Protocol) são servidores que expõem operações de sistemas internos — como Google Workspace e banco de dados — como ferramentas que a IA pode chamar diretamente durante uma conversa. A instalação é feita uma única vez e as ferramentas ficam disponíveis permanentemente no Claude Desktop, no Claude Code e no OpenAI Codex (incluído nas assinaturas do ChatGPT).
Instale apenas o que for necessário para o MCP específico que você vai utilizar.
O endereço do nHttp costuma ser um destes:
https://gc-SEUCODIGO.questor.com.brhttp://localhost:8080 ou o endereço do servidor na rede.O usuário deve ser informado no formato usuario@conexao, por exemplo usuario.mcp@escritorio.
⚠️Atenção!
Não utilize o usuário Administrador na conexão do MCP. Por normativa de segurança, crie no Questor um usuário próprio para o MCP, com apenas as permissões necessárias.
Baixe o arquivo ZIP correspondente ao MCP desejado. Extraia o conteúdo em uma pasta local de fácil acesso, por exemplo: C:\MCPs\nome-do-mcp\.
MCPs disponíveis:
Dentro da pasta extraída, dê duplo-clique em instalar.bat. O instalador executará automaticamente as seguintes etapas.
O instalador testa a conexão com o Questor antes de finalizar e registra o MCP automaticamente em todos os aplicativos encontrados na máquina: Claude Desktop, Claude Code e OpenAI Codex.
Caso precise alterar algum dado, como a senha, execute o instalar.bat novamente. O instalador exibe os valores atuais e não altera os outros MCPs já instalados.
Feche completamente o Claude Desktop, inclusive o ícone na bandeja do sistema, e abra novamente. No OpenAI Codex, feche e abra o aplicativo. Sem reiniciar, o MCP recém-instalado não será carregado.
Inicie uma nova conversa no Claude Desktop. As ferramentas dos MCPs instalados ficam disponíveis apenas em conversas iniciadas após o reinício. Para confirmar, clique no ícone de ferramentas (🔧) na interface — os MCPs instalados devem aparecer na lista. Em seguida, peça algo simples ao Claude usando o MCP, como "Qual a versão do Questor?". Se o Claude responder com dados reais, o MCP está funcionando corretamente.
No OpenAI Codex, também é possível conferir pelo terminal com o comando codex mcp list. O MCP gestao-contabil deve aparecer na lista.
O Claude Desktop armazena os registros dos MCPs em um arquivo de configuração cujo caminho varia conforme o tipo de instalação.
%LOCALAPPDATA%\Packages\Claude_*\LocalCache\Roaming\Claude\claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json~/.claude/settings.jsonQuando uma nova versão do MCP é lançada, o MCP avisa em uma das respostas da IA, informando a versão disponível e a versão instalada. Para atualizar, solicite à IA: "atualiza o MCP do Gestão Contábil".
Antes de aplicar, a IA mostra o que será alterado e só atualiza após a sua confirmação. Em seguida, feche e abra novamente o Claude Desktop (ou o OpenAI Codex).
A IA não mostra as ferramentas do Questor
Feche o Claude por completo, inclusive o ícone na bandeja do sistema, e abra novamente. Se continuar sem aparecer, execute o instalar.bat outra vez.
O OpenAI Codex não mostra as ferramentas do Questor
Execute codex mcp list em um terminal. Se o gestao-contabil não aparecer, o Codex foi instalado depois do MCP. Execute o instalar.bat novamente para que o registro seja feito.
Python não encontrado ao instalar
Instale o Python marcando a opção Add Python to PATH, feche a janela e execute o instalar.bat novamente.
O Questor parou de responder
Pergunte à IA: "o servidor do Questor está respondendo?". Em geral, é necessário reiniciar o serviço Questor.nHttp no servidor, tarefa de quem administra o Questor no escritório.
Usuário ou senha foram alterados
Execute o instalar.bat novamente e informe os novos dados.
⚠️Importante!
O MCP altera o sistema de verdade: as operações executadas por ele são aplicadas diretamente no Questor e no banco de dados, podendo inclusive alterar ou excluir informações. A instalação e a execução desses procedimentos são de responsabilidade do usuário.
- Revise cada operação antes de confirmá-la.
- Antes de realizar qualquer procedimento, certifique-se de que existe um backup atualizado e disponível.
- Não inclua nas consultas dados pessoais, dados sensíveis ou informações protegidas por sigilo, conforme a LGPD (Lei nº 13.709/2018).
- As respostas da IA são um apoio e não substituem a análise técnica e profissional. Confira e valide as informações antes de utilizá-las.
- Executar rotinas e importar dados exigem duas etapas: a primeira apenas mostra o que seria feito, e a execução só acontece após a sua aprovação.
- O usuário e a senha ficam somente no seu computador, no arquivo
.envda pasta de instalação. Não compartilhe esse arquivo.Acesse os Termos de Uso: