🔌Servidores MCP
Um servidor MCP dá ao Claude as ferramentas de um serviço: ler sua conta de anúncios, pesquisar em um workspace do Notion, consultar um banco de dados... Settings -> MCP lista todos os servidores MCP que o Claude Code usa no seu workspace, onde cada um se aplica e se está funcionando.
Onde um servidor se aplica
| Onde | Significado |
|---|---|
| Todas as sessões | disponível em todos os tópicos (uma ferramenta que você usa em qualquer lugar) |
um tópico (acme / ads) |
somente nas sessões desse tópico - a escolha mais comum: a conta de anúncios no tópico ads, não nos outros |
Clique em um tópico para abri-lo. Quando um tópico é renomeado, seus servidores o acompanham; um tópico excluído deixa seus servidores em Erro (remova-os).
Estados
| Estado | O que fazer |
|---|---|
| Conectado | nada, o Claude já tem as ferramentas |
| A conectar | o serviço precisa de um login: clique em Conectar (veja abaixo) |
| Erro | passe o mouse por cima para ver o motivo (endereço errado, programa ausente, chave recusada...) |
| A aprovar | um arquivo .mcp.json encontrado na pasta de um projeto em que o Claude Code ainda não confia |
| Não verificado | clique em Verificar |
Os estados são verificados em segundo plano quando você abre a página e com Verificar (alguns segundos por tópico).
Adicionar um servidor
O mais simples: peça ao Claude no tópico que precisa dele - "conecte o MCP do <serviço>, aqui está o endereço". Ou use Adicionar um servidor:
- Nome: curto, com letras, números e
-(ex.:google-ads). - Onde: todas as sessões ou um tópico.
- Endereço (URL) fornecido pelo serviço (muitas vezes terminando em
/mcp), ou Programa local: o comando que o inicia (ex.:npx -y @acme/mcp-server). - Cabeçalhos (endereço) ou variáveis de ambiente (programa), somente quando o serviço pede uma chave. Nunca cole a chave em si: guarde-a em Settings -> Chaves e escreva
${KEY_NAME}(o botão de chave a insere). As chaves usadas dessa forma são entregues às sessões automaticamente. Um valor escrito em texto puro (um token, uma senha) exibe um aviso de token em texto puro e fica oculto como•••na lista, assim como uma senha e os valores de consulta de um endereço (?key=•••); somente as referências${KEY_NAME}e cabeçalhos inofensivos comoContent-Typecontinuam legíveis.
O servidor fica disponível a partir da próxima mensagem de uma sessão.
Conectar (login)
Muitos serviços (estado A conectar) usam um login em vez de uma chave:
- Clique em Conectar e depois em Abrir a página de login.
- Faça login no serviço e aceite.
- O navegador então mostra "Não é possível acessar este site" em
localhost: isso é esperado. O serviço envia você de volta para um endereço que só existe no servidor do Harness; o código de conexão está nesse endereço. Copie o endereço inteiro da barra de endereços (ele contémcode=). - De volta ao Harness, cole-o (botão Colar, ou Ctrl+V) e clique em Concluir.
Faça isso em poucos minutos: o código expira (nesse caso, clique em Tentar novamente). Isso funciona qualquer que seja o acesso ao Harness (domínio ou Tailscale): o Claude Code, no servidor, conclui a conexão com o código que você colou.
A conexão é mantida para todas as sessões (o Claude Code a renova sozinho). Feito uma única vez por servidor.
Remover
... -> Remover. As chaves do cofre permanecem.
Navegador do meu PC
Settings -> MCP -> Navegador do meu PC permite que o Claude use um navegador no seu próprio computador (Windows, Mac ou Linux): abrir um site em que você está logado, preencher um formulário, ler uma página, tirar uma captura de tela... Ele usa um perfil separado do seu navegador (Brave, Chrome, Edge, Vivaldi, Opera ou Chromium): suas abas, senhas e histórico habituais nunca são tocados. Faça login uma vez nos sites de que o Claude precisa, na janela que ele abrir. (O cartão aparece quando o Harness PC pode ser baixado do seu servidor.)
- Escolha seu computador e seu navegador (o Harness os adivinha a partir do navegador que você está usando) e depois Obter o Harness PC.
- Baixe o Harness PC (já vinculado a este servidor, válido por 15 minutos) e abra-o - ou cole o comando exibido no PowerShell / em um terminal. No Windows, o SmartScreen pode dizer "O Windows protegeu seu computador": Mais informações -> Executar assim mesmo (o Harness PC ainda não é assinado por um editor). Ele não precisa de direitos de administrador.
- O cartão então pergunta "
<seu PC>quer se conectar", com o endereço de onde ele se conectou: clique em Sim, é o meu PC. Até lá, nada chega a esse computador - se você não reconhecer o nome (alguém usou seu link de download), clique em Recusar: ele é desconectado e esquece o seu servidor. Todas as sessões podem então usar as ferramentas de navegador (harness-pc).
Somente enquanto o Claude o usa. O Harness PC fica esperando em segundo plano (sem janela, quase sem uso de CPU ou memória) e abre a janela do navegador na primeira ação de navegador do Claude; após 10 minutos sem nenhuma (Settings: 5 a 60 min), o navegador e suas ferramentas são encerrados. Parar agora o fecha imediatamente. Quando o PC está desligado, em suspensão ou o Harness PC não está em execução, o Claude recebe a informação "o PC está offline" e segue em frente.
Iniciar com o computador (ativado por padrão) adiciona o Harness PC à inicialização da sua sessão (Windows: chave Run, Mac: item de login, Linux: arquivo de autostart), sem direitos de administrador. Desconectar o encerra e o remove da inicialização do PC; Apagar o perfil exclui os cookies e logins do perfil do Claude; Reinstalar / outro PC faz o pareamento novamente (um PC por vez). As últimas ações (ferramenta, página) são listadas no cartão.
Segurança: o Harness PC só se conecta para fora, ao seu Harness (nada escuta na sua rede); a porta de controle do navegador fica em 127.0.0.1 do PC e as páginas web não conseguem acessá-la. O próprio Harness PC verifica cada comando que repassa, de modo que nem mesmo um servidor sequestrado poderia usá-lo para acessar seus arquivos: só é possível abrir páginas web (http, https) - nada de file:, chrome: ou páginas de configurações, e o Claude não pode abrir endereços do seu PC ou da sua rede doméstica (localhost, 192.168.x.x, seu roteador, um NAS) -, os downloads não podem ser enviados para outra pasta, nenhum arquivo do PC pode ser entregue a uma página, e nenhuma permissão ou app pode ser instalado. O Claude não pode enviar arquivos do PC nem gravar a tela. A lista de ações recentes guarda os endereços sem a parte de consulta (os códigos de login não são guardados).
Backup e novo servidor
O backup da memória guarda a lista de servidores (valores que parecem segredos são apagados - tokens, senhas, nomes parecidos com API_KEY: use ${KEY_NAME} para eles, assim a restauração funciona sem ajustes; configurações simples como LOG_LEVEL=debug são mantidas); uma restauração adiciona de volta os que estiverem faltando. Os logins precisam ser refeitos em um novo servidor.
Em um terminal: maxxing mcp list|add|remove (veja a referência da CLI).