4 formas de conectar HubSpot a Claude en 2026 (la forma fácil)

TL;DR

Para conectar HubSpot a Claude vía MCP: copia mcp.portermetrics.com/mcp, ve a Claude.ai, abre Conectores → Gestionar conectores → Añadir conector personalizado, pega la URL e inicia sesión. A partir de ahí, pregúntale a Claude lo que quieras sobre tus datos de HubSpot CRM en lenguaje sencillo.

Una vez conectado, puedes automatizar tus informes y análisis de HubSpot: haz preguntas sobre tus datos, crea dashboards, activa alertas o envía informes listos para el cliente como el que aparece abajo.

Requisitos previos

• Una cuenta de Porter Metrics con tu cuenta de HubSpot conectada (el plan gratuito es suficiente para probarlo de principio a fin)
• Una cuenta de Claude: el plan gratuito funciona para Claude Web; se necesita una suscripción Pro para Claude Code y las funciones MCP de escritorio
• Acceso de administrador o estándar a las cuentas de HubSpot que quieres conectar

Conectar HubSpot a Claude con MCP

Para este tutorial usaremos el método MCP. Aquí tienes una explicación rápida de qué es MCP y por qué es la mejor opción para HubSpot.

MCP (Model Context Protocol) es el estándar abierto que permite a herramientas de IA como Claude, ChatGPT, Claude Code y otras acceder y usar APIs externas: los mecanismos que hacen funcionar herramientas como HubSpot internamente. En lugar de crear una integración personalizada para cada herramienta de IA que uses, instalas un MCP y cada IA compatible accede a los mismos datos.

La configuración completa toma menos de 5 minutos y se divide en tres pasos: conectar HubSpot a Porter, apuntar Claude al MCP de Porter, y hacer tu primera pregunta.

1. Conecta tus datos de HubSpot a Porter

Porter se sitúa entre la API CRM de HubSpot y Claude. Gestiona OAuth, limitación de tasa, paginación y toda la infraestructura para que Claude solo vea datos limpios y estructurados.

Regístrate en Porter. Crea una cuenta gratuita en portermetrics.com. El plan gratuito es suficiente para ejecutar este flujo completo de principio a fin.

Conecta tu cuenta de HubSpot. En Porter, haz clic en Crear → selecciona Claude como destino → selecciona HubSpot como fuente → inicia sesión con HubSpot para conceder acceso a tus cuentas.

Selecciona tus cuentas. Elige las cuentas de HubSpot que quieres que Claude consulte. Cuando seleccionas varias cuentas bajo una sola conexión, Porter combina automáticamente sus datos para que puedas consultarlas como una sola.

Opcional: activa el almacenamiento en BigQuery si estás conectando varias cuentas con grandes volúmenes de datos. Esto mantiene las respuestas de Claude rápidas incluso a gran escala.

2. Conecta el MCP a Claude

La URL del MCP de Porter es lo que pegas en Claude. Una vez añadido, Claude puede consultar datos de HubSpot bajo demanda en cualquier conversación.

Ve a claude.ai y haz clic en el + icono en el campo de chat para abrir el menú de herramientas.

En el menú que se abre, pasa el cursor sobre Conectores y haz clic en Gestionar conectores.

En el panel de Conectores, haz clic en el + botón en la parte superior de la lista para empezar a añadir un nuevo conector.

Elige Añadir conector personalizado del desplegable que aparece.

Se abre un diálogo con los campos de nombre y URL. Escribe Porter en el primer campo para nombrar el conector.

En el segundo campo, pega https://mcp.portermetrics.com/mcp. No toques la configuración avanzada.

Haz clic en Añadir en la parte inferior derecha del diálogo. Claude abre una ventana de inicio de sesión: usa la misma cuenta de Google vinculada a tu espacio de trabajo de Porter y aprueba el acceso.

Una vez que termine la autorización, verás las herramientas de solo lectura de Porter aparecer en el panel de conectores. Estás listo para empezar a hacer preguntas.

Para un tutorial más completo con capturas de pantalla en cada paso, consulta el tutorial de Porter MCP.

3. Empieza a crear preguntas y dashboards

Con Porter conectado, abre un nuevo chat de Claude y pregunta lo que quieras sobre tu HubSpot en lenguaje sencillo. Claude llama a Porter en segundo plano, extrae datos en vivo de HubSpot y responde con tablas, gráficos o resúmenes.

