4 formas de conectar HubSpot a Claude en 2026 (fácil)
Porter Metrics+HubSpot+
Tutorial de HubSpot + IA · 2026

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

Aprende a conectar HubSpot a Claude mediante MCP en menos de 5 minutos. Descubre alternativas para Google Sheets, BigQuery y API directa. Sin código.

rocket_launch Pruébalo gratisPrueba gratuita de 14 días sin límite. Después, mantén consultas ilimitadas para hasta 3 portales y 30 días de datos históricos — no se requiere tarjeta de crédito.
Juan Bello

Juan Bello

Fundador, Porter Metrics · 4 de mayo de 2026 · 27 min de lectura

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 inglés sencillo.

Una vez conectado, puedes automatizar tu reporting 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 ves a continuación.

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 quieras conectar

Conectar HubSpot a Claude con MCP

En este tutorial vamos a usar 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: lo que hace que herramientas como HubSpot funcionen bajo el capó. En lugar de construir una integración personalizada para cada herramienta de IA que uses, instalas un MCP y todas las IA compatibles acceden a los mismos datos.

content_paste
Configuración copiar-pegar
Sin tokens, sin scripts, sin ayuda de un desarrollador: literalmente pega una URL en Claude y listo.
hub
Funciona con cualquier herramienta de IA
Claude, Claude Code, ChatGPT, Cursor, Antigravity, Lovable, Vercel v0, Zapier. Una URL de MCP, cada herramienta que habla el protocolo.
merge_type
20+ fuentes en una sola conexión
El MCP de Porter envía HubSpot más Google Ads, GA4, Shopify, HubSpot, Klaviyo, Google Sheets y 20+ más. Consulta y combínalas todas en una sola conversación.
tune
Granularidad perfecta
Las hojas de cálculo te encierran en las columnas que exportaste. MCP accede directamente a la API de HubSpot, así que puedes filtrar por etapa del ciclo de vida del contacto, desglosar por etapa del negocio o industria de la empresa, y añadir nuevas dimensiones sobre la marcha sin reconstruir tablas.

La configuración completa lleva 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, límites de tasa, paginación y toda la plomería 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 → elige Claude como destino → selecciona HubSpot como fuente → inicia sesión con HubSpot para dar acceso a tus cuentas.

Selecciona tus cuentas. Elige las cuentas de HubSpot que quieras 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 automático en BigQuery si conectas varias cuentas con grandes volúmenes de datos. Esto mantiene las respuestas de Claude rápidas incluso a 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.

src=”https://portermetrics.com/wp-content/uploads/2026/04/porter-mcp-claude-v2-step-1.webp” alt=”Haz clic en el icono + en el campo de chat de Claude”

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

src=”https://portermetrics.com/wp-content/uploads/2026/04/porter-mcp-claude-v2-step-2.webp” alt=”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.

src=”https://portermetrics.com/wp-content/uploads/2026/04/porter-mcp-claude-v2-step-3.webp” alt=”Haz clic en + en la parte superior del panel de Conectores”

Elige Añadir conector personalizado del desplegable que aparece.

src=”https://portermetrics.com/wp-content/uploads/2026/04/porter-mcp-claude-v2-step-4.webp” alt=”Selecciona Añadir conector personalizado del desplegable”

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

src=”https://portermetrics.com/wp-content/uploads/2026/04/porter-mcp-claude-v2-step-5.webp” alt=”Escribe Porter en el campo del nombre del conector”

En el segundo campo, pega https://mcp.portermetrics.com/mcp. Deja la configuración avanzada como está.

src=”https://portermetrics.com/wp-content/uploads/2026/04/porter-mcp-claude-v2-step-6.webp” alt=”Pega la URL del MCP de Porter en el campo de servidor MCP remoto”

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.

src=”https://portermetrics.com/wp-content/uploads/2026/04/porter-mcp-claude-v2-step-7.webp” alt=”Haz clic en Añadir en el diálogo del conector personalizado”

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

src=”https://portermetrics.com/wp-content/uploads/2026/04/porter-mcp-claude-v2-step-8.webp” alt=”Herramientas de solo lectura de Porter visibles en el panel de conectores de Claude”

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

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 inglés sencillo. Claude llama a Porter entre bambalinas, 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:

chat_bubble“Muéstrame mis 10 mejores negocios por Importe del negocio que cierren este trimestre.”
chat_bubble“Lista los contactos que no han sido contactados en 30 días y no tienen negocios abiertos.”
chat_bubble“Resume el rendimiento de mis correos de marketing del mes pasado.”

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

Otras formas de conectar HubSpot a Claude

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

  • 🔌 API directa de HubSpot (o MCP oficial) — Habla directamente con la CRM API de HubSpot, 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 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 multicliente. 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, la ruta más directa es hablar con la CRM API de HubSpot 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 la opción más sencilla para la mayoría de usuarios; el Servidor MCP da a los desarrolladores más control. Tendrás que seguir los límites de tasa y cuotas de HubSpot 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.

La contrapartida que debes conocer. Ir directo te da el máximo control y los datos más frescos posibles: cada endpoint, cada parámetro, sin capa de abstracción de por medio. Pero ahora eres responsable de los flujos OAuth, los tokens de refresco, los límites de tasa, la paginación, los cambios de esquema y los reintentos de errores. Y, críticamente, solo obtienes una fuente. En el momento en que también quieras Google Ads, GA4 o Shopify en la misma conversación, vuelves a construir (o a unir) más integraciones.
Cuándo tiene sentido: equipos de ingeniería que necesitan una única fuente con control total, productos que envían datos de HubSpot como una característica (donde ya posees la integración de todos modos), o scripts puntuales donde no te importa escribir tú mismo el código de autenticación y paginación. Para marketers que quieren hacer preguntas en inglés sencillo y combinar HubSpot con el resto de su stack en una sola conversación, la ruta del MCP de Porter es dramáticamente menos trabajo.

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

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

La contrapartida que debes conocer. Con la ruta MCP, Claude llama a la API de HubSpot directamente y HubSpot hace el filtrado y agregación por su lado: limpio y determinista. Con la ruta Sheets, Claude agrega dentro de la propia Hoja, lo que puede introducir alucinaciones en totales, promedios y uniones cuando tienes miles de filas. La ventaja es la velocidad: para rangos de fechas muy amplios o análisis histórico, una Hoja preconstruida es dramáticamente más rápida que llamadas a la API en vivo.
Cuándo tiene sentido: equipos de finanzas que quieren revisar los números antes de que Claude actúe sobre ellos, agencias que ya entregan informes de cliente en Sheets, análisis histórico a lo largo de años de datos, o cualquier caso donde la velocidad importe más que la frescura en tiempo real.

Lee el tutorial completo de Sheets →

Vía Google BigQuery (para escala)

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

BigQuery lo soluciona. Cargas los 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.

Cuándo tiene sentido: cuentas enterprise con miles de contactos y negocios, agencias que ejecutan análisis multicliente en más de 10 clientes, o cualquier equipo que ya use BigQuery como data warehouse. Porter carga HubSpot (y 25+ fuentes más) directamente en BigQuery para que no tengas que construir tu propio ETL.

Lee el tutorial completo de BigQuery →

Conectar HubSpot a Claude Code

La mayoría de los marketers agrupan a Claude y Claude Code como si fueran lo mismo y se pierden la ventaja más grande 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 construye un dashboard rápido dentro de la conversación. Ideal 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 del terminal de tu ordenador. Como tiene acceso a tu sistema de archivos, tiempo de ejecución y otras herramientas de desarrollador, 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 más se nota. 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.

🛠️ Construye tu propio dashboard de CRM

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

Dale a Claude Code tus objetivos de pipeline de HubSpot, valores de negocio 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 a una URL. Sin incrustaciones de hojas de cálculo estáticas que se rompan cuando el proveedor cambia los precios, sin restricciones de plantillas. El dashboard se actualiza automáticamente porque consulta el MCP de Porter en cada carga de página.

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

🔍 Monitorización completa de competidores + rendimiento

Stack: MCP de Porter + MCP de Firecrawl

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 negocio, con un resumen de LLM encima de 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 interno de marketing con métricas en vivo

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

