Cómo consultar datos de HubSpot CRM con Claude/Cursor a través de MCP (Configuración del servidor MCP de HubSpot)

Vea todo lo que Query Streams puede hacer más allá de esta guía Empezar gratis

Admite

+más

Datos en directo

Sustituir las exportaciones por SQL a petición

Excel Hojas

Análisis de BI e IA

Pregunte a Nova, obtenga SQL + gráficos

Conoce a Nova

API REST de base de datos

Una clave por socio. No se comparten las credenciales.

Crea una API

+más

Automatización

Sincronización programada con más de 6 plataformas

Explore

+más

API a SQL

Consulta de API con SQL, sin código

Explore

+más

Base de datos de IA MCP

Claude, Cursor, ChatGPT y Grok se comunican con tus datos.

Conectar IA

Query Streams es una plataforma segura de integración de datos en tiempo real que incorpora todas las bases de datos y API SaaS de su cuenta a Claude, Cursor, ChatGPT y Grok, mediante una única clave MCP y sin necesidad de modificar el firewall. Esta guía explica el MCP de HubSpot ruta específica, para que su herramienta de IA pueda responder preguntas en lenguaje sencillo sobre contactos, empresas, acuerdos, tickets y objetos personalizados sin que usted exporte archivos CSV desde HubSpot o luche con la API REST v3. El Agente de red extrae los datos de HubSpot CRM a una caché local de DuckDB, para que el LLM vea superficies SQL limpias (contactos, empresas, ofertas, entradas, propietarios, objetos personalizados) en lugar de sobres REST, y Schema Intelligence maneja los modismos de HubSpot (por canalización) etapa de negociación enumeraciones, id_objeto_hs uniones de cuerdas, etapa del ciclo de vida enumeraciones, aplanamiento de propiedades de objetos personalizados) para que el SQL sea correcto al primer intento. Más información en QueryStreams.com y regístrese gratis Para empezar a hacerle preguntas reales a tu herramienta de IA sobre HubSpot CRM.

Lo que te ofrece el servidor MCP de HubSpot de Query Streams

Otros servidores “HubSpot MCP” en el ecosistema de código abierto conectan la herramienta de IA directamente a la API REST de HubSpot v3 y le envían llamadas directas objeto por objeto. Esto funciona, pero inserta un token de aplicación privada de HubSpot en la configuración de su cliente de IA, deja al LLM analizando recursos REST y selectores de propiedades en lugar de SQL, limita el alcance de la herramienta de IA solo a HubSpot y no proporciona un registro de auditoría de lo que la IA realmente solicitó. El servidor HubSpot MCP de Query Streams resuelve un problema más amplio: una sola clave, todos los conectores, registro de auditoría completo, el agente normaliza los datos de HubSpot CRM en superficies SQL con capacidad de unión de múltiples objetos, y la herramienta de IA nunca almacena sus credenciales de HubSpot.

Cómo funciona sin abrir los puertos del firewall

El agente de red de Query Streams es un pequeño programa que se instala una sola vez en una máquina con acceso a Internet (cualquier portátil, servidor o máquina virtual en la nube; la API de HubSpot es accesible desde cualquier lugar). Abre un enlace TLS saliente a la nube de Query Streams y espera allí las llamadas de las herramientas. Cuando Claude o Cursor hacen una pregunta, la nube reenvía la solicitud al agente, el agente llama a la API REST de HubSpot v3, el agente almacena en caché la respuesta en una base de datos DuckDB local para que la IA vea superficies SQL limpias. contactos, empresas, ofertas, entradas, propietarios, tuberíasAdemás de cada objeto personalizado que hayas configurado, en lugar de usar sobres REST, el resultado se transmite de vuelta a través del mismo canal de salida. No hay nada entrante. No se expone nada. La herramienta de IA nunca ve tu token de aplicación privada de HubSpot, tu ID de hub ni tu token de actualización de OAuth.

La tecla MCP que le das a Cursor o Claude tiene alcance (leer / analizar / ejecutar), revocable en cualquier momento y con límite de uso por clave. La herramienta de IA llama a estas herramientas MCP para realizar su trabajo:

Por qué Schema Intelligence hace que Query Streams MCP sea diferente

