Conectar Claude Code con tu estudio

Qué es

Claude Code es Claude de Anthropic, que se ejecuta en la terminal de la computadora. Con el conector de IA, consulta los datos de tu estudio (ventas, clientes, agenda y finanzas) cuando haces una pregunta, con los permisos del usuario de la clave. Solo consulta información: no modifica nada en el sistema.

Cuándo usarlo

Ya usas Claude Code en la computadora y quieres consultar la actividad del estudio sin salir de la herramienta.
Quieres preparar un resumen o una hoja de cálculo con datos del sistema, usando instrucciones en lenguaje natural.

Antes de empezar

Ten a mano la dirección del conector, que puedes copiar siguiendo el artículo Conecta tu IA. Claude Code debe estar instalado en la computadora. Se conecta mediante el inicio de sesión del sistema; la clave de API es opcional, por si prefieres no iniciar sesión (por ejemplo, en una máquina sin navegador).

Paso a paso

Paso 1 — Agregar el conector

En la terminal, ejecuta el siguiente comando y reemplaza la dirección por la que copiaste en Copiar dirección:

claude mcp add --transport http heya https://seu-dominio/mcp

En Claude Code, escribe /mcp, elige heya y selecciona la opción para autenticarte. Se abrirá la pantalla de inicio de sesión del sistema en el navegador. Inicia sesión, elige la Empresa y haz clic en Autorizar.

Si prefieres usar una clave de API (creada con Permitir uso como conector de IA), agrega el encabezado al comando: --header "Authorization: Bearer hk_...".

Para usar el conector en todas las carpetas de la computadora, y no solo en la carpeta actual, agrega --scope user al comando.

Paso 2 — Comprobar la conexión

Ejecuta claude mcp list. El conector heya debería aparecer como conectado. Dentro de Claude Code, el comando /mcp muestra lo mismo.

Paso 3 — Hacer una pregunta

Abre Claude Code y pregunta, por ejemplo: «¿Cuánto vendí ayer en el estudio?». La primera vez, Claude puede pedirte que autorices el uso de las herramientas del conector.

Qué pasa después

Claude busca la consulta adecuada para la pregunta, la ejecuta y responde con los datos del sistema.
La clave aparece en la pestaña Clave de API y se actualiza el Último uso.
Para revocar el acceso, elimina la clave en la pestaña Clave de API: Claude Code perderá el acceso en un plazo de hasta 30 segundos.

Errores comunes y dudas

P: claude mcp list muestra “Failed to connect”. ¿Qué hago? R: Comprueba que la dirección termine en /mcp y que hayas pegado la clave completa, con Bearer y un espacio antes. El comando guarda la configuración sin probar la clave: el error solo aparece cuando Claude intenta conectarse.

P: Claude dice que la clave debe tener “Permitir uso como conector de IA”. ¿Por qué? R: La clave se creó sin esa opción. Edita la clave en la pestaña Clave de API y marca Permitir uso como conector de IA.

P: ¿Cómo cambio la clave? R: Elimina el conector con claude mcp remove heya y vuelve a agregarlo con la clave nueva.

P: ¿Puedo compartir la configuración con mi equipo a través del repositorio? R: No incluyas la clave en un archivo compartido (--scope project la guarda en .mcp.json). Cada persona debe usar su propia clave, con los permisos de su propio usuario.

P: Claude dijo que no encontró información que sí puedo ver en el sistema. ¿Por qué? R: El usuario de la clave no tiene acceso a esa pantalla, o la información queda fuera del conector por seguridad (conversaciones de WhatsApp, anamnesis, fotos y cuenta digital). Consulta el artículo Conector de IA.