Docs

Conecte o Claude Code ao TabRunner e tire as dúvidas mais comuns.

Conectar o Claude Code (MCP)

O MCP deixa o Claude Code passar uma tarefa para o TabRunner. Ele faz o trabalho no seu navegador, com as suas contas logadas. Estes passos são para o Claude Code.

Ative a ponte. No TabRunner, abra Configurações → MCP e ative a opção. Ela vem desligada.
2
Baixe o daemon. É um arquivo só, e o bun roda esse arquivo do jeito que está. Se você ainda não tem o bun, instale antes.
```
curl -fsSL https://github.com/tabrunner/tabrunner/releases/latest/download/tabrunner-latest-mcp.js -o ~/.tabrunner-mcp.js
```
3
Adicione ao Claude Code. Com --scope user, ele funciona em qualquer pasta. Sem isso, o Claude Code adiciona só para a pasta atual.
```
claude mcp add --scope user tabrunner -- bun ~/.tabrunner-mcp.js
```
Confira a conexão. Peça ao Claude Code para rodar a ferramenta health do TabRunner. Ela diz se a extensão está conectada e o que corrigir, se não estiver.

Todas as ferramentas, configurações e o modo de controle direto estão no manual completo do MCP.

Remover ou atualizar o servidor MCP

Para remover, rode:

claude mcp remove --scope user tabrunner

Isso só cancela o registro. O arquivo baixado continua no seu disco. Apague também, se quiser tirá-lo de lá:

rm ~/.tabrunner-mcp.js

Para atualizar o daemon, rode de novo o comando de download do passo 2. Mais nada muda.

O Claude Code não encontra o TabRunner em outra pasta

Sem --scope user, o Claude Code guarda o servidor só para a pasta onde você o adicionou. Adicione de novo, para todas as pastas:

claude mcp add --scope user tabrunner -- bun ~/.tabrunner-mcp.js

A cópia só dessa pasta pode ficar. Para removê-la, rode isto dentro dessa pasta:

claude mcp remove --scope local tabrunner

A ferramenta health diz que a extensão não está conectada

Confira, nesta ordem:

A ponte está ativada no TabRunner, em Configurações → MCP.
A porta é a mesma. Se você mudou a porta do daemon com TABRUNNER_BRIDGE_PORT, digite o mesmo número em Configurações → MCP. O padrão é 17836.
O navegador está aberto, com o TabRunner instalado e ativado.
O Claude Code lista o servidor. Rode claude mcp list. Se o tabrunner não aparecer, adicione de novo e abra uma nova sessão.

O daemon inicia junto com o Claude Code, então não há nada para deixar rodando.

Em quais navegadores ele funciona?

Navegadores Chromium de desktop: Chrome, Brave, Edge, Arc, Opera e Vivaldi. Firefox e Safari não têm a API de entrada confiável, então o TabRunner não consegue clicar e digitar de verdade neles.

Preciso de uma conta no TabRunner?

Não. Não existe conta no TabRunner nem plano gratuito. Você traz o modelo: entre com um plano do Claude, do ChatGPT ou do Kimi que você já paga, ou cole uma chave de API. Qualquer endpoint compatível com o formato da OpenAI ou da Anthropic também funciona.

Para onde vão os meus dados?

Para dois lugares: o site em que o agente está trabalhando e o provedor de IA que você configurou. Sua chave de API ou o seu login vai direto da extensão para esse provedor. Não existe servidor do TabRunner, nem telemetria, nem intermediário. As configurações e o histórico das conversas ficam no armazenamento do navegador, no seu dispositivo. Um servidor MCP ou um webhook só recebe dados se você adicionar. A política de privacidade tem os detalhes.

Ele paga, envia ou apaga sem perguntar?

Não. Você aprova o plano antes de qualquer coisa, e ações que pagam, enviam ou apagam voltam para a sua confirmação. Uma exceção: quando um cliente MCP clica nas páginas por conta própria (controle direto), é o cliente que precisa perguntar a você antes. A checagem do próprio TabRunner não entra nesse caminho.

Como paro uma execução?

Clique em Parar no painel lateral. Fechar a aba que ele está controlando também encerra a execução. Num cliente MCP, chame a ferramenta stop.

Como atualizo a extensão?

Pela Chrome Web Store, as atualizações chegam sozinhas. Se você instalou o ZIP, extraia cada versão nova por cima da mesma pasta e clique no ícone de recarregar em chrome://extensions. Nunca remova a extensão para reinstalar. O Chrome apaga o armazenamento dela, e seus provedores, logins e conversas vão junto.