Usa Airtable o Notion como esquema, y Porter como fuente de datos. Claude Code mantiene cada página poblada con el importe del negocio actual, la probabilidad del negocio y la etapa del ciclo de vida del contacto para cada cuenta: sin capturas de pantalla obsoletas, sin copiar y pegar desde Excel. Los nuevos empleados leen una entrada de la wiki y tienen el contexto completo de la cuenta de un cliente.

Ideal para: agencias y equipos de operaciones que incorporan analistas o rotan gestores de cuentas con frecuencia.

🔔 Alertas 24/7 sobre salud del pipeline, estancamiento de negocios e inactividad de contactos

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

Una rutina de Claude Code en cron extrae HubSpot vía Porter, evalúa umbrales — probabilidad del negocio por debajo del 20%, sin actividad en negocios de alto valor durante más de 14 días — y envía alertas a 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 avisa cuándo mirar.

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

Conclusión: Claude es para preguntas rápidas y dashboards puntuales. Claude Code es para construir aplicaciones, dashboards en vivo, alertas y herramientas reales: cualquier cosa que quieras que funcione por sí sola sin volver a preguntar. La misma URL del MCP de Porter funciona en ambos, así que no tienes que elegir una vez y quedarte con ella.

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

Configurar bien la conexión es la mitad de la batalla. El verdadero valor 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 sencillas hasta flujos de trabajo completos orientados al cliente.

1. Chatea y haz preguntas directamente

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

chat_bubble“Muéstrame mis 10 mejores negocios por Importe del negocio que cierren este trimestre.”
chat_bubble“Lista los contactos que no han sido contactados en 30 días y no tienen negocios abiertos.”
chat_bubble“Resume el rendimiento de mis correos de marketing del mes pasado.”

Es la forma más rápida de sustituir la revisión diaria del dashboard de HubSpot. Pero el chat es lo básico: los casos de uso interesantes vienen a continuación.

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 lead gen, Google Ads para búsqueda pagada, LinkedIn Ads para prospección B2B), Claude puede mapear negocios y contactos a negocios cerrados ganados reales: usando fuente del contacto, nombres de campaña y marcas de tiempo, y darte atribución que ningún número de plataforma puede ofrecer por sí solo.

chat_bubble“Cruza mi Fuente original del negocio de HubSpot con mis campañas de Google Ads del trimestre pasado. ¿Qué campañas generaron el mayor Importe del negocio ganado?”
chat_bubble“Empareja mis clientes de Shopify con contactos de HubSpot cuyo Ingreso total del contacto supere los 1.000 $ y la Fecha de cierre reciente del contacto sea de los últimos 30 días.”

Claude gestiona el mapeo de fuente del contacto, nombres de campaña y marcas de tiempo, y las uniones. 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 la monitorización de HubSpot en una rutina que funciona 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 avisa solo cuando algo realmente necesita atención.

chat_bubble“Alertame cuando mis Días para cerrar del negocio superen los 60 días para negocios donde Negocio cerrado ganado sea falso esta semana.”
chat_bubble“Marca mis negocios donde Número de actividades de ventas del negocio supere 10 y Última fecha de actividad del negocio tenga más de 14 días.”

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 las 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.

chat_bubble“Redacta un correo para el cliente resumiendo mis promedios de Puntuación de HubSpot del contacto por Etapa del ciclo de vida del contacto del mes pasado.”
chat_bubble“Explica por qué mi Importe del negocio bajó ayer con un desglose por Propietario del negocio y Pipeline del negocio.”

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 reporting, más desgloses por contacto, empresa, negocio y dimensiones de engagement. Y la misma URL de MCP también desbloquea 25+ fuentes más, así que Claude puede combinar HubSpot con Google Ads, GA4, Shopify y más en un solo prompt.

