Docs

Conectar Claude Code (MCP)

MCP permite que Claude Code le pase una tarea a TabRunner. TabRunner hace el trabajo en tu navegador, con tus sesiones iniciadas. Estos pasos son para Claude Code.

1. 1

   Activa el puente. En TabRunner, abre Configuración → MCP y activa la opción. Viene desactivada.

2. 2

   Descarga el daemon. Es un solo archivo, y bun lo ejecuta tal cual. Si todavía no tienes bun, instálalo antes.

   curl -fsSL https://github.com/tabrunner/tabrunner/releases/latest/download/tabrunner-latest-mcp.js -o ~/.tabrunner-mcp.js

   Copiar
3. 3

   Añádelo a Claude Code. Con --scope user funciona en cualquier carpeta. Sin eso, Claude Code lo añade solo para la carpeta actual.

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

   Copiar
4. 4

   Comprueba la conexión. Pídele a Claude Code que ejecute la herramienta health de TabRunner. Dice si la extensión está conectada y qué arreglar si no lo está.

Todas las herramientas, opciones y el modo de control directo están en el manual completo de MCP.

Quitar o actualizar el servidor MCP

Para quitarlo, ejecuta:

claude mcp remove --scope user tabrunner

Eso solo anula el registro. El archivo descargado sigue en tu disco. Bórralo también si quieres que desaparezca:

rm ~/.tabrunner-mcp.js

Para actualizar el daemon, vuelve a ejecutar el comando de descarga del paso 2. No cambia nada más.

Claude Code no encuentra TabRunner en otra carpeta

Sin --scope user, Claude Code guarda el servidor solo para la carpeta donde lo añadiste. Añádelo otra vez, para todas las carpetas:

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

La copia de esa carpeta puede quedarse. Para quitarla, ejecuta esto dentro de esa carpeta:

claude mcp remove --scope local tabrunner

La herramienta health dice que la extensión no está conectada

Revisa esto, en orden:

• El puente está activado en TabRunner, en Configuración → MCP.
• El puerto coincide. Si cambiaste el puerto del daemon con TABRUNNER_BRIDGE_PORT, escribe el mismo número en Configuración → MCP. El predeterminado es 17836.
• Tu navegador está abierto, con TabRunner instalado y activado.
• Claude Code muestra el servidor. Ejecuta claude mcp list. Si tabrunner no aparece, añádelo otra vez y abre una sesión nueva.

El daemon se inicia junto con Claude Code, así que no hay nada que dejar en marcha.

¿En qué navegadores funciona?

Navegadores Chromium de escritorio: Chrome, Brave, Edge, Arc, Opera y Vivaldi. Firefox y Safari no tienen la API de entrada confiable, así que TabRunner no puede hacer clic ni escribir de verdad en ellos.

¿Necesito una cuenta de TabRunner?

No. No hay cuenta de TabRunner ni plan gratuito. Tú pones el modelo: inicia sesión con un plan de Claude, ChatGPT o Kimi que ya pagas, o pega una clave de API. Cualquier endpoint compatible con el formato de OpenAI o de Anthropic también sirve.

¿A dónde van mis datos?

A dos sitios: la web en la que trabaja el agente y el proveedor de IA que configuraste. Tu clave de API o tu inicio de sesión va directo de la extensión a ese proveedor. No hay servidor de TabRunner, ni telemetría, ni intermediario. Tu configuración y el historial de conversaciones se quedan en el almacenamiento del navegador, en tu dispositivo. Un servidor MCP o un webhook solo recibe datos si lo añades tú. La política de privacidad da los detalles.

¿Paga, envía o borra sin preguntar?

No. Apruebas el plan antes de que pase nada, y las acciones que pagan, envían o borran vuelven a ti para que las confirmes. Una excepción: cuando un cliente MCP hace clic por las páginas por su cuenta (control directo), es el cliente quien tiene que preguntarte antes. La comprobación propia de TabRunner no interviene ahí.

¿Cómo detengo una ejecución?

Haz clic en Detener en el panel lateral. Cerrar la pestaña que controla también termina la ejecución. Desde un cliente MCP, llama a la herramienta stop.

¿Cómo actualizo la extensión?

Con la Chrome Web Store, las actualizaciones llegan solas. Si instalaste el ZIP, descomprime cada versión nueva sobre la misma carpeta y haz clic en el icono de recargar en chrome://extensions. Nunca quites la extensión para reinstalarla. Chrome borra su almacenamiento, y tus proveedores, sesiones y conversaciones se van con ella.