Servidores MCP
Ferramentas externas para o agente: adicionar, conferir, ligar e desligar, OAuth.
Atualizado em 16 de set. de 2026
Servidores MCP (Model Context Protocol) dão ferramentas novas ao agente: consultar um banco de dados, controlar o navegador, falar com a API da sua empresa ou com um serviço externo. O HiNow Code conversa com servidores locais, um processo que ele mesmo inicia, e remotos, uma URL, com ou sem OAuth.
# local: o que vem depois de -- é o comando que sobe o servidor
hinow-cli mcp add playwright -- npx -y @playwright/mcp
hinow-cli mcp add clima --env API_KEY=... -- bun ./mcp/clima.ts
# remoto
hinow-cli mcp add github --url https://api.githubcopilot.com/mcp/ --header "Authorization=Bearer $GITHUB_TOKEN"
# sem argumentos, pergunta tudo (nome, tipo, onde gravar: projeto ou global)
hinow-cli mcp addO comando grava em hinow.json (global, em ~/.config/hinow/, quando é pela linha de comando; no modo interativo você escolhe). O mesmo pode ser escrito à mão:
"mcp": {
"playwright": { "type": "local", "command": ["npx", "-y", "@playwright/mcp"], "environment": { "BROWSER": "chromium" } },
"github": { "type": "remote", "url": "https://api.githubcopilot.com/mcp/", "headers": { "Authorization": "Bearer {env:GITHUB_TOKEN}" } },
"antigo": { "enabled": false }
}hinow-cli mcp list # cada servidor e se conectou
hinow-cli mcp auth github # login OAuth num servidor remoto que exige
hinow-cli mcp logout github
hinow-cli mcp debug github # detalhes da conexão OAuthNa interface, o rodapé mostra ⊙ N MCP; /status lista cada um com o estado, e /mcps liga e desliga servidores só nesta sessão (espaço alterna).
Cada ferramenta do servidor vira uma ferramenta chamada servidor_ferramenta (clima_clima, playwright_navigate); permissões valem por esse nome ou por mcp_*. Prompts publicados pelo servidor viram comandos /servidor:prompt. Testado com um servidor mínimo em TypeScript: hinow-cli mcp add clima -- bun ./mcp-clima.ts, e o agente respondeu "Qual o clima em Lisboa?" chamando clima_clima.
| Opção | O que faz |
|---|---|
enabled: false | Desliga um servidor sem apagar (útil para desligar no projeto um servidor global) |
environment | Variáveis de ambiente do processo local; aceita {env:…} |
headers | Cabeçalhos do servidor remoto (token, tenant) |
experimental.mcp_timeout | Tempo máximo de conexão, em ms (padrão razoável para servidores lentos ao subir) |
tools: {"mcp_*": false} | Esconde todas as ferramentas MCP de um agente |
Confiança
Um servidor MCP roda com as suas permissões e pode ler o que o processo lê. Instale só os que conhece; para os remotos, prefira token por {env:…} a colar no arquivo.