Prueba una de estas para verificar que la configuración funciona:

Para un catálogo completo de prompts listos para copiar y pegar organizados por caso de uso (agencias, marketers B2B, equipos de ventas, multicanal), salta a la sección de prompts de abajo.

Otras formas de conectar HubSpot a Claude

MCP es el camino que acabamos de recorrer, y el que recomendamos para la mayoría de marketers. Pero no es la única forma de poner datos de HubSpot frente a Claude. Las alternativas más comunes son la API directa de HubSpot (o su MCP oficial si tiene uno), un puente con Google Sheets en vivo, y BigQuery para escalar. Cada una tiene sus pros y contras: elige la que se adapte a cómo trabaja tu equipo.

• 🔌 API directa de HubSpot (o MCP oficial) — Habla directamente con la CRM API tú mismo, o instala el MCP oficial de HubSpot si existe. Control máximo, pero tú gestionas la autenticación, los límites de tasa y la paginación, y solo obtienes una fuente.
• 📊 Google Sheets — Hoja en vivo o carga de CSV puntual. Auditable, familiar, más rápido para grandes exportaciones, pero la agregación ocurre en la Hoja, no en la API.
• 🗄️ Google BigQuery — Para cuentas grandes o agencias que ejecutan análisis multicuenta. BigQuery agrega; Claude solo consulta resúmenes preconstruidos.

Vía la API directa de HubSpot (o MCP oficial)

Si estás construyendo un producto alrededor de HubSpot, o eres un desarrollador que prefiere controlar cada capa de la integración, el camino más directo es hablar directamente con la CRM API tú mismo, o instalar el MCP oficial de HubSpot. HubSpot ofrece tanto un Conector Nativo oficial para Claude como un Servidor MCP oficial. El Conector Nativo es el camino más fácil para la mayoría de usuarios; el Servidor MCP da a los desarrolladores más control. Deberás seguir los límites de tasa y cuotas y solicitar un Token de Desarrollador / acceso a la API cuando corresponda. De cualquier forma, omites Porter por completo y llamas a HubSpot desde tu propio código o desde Claude Code con peticiones HTTP en bruto.

Vía Google Sheets (Hoja en vivo o CSV manual)

Si tu equipo ya vive en Google Sheets, o quieres un rastro de auditoría antes de que Claude toque nada, alimenta HubSpot en una Hoja y luego deja que Claude lea la Hoja. Puedes automatizar el pipeline de HubSpot → Sheets con Porter para que se refresque diariamente, o hacer exportaciones CSV puntuales desde la UI nativa de HubSpot para análisis estático.

Lee el tutorial completo de Sheets →

Vía Google BigQuery (para escalar)

Este es el camino que la mayoría de la gente pasa por alto, y es el que te salva cuando tu cuenta de HubSpot se pone seria. Un solo usuario grande o una agencia que gestiona más de 10 cuentas alcanzará los límites de tasa de la API y problemas de latencia al consultar Claude directamente. Claude literalmente te dirá que está tardando demasiado o que se agota el tiempo en extracciones grandes.

BigQuery soluciona eso. Cargas datos de HubSpot en tablas de BigQuery de forma programada, luego conectas BigQuery a Claude, ya sea a través de un MCP de BigQuery o vía Claude Code con consultas SQL. En lugar de pedirle a Claude que extraiga datos en bruto de HubSpot, dejas que BigQuery agregue en tablas pequeñas y optimizadas, y Claude solo consulta el resultado resumido. Problema de escala resuelto.

Lee el tutorial completo de BigQuery →

Conectar HubSpot a Claude Code

La mayoría de los marketers agrupan a Claude y Claude Code juntos y pasan por alto la mayor ventaja de todo el ecosistema MCP. No son la misma herramienta, y la diferencia importa enormemente una vez que empiezas a trabajar seriamente con datos de HubSpot.

Claude es una interfaz de chat. Haces una pregunta, Claude extrae datos en vivo a través del MCP, responde, tal vez crea un dashboard rápido dentro de la conversación. Genial para análisis puntuales. El problema: todo es efímero. ¿Quieres refrescar el dashboard mañana? Lo regeneras desde cero. ¿Quieres el mismo informe cada lunes? Vuelves a hacer la pregunta cada lunes.