Niveles de reporting
Dirección postal del contactoRol de compra del contactoCiudad del contactoFecha de cierre del contactoPaís/región del contactoFecha de creación del contactoDías para cerrar del contactoCorreo electrónico del contactoDominio de correo del contactoFecha de la última reunión reservada en la herramienta de reuniones del contactoCampaña de la última reserva en la herramienta de reuniones del contactoMedio de la última reserva en la herramienta de reuniones del contactoFuente de la última reserva en la herramienta de reuniones del contactoNúmero de fax del contactoFecha de creación del primer negocio del contacto+307 más
Métricas de engagement
Correo de marketing abCuerpo del correo de marketingRebote del correo de marketingTotal de rebotes del correo de marketingRatio de rebote del correo de marketingID de campaña del correo de marketingNombre de campaña del correo de marketingUTM de campaña del correo de marketingClic del correo de marketingTotal de clics del correo de marketingRatio de clic del correo de marketingRatio de click-through del correo de marketingContactos perdidos del correo de marketingTotal de contactos perdidos del correo de marketingRatio de contactos perdidos del correo de marketing+105 más
Métricas de conversión
ID de clic de Facebook del contactoFecha de primera conversión del contactoPrimera conversión del contactoID de clic de Google Ads del contactoCiudad IP del contactoPaís IP del contactoCódigo de país IP del contactoEstado/región IP del contactoCódigo de estado/región IP del contactoZona horaria IP del contactoNúmero de formularios únicos enviados del contactoFecha de conversión reciente del contactoConversión reciente del contactoFecha de primera conversión de la empresaPrimera conversión de la empresa+8 más
Desgloses de audiencia
FechaDía del mesDía de la semana (lun – dom)Hora del díaMesTrimestreSemanaAñoMes y añoTrimestre y añoSemana y año
Fuentes multicanal (misma URL)
Google AdsGoogle Analytics 4ShopifyHubSpotTikTok AdsLinkedIn AdsInstagramMailchimpKlaviyoActiveCampaignGoogle SheetsGoogle Search ConsoleGoogle Business ProfileFacebook InsightsFacebook Public Data+11 más

Consulta 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.

chat_bubble“Lista mis 10 mejores negocios por Importe del negocio donde Categoría de previsión del negocio sea Commit este trimestre, en una tabla.”
chat_bubble“Muestra mis contactos donde Número de negocios asociados del contacto sea cero y Última fecha de actividad del contacto tenga más de 30 días, en una lista.”
chat_bubble“Redacta un correo para el cliente resumiendo mis promedios de Puntuación de HubSpot del contacto por Etapa del ciclo de vida del contacto del mes pasado.”
chat_bubble“Explica por qué mi Importe del negocio bajó ayer con un desglose por Propietario del negocio y Pipeline del negocio.”

2. Para marketers B2B

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

chat_bubble“Muestra mis 5 peores correos de marketing por Ratio de clic del correo de marketing el mes pasado, en una lista ordenada.”
chat_bubble“Compara mis contactos Suscriptor con mis contactos Cliente en Ingreso total del contacto del trimestre pasado, en una tabla.”
chat_bubble“Lista mi Fuente original del contacto ordenada por mayor Tasa de lead a cliente y menor Promedio de páginas vistas del contacto este año.”
chat_bubble“Compara mi Número de formularios únicos enviados del contacto de este mes versus el mes pasado, por semana, en un gráfico.”

3. Para equipos de ventas

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

chat_bubble“Lista mis 10 mejores negocios por Probabilidad del negocio que cierren este mes, con Importe del negocio y Propietario del negocio, en una tabla.”
chat_bubble“Proyecta mi Importe previsto del negocio para el próximo trimestre basado en el Importe ponderado del negocio de los últimos 90 días, como tabla.”
chat_bubble“Alertame cuando mis Días para cerrar del negocio superen los 60 días para negocios donde Negocio cerrado ganado sea falso esta semana.”
chat_bubble“Marca mis negocios donde Número de actividades de ventas del negocio supere 10 y Última fecha de actividad del negocio tenga más de 14 días.”

4. Multicanal

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

chat_bubble“Cruza mi Fuente original del negocio de HubSpot con mis campañas de Google Ads del trimestre pasado. ¿Qué campañas generaron el mayor Importe del negocio ganado?”
chat_bubble“Empareja mis clientes de Shopify con contactos de HubSpot cuyo Ingreso total del contacto supere los 1.000 $ y la Fecha de cierre reciente del contacto sea de los últimos 30 días.”
chat_bubble“Lista mi Fuente original del contacto de Google Ads por mayor Ingreso total del contacto y menor Número de páginas vistas del contacto este mes.”
chat_bubble“Explica por qué mi Tasa de lead a cliente de HubSpot bajó la semana pasada con un desglose por Fuente original del contacto y Primera página vista del contacto.”

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