La mayoría de los servidores “MCP para HubSpot” en el entorno de código abierto le proporcionan a su herramienta de IA la misma referencia de propiedad v3 que HubSpot publica para desarrolladores, o peor aún, la referencia de propiedad sin procesar. esquema_de_información de cualquier caché que mantengan. Nombres de propiedades. Tipos de datos. Tal vez una clave primaria. El LLM se ve obligado a adivinar que etapa de negociación tiene valores de enumeración y los valores de enumeración varían. por tubería, eso id_objeto_hs es una CADENA (no numérica), por lo que las uniones necesitan comparación de cadenas, que etapa del ciclo de vida en contactos se escribe de manera diferente a una columna con un nombre similar en acuerdos, o que las propiedades de objetos personalizados se encuentran detrás de identificadores de API como 2_ id __nombre_de_la_propiedad que necesitan ser aplanados antes de que SQL pueda acceder a ellos. Por eso, la primera consulta SQL que la mayoría de los gestores de relaciones con clientes (LLM) escriben sobre un esquema de HubSpot vacío es incorrecta, no porque el LLM sea malo, sino porque no tiene los datos necesarios para ser correcto (y un filtro por etapa del embudo de ventas que omite silenciosamente la mitad de las oportunidades es el tipo de error que se traduce en un fallo en la previsión trimestral).

Query Streams MCP devuelve ese mismo esquema de HubSpot almacenado en caché enriquecido con lo que llamamos Inteligencia de esquemas (IE) — Metadatos seleccionados por IA que se generan al ejecutar consultas de perfilado contra su actual Datos de HubSpot CRM antes de que el cliente de IA los solicite. Cuando SI está habilitado en el conector de HubSpot, cada herramienta de esquema que la IA llama (qs_get_connector_schema, qs_get_table_schema, tabla_perfil_qs, qs_obtener_relaciones) devuelve el esquema en caché básico más seis capas de conocimiento seleccionado. El LLM deja de adivinar.

Para concretar esto, aquí está lo que el cliente de IA obtiene de vuelta de una sola qs_get_table_schema Llamada en contra del conector de HubSpot ofertas La tabla —el objeto central del embudo de ingresos que impulsa el 80% de las preguntas sobre informes de CRM— primero sin Schema Intelligence, luego con ella.

Las seis capas que añade Schema Intelligence

Cada capa aborda una clase específica de preguntas que el LLM tendría que adivinar de otro modo. SI es opcional por (conector, base de datos) Se ejecuta como una única pasada de perfilado sobre sus datos; no modifica su esquema, no escribe en su base de datos y se actualiza de forma incremental cuando cambia su esquema.

Misma solicitud, diferente SQL

La prueba está en el SQL que realmente escribe la herramienta de IA. Misma sesión de Cursor, mismo modelo de Claude, misma solicitud. “Muéstrame los acuerdos cerrados y ganados en los últimos 90 días, con el propietario del contacto y la empresa, solo los canales habilitados.” Sin la Inteligencia de Esquema, el LLM tiene que adivinar. Con ella, el LLM sabe etapa de negociación Los valores varían según el tipo de tubería. id_objeto_hs es una cadena, y el gráfico de unión tiene en cuenta los objetos personalizados.

Consulta de flujos MCP frente a HubSpot Breeze AI y las superficies de IA oficiales de HubSpot

HubSpot distribuye su propia IA: Brisa IA, el copiloto integrado en el producto que redacta textos de marketing, sugiere las mejores acciones a seguir en las negociaciones y crea borradores de correos electrónicos para los representantes de ventas desde la interfaz de usuario de HubSpot. También hay una interfaz oficial en desarrollo al estilo MCP que expone algunos objetos de HubSpot a clientes externos mediante llamadas a funciones por objeto. Estos son productos reales y resuelven un problema real: IA para creadores de HubSpot que trabajan adentro HubSpot. Flujos de consulta HubSpot MCP tiene una forma diferente: una superficie SQL programática sobre la lleno Modelo de datos CRM (todos los objetos estándar más todos los objetos personalizados) para herramientas de IA en funcionamiento afuera HubSpot, con uniones de múltiples objetos, alcance entre conectores y la misma auditoría + aplicación de solo lectura que incluye cada conector MCP de Query Streams.