Claude Code es Claude ejecutándose dentro de la terminal de tu computadora. Como tiene acceso a tu sistema de archivos, tiempo de ejecución y otras herramientas de desarrollo, no solo responde preguntas: puede construir software real. Scripts persistentes, rutinas programadas, aplicaciones HTML, dashboards internos, integraciones que funcionan 24/7 sin tu intervención. Una vez conectado al MCP de Porter para HubSpot, toda una categoría de trabajo se vuelve posible.

Lo que Claude Code desbloquea que Claude solo no puede

Aquí es donde el ecosistema MCP rinde más frutos. Como Claude Code puede combinar el MCP de Porter con otros MCPs — Firecrawl para web scraping, Airtable para datos estructurados, Notion para wikis, Vercel para despliegue, Slack y Gmail para entrega — ya no estás consultando datos. Estás construyendo herramientas.

🛠️ Crea tu propio dashboard de CRM

Stack: Porter MCP + Vercel MCP (o Cloudflare Pages, Netlify)

Alimenta a Claude Code con tus objetivos de pipeline de HubSpot, valores de deals y tasas de cierre, y pídele que genere un dashboard de pipeline personalizado para cada cliente. Construye el HTML, extrae datos en vivo, despliega en una URL. Sin incrustaciones de hojas de cálculo estáticas que se rompan cuando el proveedor cambia precios, sin restricciones de plantilla. El dashboard se actualiza automáticamente porque consulta el MCP de Porter en cada carga de página.

Ideal para: agencias que quieren dashboards de clientes white-label sin depender de Looker o Data Studio.

🔍 Monitoreo completo de competidores + rendimiento

Stack: Porter MCP + Firecrawl MCP

Combina tu propio rendimiento de HubSpot desde Porter con estrategias de CRM de competidores y posicionamiento de mercado extraídos vía Firecrawl. Claude Code une ambos en un informe semanal de inteligencia competitiva: tus números junto a su velocidad de pipeline y tamaños de deals, con un resumen de LLM sobre lo que cambió semana a semana. Funciona con cron, llega a tu bandeja de entrada cada lunes por la mañana.

Ideal para: equipos internos que necesitan contexto de mercado, no solo números internos.

📚 Wiki interna de marketing con métricas en vivo

Stack: Porter MCP + Airtable MCP (o Notion MCP)

Usa Airtable o Notion como esquema, Porter como fuente de datos. Claude Code mantiene cada página poblada con el deal amount actual, deal probability y contact lifecycle stage para cada cuenta: sin capturas de pantalla obsoletas, sin copiar y pegar de Excel. Los nuevos empleados leen una entrada de la wiki y tienen contexto completo sobre la cuenta de un cliente.

Ideal para: agencias y equipos de operaciones que incorporan analistas o rotan managers de cuenta frecuentemente.

🔔 Alertas 24/7 sobre salud del pipeline, estancamiento de deals e inactividad de contacts

Stack: Porter MCP + Slack MCP (o Gmail MCP)

Una rutina de Claude Code con cron extrae HubSpot vía Porter, evalúa umbrales: deal probability cae por debajo del 20%, sin actividad en deals de alto valor durante más de 14 días, y envía alertas de Slack o Gmail en el momento en que algo cruza la línea. Dejas de revisar dashboards reactivamente; el dashboard se revisa a sí mismo y te dice cuándo mirar.

Ideal para: cualquier equipo que haya descubierto un problema 48 horas tarde porque nadie abrió el informe.

Conclusión: Claude es para preguntas rápidas y dashboards ad hoc. Claude Code es para construir aplicaciones, dashboards en vivo, alertas y herramientas reales: cualquier cosa que quieras ejecutar por sí sola sin volver a preguntar. La misma URL del MCP de Porter funciona en ambos, así que no eliges una vez y te quedas atado.

Casos de uso: qué puedes hacer realmente una vez que HubSpot está conectado a Claude

Conseguir la conexión correcta es la mitad de la batalla. El valor real aparece en lo que haces después. Aquí están los casos de uso que los usuarios de Porter construyen alrededor de sus datos de HubSpot: desde preguntas y respuestas simples hasta flujos de trabajo completos orientados al cliente.

