Servidores MCP

Ferramentas externas para o agente: adicionar, conferir, ligar e desligar, OAuth.

Updated on Sep 16, 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.

Adicionar

# 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 add

O 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:

hinow.jsonjson

"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 }
}

Conferir

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 OAuth

Na 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).

O que o agente vê

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.

Detalhes

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.

Was this page helpful?