Conviven bien. Breeze AI está diseñado para creadores de HubSpot: representantes de ventas, especialistas en marketing y agentes de soporte que trabajan dentro de la interfaz de usuario de HubSpot y que desean un copiloto integrado para la generación de contenido, sugerencias de la siguiente mejor acción y redacción de correos electrónicos. La cobertura oficial de MCP de HubSpot está creciendo y es ideal para agentes de IA que necesitan algunos objetos específicos de HubSpot a través de llamadas a funciones. Query Streams HubSpot MCP es para herramientas de IA que trabajan afuera HubSpot —Claude, Cursor, ChatGPT, Grok, Windsurf, Zed y demás— requiere una interfaz SQL programática sobre todo el modelo de datos de CRM con uniones de múltiples objetos, acceso entre conectores a los datos de Stripe, Postgres, Snowflake y Shopify, y un único plano de acceso de solo lectura auditable. La mayoría de los equipos que adquieren Query Streams HubSpot MCP también siguen utilizando Breeze AI dentro de HubSpot. La decisión se toma por herramienta y por agente de IA, no por organización.

¿MCP no es para ti? Prueba Nova AI en su lugar.

Si editar archivos de configuración JSON e instalar clientes de escritorio de IA te parece más trabajo del que esperabas, puedes prescindir de MCP por completo. Nova AI está integrada directamente en el portal web de Query Streams: no requiere configuración, instalación ni suscripción a ningún proveedor de IA adicional a su plan de Query Streams. Inicia sesión, haz clic Pregúntale a Novay formular el mismo tipo de preguntas en lenguaje sencillo: “¿Qué es la conversión de la cartera de clientes a los ingresos por etapa y qué etapa presenta la mayor caída?" o "Muéstrame las 20 cuentas principales por ARR con fecha de renovación en los próximos 90 días, ordenadas por puntuación de riesgo de abandono.Nova ya conoce todos los conectores que has añadido (HubSpot, tus bases de datos, Stripe, Shopify, Google Ads, todo), así que no hay nada que configurar. El mismo agente de red, la misma política de solo lectura y la misma inteligencia de esquema que impulsa el SQL. Sin necesidad de configurar MCP. Todos los planes de Query Streams incluyen créditos de Nova AI; el uso se descuenta de tu plan, al igual que Excel, Hojas de cálculo y el Generador de consultas.

Conozca a Nova AI

Requisitos previos

Antes de comenzar, asegúrese de tener:

1. Una cuenta gratuita de Query Streams en mi.querystreams.com.
2. El agente de red de Query Streams instalado en una máquina con acceso a Internet — ver Descargar el agente de flujos de consultasLa API de HubSpot es accesible desde cualquier lugar, por lo que el agente no necesita estar en una red específica.
3. Un conector de HubSpot configurado contra el agente; consulte el existente. Configuración del conector API Guías para el emparejamiento de tokens de aplicaciones privadas (recomendado) o aplicaciones de contexto de usuario de OAuth. El agente almacena el token de aplicación privada de HubSpot, su ID de hub y cualquier token de actualización de OAuth; la herramienta de IA nunca accede a ninguno de ellos.
4. Cualquier cliente de IA compatible con MCP. En esta guía mostraremos Cursor, Claude Desktop, ChatGPT y Grok; si usa Windsurf, Zed, Continue, Cline, VS Code Copilot, Codex o Goose, el bloque de configuración es prácticamente el mismo.
5. Cinco minutos.

Paso 1: Generar una clave MCP en Query Streams

Inicie sesión en Query Streams y abra el Página MCP (o inicie sesión primero en mi.querystreams.com y haga clic MCP en la navegación izquierda). Haga clic Generar clave, dale a la clave un nombre reconocible (algo así como cursor-portátil o escritorio claude), y seleccione los ámbitos que desea que tenga esta clave:

• leer — La IA puede examinar conectores y leer esquemas. Necesario para todo lo demás.
• analizar — La IA puede perfilar tablas y descubrir relaciones (valores de muestra, distribuciones, tipos semánticos). Opcional, pero muy recomendable para el trabajo con CRM, donde comprender la estructura de los datos de tus acuerdos y las enumeraciones por etapa del embudo de ventas es fundamental.
• ejecutar — La IA puede ejecutar SQL. Sin esto, la IA solo puede leer los metadatos del esquema.