1. Chatea y haz preguntas directamente

El caso de uso más simple, y aún así el con el que empieza el 80% de los marketers. Abre Claude, haz una pregunta, obtén una respuesta basada en datos en vivo.

Es la forma más rápida de sustituir la revisión diaria del dashboard de HubSpot. Pero el chat es solo el principio: los casos de uso interesantes vienen después.

2. Combina HubSpot con tus datos de ingresos (Meta Ads, Google Ads, LinkedIn Ads)

Aquí es donde una visión 360° se vuelve real. Cuando conectas HubSpot y tu fuente de ingresos (Meta Ads para generación de leads, Google Ads para búsqueda pagada, LinkedIn Ads para prospección B2B), Claude puede mapear deals y contacts a deals cerrados ganados reales, usando contact source, nombres de campaña y timestamps, y darte una atribución que ningún número de la plataforma puede ofrecer.

Claude gestiona el contact source, los nombres de campaña y el mapeo y uniones de timestamps. Obtienes un informe de atribución listo para el cliente que ninguna plataforma individual puede generar por sí sola.

3. Alertas y notificaciones automatizadas en Slack o Gmail

Con Claude Code puedes convertir el monitoreo de HubSpot en una rutina que funciona por sí sola. Conecta el MCP de Porter (para los datos) junto con un MCP de Slack o Gmail (para la entrega), luego escribe una tarea programada de Claude Code que extrae el rendimiento cada mañana y te notifica solo cuando algo realmente necesita atención.

Sin dashboards, sin revisiones diarias. El informe viene a ti, y solo cuando importa.

4. Presentaciones listas para el cliente con datos en vivo (Gamma, HTML, PDF)

Un dolor común de agencias: envías a los clientes un informe estático de HubSpot cuyas exportaciones se rompen cuando cambian los filtros, y pasas una hora explicando un dashboard roto. Con Claude puedes construir la presentación misma, como un deck de Gamma, una página HTML personalizada o un PDF, poblada con números en vivo cada vez.

La presentación se convierte en un artefacto de entrega que envías al cliente, no en un dashboard que depende de que otra herramienta siga funcionando. Sin iframe roto, sin solicitudes de inicio de sesión, solo el contenido.

Campos y métricas de HubSpot que puedes consultar con Claude

Antes de empezar a escribir prompts, ayuda saber qué datos están realmente disponibles. El MCP de Porter le da a Claude acceso a 510 campos y métricas de HubSpot en todos los niveles de informe, más desgloses por contact, company, deal y dimensiones de engagement. Y la misma URL de MCP también desbloquea más de 25 fuentes adicionales, así que Claude puede combinar HubSpot con Google Ads, GA4, Shopify y más en un solo prompt.

Ver Todos los campos y métricas de HubSpot para la referencia completa.

Prompts que puedes copiar y pegar hoy

1. Para agencias

Úsalos cuando gestiones múltiples cuentas de HubSpot de clientes o construyas informes white-label.

2. Para marketers B2B

Úsalos para rendimiento de campañas, nutrición de leads y análisis de funnel.

3. Para equipos de ventas

Úsalos para salud del pipeline, previsión de deals y seguimiento de actividades de ventas.

4. Multicanal

Úsalos cuando HubSpot esté conectado junto con otras fuentes de datos a través del MCP de Porter.

Límites, autenticación y mejores prácticas para HubSpot vía Claude

Este es el patrón de “historia de terror” más común para usuarios de la API de HubSpot: no prohibiciones, sino fallos parciales silenciosos a escala. Como HubSpot devuelve errores HTTP 429 (throttle) en lugar de detener todo el pipeline, los trabajos ETL y scripts de automatización a menudo continúan con datos incompletos. Un marketer que ejecuta un enriquecimiento masivo de contacts vía Claude MCP y no verifica los códigos de respuesta puede terminar con un CRM donde el 40% de los registros tienen lifecycle stages actualizados y el 60% no, haciendo que la segmentación y los informes sean poco confiables. El costo no es la suspensión de la cuenta; es decisiones tomadas con datos sucios.

