Mais
Automação e MCP
Servidor MCP da Gestão para agentes na própria VPS: ferramentas, chaves e registro de chamadas. Só admin.
Servidor MCP
AtivoSó na VPSCompleto
http://127.0.0.1:5513/mcpSomente leitura
http://127.0.0.1:5513/mcp/readonly- Especificação
- 2026-07-28 (sem estado, com confirmação humana) · compatível com 2025-03-26, 2025-06-18 e 2025-11-25
- Ferramentas
- 26 · 15 de leitura, 7 de escrita de baixo risco, 4 com confirmação
- Chamadas hoje
- 8 · todas ok, 2 criaram revisão · limite 240/min por chave
- Clientes conectados
- executor da VPS (codex-2, claude) · 1 chave de agente
Proteções
Conferidas hoje às 08:00.
- Acesso externo bloqueadoApache recusa /mcp (403) · só 127.0.0.1
- Somente leitura por padrãoEscrita exige chave com escopo “escrita” ou “operar”
- E-mail e NFS-e só com uma pessoaFerramentas de operação criam revisões pendentes
- Registro sem conteúdoGuarda ferramenta, hash dos argumentos e resultado
Ferramentas
Nomes em português, por fase. O agente só vê as ferramentas do seu papel e escopo.
| Ferramenta | Fase | Anotações | Papel mínimo | Escopo |
|---|---|---|---|---|
| consultar_tarefasTarefas por responsável, prazo ou trabalho | Leitura | Somente leituraIdempotente | viewer | read |
| consultar_agendaReservas de pessoas e equipamentos por período | Leitura | Somente leituraIdempotente | viewer | read |
| consultar_trabalhosTrabalhos com etapa, prazo e equipe | Leitura | Somente leituraIdempotente | viewer | read |
| consultar_clientesClientes e contatos | Leitura | Somente leituraIdempotente | viewer | read |
| consultar_potenciais_clientesPotenciais com etapa e qualificação | Leitura | Somente leituraIdempotente | viewer | read |
| consultar_orcamentosPropostas e planilhas de custo | Leitura | Somente leituraIdempotente | viewer | read |
| consultar_equipamentosEquipamentos e disponibilidade | Leitura | Somente leituraIdempotente | viewer | read |
| consultar_ideiasIdeias e insights da equipe | Leitura | Somente leituraIdempotente | viewer | read |
| consultar_oportunidadesOportunidades e licitações | Leitura | Somente leituraIdempotente | viewer | read |
| consultar_contasContas a receber e a pagar | Leitura | Somente leituraIdempotente | finance | read |
| consultar_notas_fiscaisNotas emitidas e situação (sem XML) | Leitura | Somente leituraIdempotente | finance | read |
| resumo_do_diaO mesmo resumo da tela Hoje | Leitura | Somente leituraIdempotente | viewer | read |
| buscar_na_gestaoA busca global (⌘K) em todos os registros | Leitura | Somente leituraIdempotente | viewer | read |
| consultar_conversaEstado, vínculo e etiquetas da conversa do job | Leitura | Somente leituraIdempotente | operator | read · conversa |
| mensagens_da_conversaÚltimas 20 mensagens, sem notas privadas | Leitura | Somente leituraIdempotente | operator | read · conversa |
| criar_tarefaCria tarefa com origem “agente … job …” | Escrita | Idempotente | operator | write |
| criar_compromisso_previstoReserva prevista na Agenda, a confirmar por uma pessoa | Escrita | Idempotente | operator | write |
| criar_potencial_clientePotencial cliente a partir de uma conversa | Escrita | Idempotente | operator | write |
| criar_pedidoPedido com resumo, escopo e pontos em aberto · pode ser desfeito | Escrita | Idempotente | operator | write |
| atualizar_pedidoCompleta escopo, prazo e referências do Pedido | Escrita | Idempotente | operator | write |
| etiquetar_conversaAplica etiquetas existentes | Escrita | Idempotente | operator | write |
| anotar_conversaNota privada para a equipe (nunca vai ao contato) | Escrita | Idempotente | operator | write |
| preparar_emailPrepara e-mail e cria revisão pendente | Operação | Exige confirmação humana | admin | operate |
| preparar_nfsePrepara NFS-e e cria revisão pendente · nunca transmite | Operação | Exige confirmação humana | admin | operate |
| propor_revisaoCartão de revisão na conversa (Aprovar · Editar · Descartar) | Operação | Exige confirmação humana | operator | operate |
| confirmar_operacaoPede a resposta da pessoa antes de executar (clientes interativos) | Operação | Exige confirmação humana | admin | operate |
Nenhuma ferramenta encontradaAjuste a busca ou a fase. | ||||
Registro de chamadas
Sem argumentos nem respostas: só ferramenta, origem, duração e resultado.
| Hora | Ferramenta | Job ou chave | Duração | Resultado |
|---|---|---|---|---|
| 13/10 10:14:22 | buscar_na_gestao | job 8a1d · codex-2 | 182 ms | ok |
| 13/10 10:13:05 | consultar_oportunidades | job 8a1d · codex-2 | 240 ms | ok |
| 13/10 08:33:40 | criar_pedido | job 8a1f · codex-2 | 96 ms | ok · Pedido #1040 |
| 13/10 08:33:31 | mensagens_da_conversa | job 8a1f · codex-2 | 41 ms | ok |
| 13/10 08:33:29 | consultar_conversa | job 8a1f · codex-2 | 38 ms | ok |
| 13/10 08:10:52 | preparar_email | job 8a1c · claude | 120 ms | revisão criada |
| 13/10 07:59:48 | preparar_nfse | job 8a1e · claude | 310 ms | revisão criada |
| 13/10 07:59:30 | consultar_contas | job 8a1e · claude | 64 ms | ok |
| 12/10 21:15:03 | criar_tarefa | chave “Claude Desktop do Tiago” | 8 ms | recusada · escopo leitura |
| 12/10 21:14:40 | resumo_do_dia | chave “Claude Desktop do Tiago” | 120 ms | ok |
Como conectar
Assistentes fora da VPS entram pelo túnel SSH com uma chave de agente. A chave aparece mascarada; use o valor que você guardou ao criá-la.
- Abra o túnel até a VPS
Deixe este terminal aberto enquanto usa o Codex.
Terminalssh -N -L 5513:127.0.0.1:5513 tiago@gestao.gorillas.digital
- Guarde a chave e adicione o servidor
A chave fica numa variável de ambiente, fora do arquivo de configuração.
Terminal# troque pela chave completa que você guardou export GESTAO_MCP_TOKEN="ggak_••••3c9e" codex mcp add gestao --url http://127.0.0.1:5513/mcp/readonly \ --bearer-token-env-var GESTAO_MCP_TOKEN
- ConfiraTerminal
codex mcp list
- Abra o túnel até a VPS
Deixe este terminal aberto enquanto usa o Claude Code.
Terminalssh -N -L 5513:127.0.0.1:5513 tiago@gestao.gorillas.digital
- Adicione o servidor com a chaveTerminal
claude mcp add --transport http gestao \ http://127.0.0.1:5513/mcp/readonly \ --header "Authorization: Bearer ggak_••••3c9e" - Confira dentro do Claude Code
Rode
/mcpe veja “gestao” conectado com 15 ferramentas de leitura.
- Abra o túnel até a VPS
No Mac ou PC onde o Claude Desktop roda.
Terminalssh -N -L 5513:127.0.0.1:5513 tiago@gestao.gorillas.digital
- Edite claude_desktop_config.json
Configurações › Desenvolvedor › Editar configuração. Depois, reinicie o Claude Desktop.
claude_desktop_config.json{ "mcpServers": { "gestao": { "command": "npx", "args": ["-y", "mcp-remote", "http://127.0.0.1:5513/mcp/readonly", "--header", "Authorization: Bearer ${GESTAO_MCP_TOKEN}"], "env": { "GESTAO_MCP_TOKEN": "ggak_••••3c9e" } } } }