Para un flujo de trabajo típico de “dejar que Claude analice mis datos de HubSpot CRM”, los tres alcances son apropiados. Para una clave que le entregas a un compañero de equipo o a un cliente de menor confianza, deja caer ejecutar y dejarles solo navegar. Puede revocar cualquier clave en cualquier momento desde la misma página; el cliente de IA verá CLAVE MCP REVOCADA en su siguiente llamada y deja de funcionar inmediatamente. No hay retardo de propagación.

Copia la clave ahora: Query Streams la muestra una vez y luego solo almacena un hash. Si la pierdes, genera una nueva. La clave se ve así: qsmcp_ seguido de 48 caracteres aleatorios y es lo que su cliente de IA envía en el Clave X-MCP encabezado de la solicitud.

Paso 2: Agregue Query Streams MCP a su cliente de IA.

La configuración tiene la misma forma en todos los clientes compatibles con MCP: una entrada de servidor MCP que apunta a https://mcp.querystreams.com con su llave en el Clave X-MCP Encabezado. Seleccione su cliente a continuación.

Cursor ~/.cursor/mcp.json

// Editar ~/.cursor/mcp.json
{
  "mcpServers": {
    "flujos de consulta": {
      "url": "https://mcp.querystreams.com",
      "encabezados": {
        "Clave X-MCP": "qsmcp_PEGAR_CLAVE_AQUÍ"
      }
    }
  }
}

Escritorio de Claude claude_desktop_config.json

// Ajustes → Desarrollador → Editar configuración
{
  "mcpServers": {
    "flujos de consulta": {
      "url": "https://mcp.querystreams.com",
      "encabezados": {
        "Clave X-MCP": "qsmcp_PEGAR_CLAVE_AQUÍ"
      }
    }
  }
}

ChatGPT Aplicaciones y conectores

// Ajustes → Aplicaciones y conectores → Agregar MCP
URL del servidor  https://mcp.querystreams.com
Encabezado de autenticación Clave X-MCP
Valor del encabezado qsmcp_PEGAR_CLAVE_AQUÍ

// Requiere un plan de pago de ChatGPT
// (Plus / Pro / Equipo / Empresa).

Comprender Herramientas MCP remotas

// Grok → Configuración → Herramientas
{
  "mcp_servers": [{
    "nombre": "flujos de consulta",
    "url": "https://mcp.querystreams.com",
    "encabezado_autenticación": "Clave X-MCP",
    "auth_value": "qsmcp_..."
  }]
}

Reinicie su cliente de IA. En su próximo inicio, detectará las ocho herramientas de Query Streams MCP enumeradas anteriormente y las mostrará en su paleta de herramientas. En Cursor y Claude Desktop puede verificarlo escribiendo “conectores de lista” — la IA debería llamar qs_list_connectors y devuelva su conector de HubSpot junto con cualquier otra cosa que haya configurado.

Paso 3: Hazle una pregunta a la IA sobre HubSpot.

No tienes que escribir SQL; la IA lo hace. Haces una pregunta, la IA selecciona la herramienta MCP adecuada, el agente ejecuta la consulta en tus datos de HubSpot almacenados en caché y la respuesta se devuelve en formato de texto y tablas. Tres ejemplos de preguntas para probar primero:

La primera vez que la IA llame a una herramienta, es posible que su cliente muestre una solicitud de confirmación para que usted apruebe la llamada. Este es el flujo de consentimiento estándar de MCP, no una función adicional de Query Streams. Una vez aprobada, la IA continuará con el resto de la conversación sin problemas. Puede revisar el consentimiento en cualquier momento en la configuración de su cliente.

Preguntas frecuentes

Comience

Guías relacionadas: Descargar el agente de flujos de consultas | Configuración del conector API | Todas las guías del servidor MCP | Nova AI texto a SQL

Categoría: Servidor MCP

Etiquetas: mcp, claude, cursor, hubspot, api-connector, crm, sales-analytics, marketing-analytics, breeze-ai, read-only-mcp

Meta Descripción: Consulta HubSpot CRM con Claude o Cursor a través de MCP. Uniones SQL de múltiples objetos, objetos personalizados, sin vulnerabilidades en el firewall. Gratis.