Jarvis com Claude Code: guia completo de instalação e MCP

O Jarvis é um assistente de voz que roda no navegador e usa o Claude Code como cérebro. Você diz “Hey Jarvis”, faz um pedido e recebe uma resposta por voz ou texto, dependendo da configuração.

A parte interessante é que o Claude Code pode usar as ferramentas MCP que já estão configuradas na sua máquina. Na prática, o Jarvis funciona como uma camada de voz sobre o agente: você fala, o Claude Code interpreta a solicitação e decide se precisa consultar alguma ferramenta MCP.

O cérebro roda em modo headless usando a sua assinatura do Claude Code. Por isso, a instalação apresentada pelo projeto não exige uma API key própria. O ElevenLabs aparece como opção para a síntese de voz, mas é opcional.

Em uma frase: Jarvis é uma interface de voz para conversar com o Claude Code e acionar os MCPs disponíveis no ambiente local.

O projeto é gratuito como software e está publicado sob a licença MIT. Isso não significa que todos os serviços usados por ele sejam gratuitos: o Claude Code depende da sua assinatura, e o ElevenLabs, caso você escolha usá-lo, é um serviço separado.

• Você precisa ter o repositório do Jarvis clonado localmente.
• A instalação usa Node.js e npm.
• O uso acontece no navegador Chrome.
• O Chrome precisa ter permissão para acessar o microfone.
• O Jarvis enxerga os servidores MCP configurados no arquivo ~/.claude.json.
• Os conectores disponíveis diretamente no claude.ai não são automaticamente os mesmos que aparecem no Claude Code.

O repositório informado no material original tinha 293 estrelas, e o último commit indicado era de 05/08/2026. Como o GitHub muda com o tempo, confira o estado atual do projeto antes de instalar.

Abra o terminal e clone o repositório oficial:

git clone https://github.com/adewaskar/jarvis.git

Entre na pasta criada e instale as dependências:

cd jarvis

npm install

Depois, inicie a aplicação:

npm start

O terminal deverá indicar que o servidor local foi iniciado. Abra no Chrome o endereço de localhost apresentado pelo projeto. Não é necessário inventar uma porta: use exatamente a URL exibida no seu terminal.

Resumo rápido:

1. Clone o repositório.
2. Execute npm install.
3. Execute npm start.
4. Abra o localhost no Chrome.

Com a página aberta no Chrome, procure a opção INITIALISE e clique nela. Em seguida, autorize o acesso ao microfone quando o navegador solicitar.

Faça um teste simples antes de tentar uma tarefa com ferramentas: diga “Hey Jarvis” e faça uma pergunta curta. O objetivo desse primeiro teste é confirmar três pontos: o navegador está captando o áudio, o Jarvis está reconhecendo a frase de ativação e o Claude Code está recebendo a solicitação.

Use este checklist:

• Página: o localhost está aberto no Chrome.
• Inicialização: você clicou em INITIALISE.
• Permissão: o microfone foi autorizado para a página.
• Teste: a frase “Hey Jarvis” foi reconhecida.
• Resposta: o agente retornou uma resposta.

Se o navegador não escutar, revise a permissão de microfone nas configurações do site e confirme se o microfone correto está selecionado no sistema operacional.

MCPs são a ponte entre o modelo e ferramentas externas ou locais. No Jarvis, o Claude Code usa os MCPs que já estão disponíveis na configuração local do ambiente.

O ponto central é o arquivo ~/.claude.json. Se um servidor MCP está configurado ali e o Claude Code consegue utilizá-lo, o Jarvis pode receber uma solicitação de voz que leve o agente a consultar esse servidor.

Exemplo de fluxo:

1. Você diz: “Hey Jarvis, consulte a ferramenta que uso para minhas tarefas e me diga o que está pendente.”
2. O navegador captura a voz.
3. O Claude Code interpreta a intenção.
4. O agente verifica quais ferramentas MCP estão disponíveis.
5. O MCP retorna os dados permitidos.
6. O Jarvis responde no navegador.

Esse fluxo é apenas um exemplo. O resultado depende dos MCPs realmente configurados e das permissões concedidas a eles.

Atenção: os conectores que aparecem no claude.ai não são automaticamente carregados pelo Claude Code. Para o Jarvis usá-los, eles precisam estar disponíveis na configuração local reconhecida pelo Claude Code.

O Jarvis começa em um modo mais seguro, voltado para leitura. Isso significa que consultas e tarefas de inspeção são o ponto de partida, enquanto ações que alteram dados ou executam mudanças reais exigem uma ativação adicional.

De acordo com o projeto, as ações de escrita são habilitadas com:

npm run bridge:writes

Não trate esse comando como um detalhe. Ativar escritas muda o nível de risco do assistente: uma solicitação de voz ambígua pode resultar em alterações caso as ferramentas disponíveis permitam esse tipo de ação.

Antes de habilitar o modo de escrita:

• Confira quais MCPs estão configurados no ~/.claude.json.
• Leia as permissões e a documentação de cada servidor.
• Teste primeiro consultas que não alteram nada.
• Evite usar o modo de escrita em ambientes de produção sem uma revisão humana.
• Não diga comandos vagos quando uma ação real estiver habilitada.

Regra prática: voz é conveniente, mas confirmação continua sendo necessária para ações irreversíveis.

O ElevenLabs pode ser usado como uma camada opcional para gerar a voz de resposta. Ele não é o cérebro do Jarvis e não substitui o Claude Code: sua função está relacionada à saída de áudio.

Você pode validar primeiro o funcionamento básico do projeto sem adicionar essa camada. A ordem recomendada é:

1. Instalar o repositório.
2. Confirmar que o localhost abre.
3. Inicializar a aplicação e liberar o microfone.
4. Testar a ativação “Hey Jarvis”.
5. Confirmar que o Claude Code responde.
6. Só depois avaliar se quer configurar uma voz com o ElevenLabs.

Assim, se algo der errado, fica mais fácil saber se o problema está no navegador, no áudio, no Claude Code ou na síntese de voz opcional.

Se o Jarvis não funcionar de primeira, separe o diagnóstico por camadas:

• O localhost não abre: confirme se o npm start continua rodando no terminal e use o endereço exibido por ele.
• O microfone não responde: revise a permissão do Chrome e o dispositivo de entrada selecionado.
• O assistente não encontra uma ferramenta: verifique se ela está configurada no ~/.claude.json, e não apenas no claude.ai.
• A ação não é executada: confirme se você está no modo de leitura e se a operação exige o comando npm run bridge:writes.
• A voz não está como esperado: valide primeiro a instalação sem o ElevenLabs e adicione a camada opcional depois.

Depois que o teste básico funcionar, escolha uma tarefa de leitura e faça uma solicitação específica. Evite começar com comandos que alterem arquivos, enviem mensagens ou executem ações externas.

Checklist final:

• Repositório oficial clonado.
• Dependências instaladas com npm install.
• Servidor iniciado com npm start.
• Chrome aberto no localhost.
• INITIALISE executado.
• Microfone autorizado.
• MCPs revisados no ~/.claude.json.
• Modo de leitura testado antes de qualquer escrita.