chat_bubble“Estábamos sincronizando 50K contactos cada noche vía la API. Una noche el trabajo alcanzó la cuota diaria y todo después del registro 12.847 simplemente… falló en silencio. Nuestro equipo de ventas pasó tres días llamando a leads obsoletos porque el campo ‘última fecha de actividad’ estaba medio actualizado.” — usuario reportado de la API de HubSpot, Foros de la Comunidad de HubSpot, 2025″

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. Porque 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 contactos vía MCP de Claude y no revisa los códigos de respuesta puede terminar con un CRM donde el 40% de los registros tienen etapas del ciclo de vida actualizadas y el 60% no, haciendo que la segmentación y el reporting sean poco fiables. El costo no es la suspensión de la cuenta; es decisiones tomadas sobre 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 los 4 peticiones/segundo de la Search API. El uso de solo lectura dentro de la cuota de tu nivel es seguro. Las escrituras paralelas en ráfaga, operaciones masivas sin lotes y claves de API sin ámbito no lo son. Cuando se alcanza un límite, HubSpot devuelve HTTP 429 con un Retry-After encabezado; las peticiones se reanudan automáticamente una vez que la ventana móvil se recarga. No hay sistema de ‘strikes’ permanente ni penalización a nivel de cuenta.

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

Tras revisar documentación oficial e hilos de la comunidad, dos patrones aparecen una y otra vez.

1. Ráfagas paralelas de API y escrituras masivas sin lotes. Enviar peticiones concurrentes o cargas masivas grandes sin lotes viola los límites de ráfaga de tipo 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 MCP de Claude o script de automatización no maneja 429s con retroceso exponencial, el pipeline continúa con datos parciales: creando un CRM inconsistente. Documentación oficial: Límites de uso de la API de HubSpot vía Guía de límites de tasa de Reform.app. 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 1,6 millones de datos 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 rotativos con ámbito), las configuraciones de Servidor MCP y Apps Privadas dependen de tokens de acceso estáticos que pueden filtrarse en archivos de configuración JSON, gists de GitHub o ajustes compartidos de Claude Desktop. Fuente: Investigación de seguridad BeVigil. Qué hacer en su lugar: usa el Conector OAuth Nativo 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. Ámbitos sobrepermisivos e ignorar omisiones de validación. El Conector Nativo de HubSpot para Claude solicita ámbitos 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 (por ejemplo, formatos de correo inválidos, campos obligatorios ausentes, nombres de empresa duplicados). Fuente: Base de conocimiento de HubSpot — Mejores prácticas y developers.hubspot.com/mcp. Qué hacer en su lugar: audita los ámbitos tras la configuración, reconecta si faltan permisos de escritura, y ejecuta informes de validación en la interfaz de HubSpot tras cualquier actualización masiva iniciada por Claude.