La aplicación de límites de tasa de HubSpot es basada en cuotas y ventana móvil, no basada en herramientas. HubSpot no prohíbe ni suspende cuentas porque usaste Claude, un servidor MCP o una integración de terceros. Limita las peticiones debido a cómo se usó la API: exceder los límites de ráfaga (peticiones por ventana de 10 segundos), exceder las cuotas diarias (totales móviles de 24 horas), o alcanzar límites por endpoint como el límite de 4 peticiones/segundo de la Search API. El uso de solo lectura dentro de la cuota de tu plan es seguro. Las escrituras paralelas en ráfaga, operaciones masivas sin lotes y claves de API sin alcance no lo son. Cuando se alcanza un límite, HubSpot devuelve HTTP 429 con un Retry-After header; las peticiones se reanudan automáticamente una vez que la ventana móvil se recarga. No hay un sistema permanente de “strikes” ni penalización a nivel de cuenta.

Qué sale realmente mal al escalar HubSpot vía Claude

Después de revisar documentación oficial y hilos de la comunidad, dos patrones aparecen una y otra vez.

1. Ráfagas de API paralelas y escrituras masivas sin lotes. Enviar peticiones concurrentes o payloads grandes sin lotes viola los límites de ráfaga de token-bucket de HubSpot (100 peticiones por 10 segundos en Free/Starter, 190 en Professional, 200 en Enterprise). Cuando se excede, HubSpot devuelve HTTP 429 y bloquea más peticiones hasta que el bucket se recarga. Si tu herramienta Claude MCP o script de automatización no gestiona los 429 con retroceso exponencial, el pipeline continúa con datos parciales, creando un CRM inconsistente. Documentación oficial: HubSpot API Usage Limits vía Reform.app rate limit guide. Qué hacer en su lugar: agrupa escrituras en lotes de máximo 100 registros por petición e implementa retroceso exponencial empezando en 1 segundo, duplicando hasta 16 segundos.

2. Exponer claves de API o tokens de acceso en entornos compartidos. Una auditoría de seguridad de 2024 encontró que los datos de 1.6 millones de usuarios de HubSpot fueron comprometidos a través de claves de API expuestas en repositorios públicos, extensiones de navegador y configuraciones compartidas de Claude Desktop. A diferencia de los Conectores Nativos basados en OAuth (que usan tokens con alcance y rotación), las configuraciones de Servidor MCP y Private Apps dependen de tokens de acceso estáticos que pueden filtrarse en archivos de configuración JSON, gists de GitHub o configuraciones compartidas de Claude Desktop en equipo. Fuente: BeVigil security research. Qué hacer en su lugar: usa el Conector Nativo OAuth cuando sea posible; si usas Servidor MCP, almacena los tokens en variables de entorno o un gestor de secretos, nunca en archivos JSON confirmados.

3. Alcances sobreprivilegiados e ignorar omisiones de validación. El Conector Nativo de HubSpot para Claude solicita alcances amplios de lectura/escritura en la configuración. Si se configuró antes del 20 de noviembre de 2025, puede carecer de permisos de escritura y requerir una desconexión/reconexión completa para habilitar la creación de registros: una interrupción que rompe flujos de trabajo automatizados. Más críticamente, las reglas de validación personalizadas configuradas en HubSpot NO se aplican al crear o actualizar registros vía la API o el conector, lo que significa que Claude puede escribir datos que violan las propias reglas de calidad de datos de tu CRM (p. ej., formatos de email inválidos, campos obligatorios faltantes, nombres de empresa duplicados). Fuente: HubSpot Knowledge Base — Best Practices y developers.hubspot.com/mcp. Qué hacer en su lugar: audita los alcances después de la configuración, reconecta si faltan permisos de escritura, y ejecuta informes de validación en la UI de HubSpot después de cualquier actualización masiva iniciada por Claude.

Ambos comportamientos desencadenan limitación basada en cuotas y degradación de calidad de datos. Si quieres usar Claude para HubSpot de forma segura, usa el MCP gestionado de Porter que gestiona lotes, retroceso y rotación OAuth automáticamente.

El protocolo de 5 reglas de mejores prácticas

Basado en los límites de tasa y cuotas documentados de HubSpot y los comportamientos que realmente han causado fallos parciales silenciosos, no en conjeturas:

• Mantente por debajo del límite de ráfaga de tu plan. Las cuentas Free y Starter de HubSpot están limitadas a 100 peticiones a la API por ventana de 10 segundos; Professional a 190; Enterprise a 200. Exceder esto desencadena HTTP 429 y pausa tu pipeline. NEEDS_REVIEW: límite exacto de ráfaga Enterprise: fuentes contradictorias citan 200 vs 250 . Consecuencia si se ignora: la limitación a mitad de sincronización deja tu CRM en un estado parcialmente actualizado. Aplicación de Porter: El MCP de Porter agrupa todas las peticiones de HubSpot y aplica automáticamente el ritmo de tasa por ventana de 10 segundos.

• Agrupa operaciones masivas en lotes de 100 registros por petición. Los endpoints masivos de HubSpot aceptan hasta 100 registros por lote. El Conector Nativo para Claude tiene un límite más estricto de 10 registros máximo por operación de crear/actualizar. Enviar payloads más grandes resulta en registros rechazados o transacciones divididas. Fuente: HubSpot Knowledge Base (tabla de Conector Nativo) y HubSpot API docs. Consecuencia si se ignora: los registros fallan en silencio o requieren reingreso manual. Aplicación de Porter: Porter divide las peticiones masivas en lotes de 100 registros y muestra los registros fallidos en la respuesta.

• Implementa retroceso exponencial en errores 429. Cuando HubSpot limita, devuelve HTTP 429 con un Retry-After header. La mejor práctica es esperar 1 segundo en el primer 429, luego duplicar el tiempo de espera (2s, 4s, 8s, 16s) hasta un máximo de 16 segundos antes de reintentar. Fuente: HubSpot Developer Docs vía Consultevo rate limit guide. Consecuencia si se ignora: reintentar inmediatamente extiende la ventana de limitación y puede agravar estados de fallo parcial. Aplicación de Porter: El MCP de Porter incluye retroceso exponencial automático con jitter en todas las respuestas 429.

• Monitorea tu cuota diaria, no solo los límites de ráfaga. Las cuentas Free/Starter tienen una cuota móvil de 250,000 peticiones en 24 horas; Professional 650,000; Enterprise 1,000,000; Public apps 500,000. Una sincronización histórica grande o un backfill pueden consumir toda la cuota diaria al mediodía, dejando las automatizaciones de la tarde paradas. Fuente: Reform.app rate limit guide y Consultevo guide. Consecuencia si se ignora: los flujos de trabajo programados (envíos de email, puntuación de leads, refrescos de informes) fallan durante horas. Aplicación de Porter: Porter rastrea el consumo de cuota diaria por cuenta y advierte cuando se alcanza el 80%.

• Nunca confirmes tokens de API en archivos o repositorios compartidos. Los tokens de Private App de HubSpot y las claves de API heredadas son credenciales estáticas. Una auditoría de 2024 encontró datos de 1.6 millones de usuarios expuestos a través de claves filtradas en repositorios de código públicos. Si usas el camino de Servidor MCP con Claude Desktop, almacena el accessToken en variables de entorno o un gestor de secretos, nunca en claude_desktop_config.json que se comparte vía Slack, Notion o GitHub. Fuente: BeVigil security research. Consecuencia si se ignora: acceso no autorizado a todo tu CRM, incluyendo contacts, deals, datos de ingresos e historial de engagement. Aplicación de Porter: El MCP gestionado de Porter usa rotación de tokens OAuth y nunca expone credenciales estáticas a los usuarios finales.

Qué hace diferente el MCP de Porter: aplica estos límites y salvaguardas a nivel de plataforma. El MCP de HubSpot de Porter agrupa peticiones en lotes compatibles con HubSpot (máximo 100 registros por lote), aplica ritmo de ráfaga por plan (100/190/200 por 10s), implementa retroceso exponencial automático con jitter en respuestas 429, y rastrea el consumo de cuota diaria en todas las cuentas conectadas. A diferencia de los servidores MCP autoalojados donde la lógica de límite de tasa es responsabilidad del usuario, Porter gestiona la rotación de tokens vía OAuth (sin claves estáticas en archivos JSON), minimiza los alcances a solo lectura por defecto, y muestra advertencias de validación cuando las reglas personalizadas de HubSpot serían omitidas. Ese es el comportamiento que los sistemas automatizados de HubSpot gestionan con elegancia: sin limitación, sin sincronizaciones parciales, sin credenciales expuestas.

Preguntas frecuentes