Ambos comportamientos desencadenan limitación de tasa 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 maneja 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 nivel. Las cuentas Free y Starter de HubSpot están limitadas a 100 peticiones de 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 conflictivas 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 a HubSpot y aplica el ritmo de tasa por ventana de 10 segundos automáticamente.
  • 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 cargas mayores resulta en registros rechazados o transacciones divididas. Fuente: Base de conocimiento de HubSpot (tabla del Conector Nativo) y Documentación de la API de HubSpot. Consecuencia si se ignora: los registros fallan silenciosamente o requieren reintroducción manual. Aplicación de Porter: Porter divide las peticiones masivas en fragmentos de 100 registros y muestra los registros fallidos en la respuesta.
  • Implementa retroceso exponencial en errores 429. Cuando HubSpot limita la tasa, devuelve HTTP 429 con un Retry-After encabezado. 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: Documentación para desarrolladores de HubSpot vía Guía de límites de tasa de Consultevo. Consecuencia si se ignora: reintentar inmediatamente extiende la ventana de limitación y puede agravar los estados de fallo parcial. Aplicación de Porter: El MCP de Porter incluye retroceso exponencial automático con jitter en todas las respuestas 429.
  • Monitoriza tu cuota diaria, no solo los límites de ráfaga. Las cuentas Free/Starter tienen una cuota móvil de 24 horas de 250.000 peticiones; Professional 650.000; Enterprise 1.000.000; Apps públicas 500.000. Una sincronización histórica grande o un backfill puede consumir toda la cuota diaria al mediodía, dejando las automatizaciones de la tarde paralizadas. Fuente: Guía de límites de tasa de Reform.app y Guía de Consultevo. Consecuencia si se ignora: los flujos de trabajo programados (envíos de correo, puntuación de leads, refrescos de reporting) fallan durante horas. Aplicación de Porter: Porter rastrea el consumo de cuota diaria por cuenta y avisa cuando se alcanza el 80%.
  • Nunca confirmes tokens de API en archivos compartidos o repositorios. Los tokens de App Privada de HubSpot y las claves de API heredadas son credenciales estáticas. Una auditoría de 2024 encontró 1,6 millones de datos de usuarios expuestos a través de claves filtradas en repositorios de código públicos. Si usas la ruta 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 comparta por Slack, Notion o GitHub. Fuente: Investigación de seguridad BeVigil. Consecuencia si se ignora: acceso no autorizado a todo tu CRM, incluyendo contactos, negocios, 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 fragmentos compatibles con HubSpot (máximo 100 registros por lote), aplica el ritmo de ráfaga por nivel (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 ámbitos 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 manejan con elegancia: sin limitación, sin sincronizaciones parciales, sin credenciales expuestas.

Preguntas frecuentes

P: ¿Qué es un HubSpot MCP?

Un HubSpot MCP (Model Context Protocol) es un estándar abierto que permite a herramientas de IA — Claude, Claude Code, ChatGPT, Cursor — conectarse a tus datos de HubSpot sin integraciones personalizadas. El servidor MCP de Porter pone tus negocios, contactos y empresas disponibles a través de una URL: sin tokens, sin scripts, sin configuración de desarrollador.

P: ¿Cuál es la diferencia entre Claude y Claude Code?

Claude es el producto conversacional (web, app, móvil). Claude Code es una herramienta de desarrollador basada en terminal que puede escribir scripts, guardar archivos y automatizar flujos de trabajo. Ambos pueden conectarse a HubSpot vía MCP.

P: ¿Qué tan frescos son los datos? ¿Es en tiempo real?

La API de HubSpot se actualiza en una ventana móvil. El MCP de Porter extrae en vivo, así que tus datos siempre están dentro de esa ventana.

P: ¿Hay límites de tasa para los datos de HubSpot?

Sí. HubSpot aplica límites de ráfaga por nivel: 100 peticiones por 10 segundos en Free/Starter, 190 en Professional y 200 en Enterprise, más cuotas diarias de hasta 1.000.000 peticiones. El MCP de Porter agrupa peticiones en lotes de 100 registros y aplica el ritmo por nivel automáticamente. Fuente: [HubSpot API Usage Details]

P: ¿Por qué los números de Claude a veces difieren del dashboard de HubSpot?

Dos razones comunes: (1) Retraso de actualización — los datos de reporting de HubSpot se actualizan en una ventana móvil, así que las extracciones de la API pueden ir por detrás de la interfaz. (2) Sincronización parcial — operaciones masivas o limitadas pueden dejar registros medio actualizados si los errores 429 no se manejan. La solución: prueba con un rango de fechas pequeño primero y verifica que los recuentos de registros coincidan. Fuente: [HubSpot Knowledge Base, HubSpot API Usage Details]

P: ¿Usar Claude afectará mi acceso o límites de HubSpot?

No. HubSpot no prohíbe ni restringe cuentas por uso legítimo de la API, y el MCP de Porter es de solo lectura por defecto: se mantiene bien dentro de los límites normales de HubSpot. Lo que hay que vigilar es la limitación de tasa causando fallos parciales silenciosos a escala: consulta la sección de límites más arriba. Fuente: [HubSpot API Usage Details, HubSpot Community Forums]

¿Listo para chatear con tu HubSpot?

Abre Claude, añade el conector de Porter y haz tu primera pregunta. Si aún no tienes Porter, empieza una prueba gratuita y conecta tu cuenta de HubSpot: estarás chateando con tus negocios, contactos y empresas en menos de cinco minutos.

rocket_launch Pruébalo gratisopen_in_new Abre Claude