Conecta HubSpot con Claude mediante MCP.

HubSpotPlan gratuitoFlujos de consultaClaude

Pregunta a Claude sobre tu cuenta de HubSpot en lenguaje natural: el Agent que ya está dentro de tu red ejecuta las consultas SQL en modo de solo lectura y tu cliente de IA nunca tiene acceso a tus credenciales. En unos diez minutos, y el plan Free lo cubre.

Comienza gratis

Lo que obtendrás al final

Un agente Claude que puede responder preguntas sobre tu cuenta de HubSpot con consultas en tiempo real de solo lectura, explicar el significado de las columnas y responder cuando solicites más información, sin necesidad de acceder a la base de datos ni modificar el firewall: el agente, que ya se encuentra dentro de tu red, ejecuta la consulta SQL y devuelve solo las filas. Una vez configurado el agente, conectar Claude tarda aproximadamente 90 segundos si te sientes cómodo con la pantalla de configuración. Así:

Claude ChatGPT Cursor Código Claude VS Code Windsurf Gemini CLI JetBrains Códice+5 másSolo lectura

¿Qué hay en hubspot.ofertas ¿En mi cuenta de HubSpot? Muéstrame algunas filas y dime qué significa cada columna.

qs_get_table_schema qs_run_query inteligencia de esquema

Primero examiné la estructura de la tabla y luego ejecuté una consulta de solo lectura a través de su Agente. Aquí están tres de las filas de hubspot.deals:

nombre del acuerdo	etapa de negociación	cantidad
1042	Comerciantes de Northwind	Seattle
1057	Equipamiento alpino	Denver
1063	Alimentos del puerto	Halifax

nombre del acuerdo identifica la fila. etapa de negociación y cantidad están descritos en tu modelo de Inteligencia Semántica, así que puedo filtrarlos por nombre.

¿Cuáles tres? cantidad Los valores generaron la mayor parte de los ingresos este trimestre, ¿y cómo se compara eso con el trimestre pasado? ¿Hay algo que deba investigar?

qs_obtener_relaciones qs_run_query qs_run_query

Me uní hubspot.ofertas a pedidos Se basó en la relación que encontró Semantic Intelligence y luego ejecutó una agregación para cada trimestre. Ambas consultas fueron de solo lectura y devolvieron 3 filas cada una:

cantidad	Este trimestre	último trimestre	Cambiar
Denver	184,200	133,900	+38%
Seattle	171,650	168,400	+2%
Halifax	96,300	129,700	-26%

Denver En resumen: los ingresos aumentaron un 38% con prácticamente el mismo número de clientes, por lo que el valor medio de los pedidos también subió. Halifax Cayó un 26%, y la caída se debe a dos clientes que realizaban pedidos todos los meses el trimestre pasado y ninguno este trimestre; conviene llamar antes de que termine el mes. Seattle se mantiene estable. ¿Quiere los nombres de las dos cuentas de Halifax?

SELECCIONAR solamente, verificado por el Agente registrado en la pestaña Actividad de MCP Se obtuvieron 9 filas en 3 consultas. Misma conexión en 14 clientes MCP.

¿Prefieres no conectar ningún cliente de IA? En el plan de negocios, Nova MCP es el asistente integrado en Query Streams. Utiliza el mismo conjunto de herramientas de agente que tu cliente de IA tiene aquí, además de funciones que un cliente externo no tiene: redacta y valida el SQL con tu modelo de Inteligencia Semántica, convierte la respuesta en un gráfico y guarda el resultado como una consulta que tu equipo puede ejecutar desde Excel, Google Sheets o la API REST; sin clave, sin conector, sin necesidad de instalar nada. Usa MCP cuando tu equipo ya trabaje con Claude, Cursor o ChatGPT; usa Nova cuando quieras las respuestas dentro del Portal.

HubSpot almacena tus datos tras su API. Claude, en cambio, se ejecuta en un navegador o terminal y no tiene conocimiento de ellos. El método habitual consiste en pegar un esquema en el chat y esperar que funcione, o bien proporcionar tu contraseña de HubSpot a un servidor MCP de código abierto. Query Streams funciona de forma diferente: el agente que ya está asociado a tu cuenta de HubSpot ejecuta la consulta SQL que escribe Claude en modo de solo lectura, y el servidor MCP, entretanto, verifica quién realiza la consulta, qué acciones puede realizar y con qué frecuencia. Claude obtiene respuestas, pero nunca credenciales.

Lo que necesitarás

Una cuenta de Query Streams

MCP está disponible en todos los planes, incluido el gratuito. El plan gratuito permite una clave o una aplicación conectada, que es todo lo que necesita esta guía. Regístrese en mi.querystreams.com.

HubSpot conectado a través del Agente

El agente se instala en cualquier ordenador que esté siempre encendido, con la conexión a HubSpot añadida en Agentes de datos. ¿Aún no ha terminado? Conecta primero con HubSpot; tarda unos diez minutos.

MCP activado para ti

Los creadores, propietarios y administradores lo tienen desde el principio. Todos los demás necesitan un administrador para cambiar el MCP cambiar junto a su nombre debajo Cuenta → Control de accesoHasta entonces, la página de MCP indica que "MCP está deshabilitado para su cuenta".

Un cliente de IA

Las aplicaciones de chat como claude.ai, Claude Desktop y ChatGPT se conectan sin clave. Claude Code, Cursor, VS Code y otras diez herramientas utilizan una clave; el Portal Conectar un cliente de IA La guía configura cada uno.

Configúralo en cuatro pasos.

1. Abra MCP en el portal

   Iniciar sesión en mi.querystreams.com y abierto Transmisiones → En vivo → MCPLa página tiene cuatro pestañas: Conexiones, Contexto, Herramientas y, para los administradores, Actividad. Consulta el panel de Inteligencia Semántica en Conexiones Mientras estés aquí: se muestra tu conector de HubSpot y si se ha ejecutado Semantic Intelligence en él. La cobertura completa es lo que permite a Claude escribir código SQL correcto para HubSpot al primer intento.

   MCP abierto

   ¿Ves el mensaje "MCP está desactivado para tu cuenta"? Su organización tiene MCP pero su usuario está desactivado. Un administrador lo activa con el MCP cambia al lado de tu nombre debajo Cuenta → Control de accesoLos creadores, propietarios y administradores están presentes desde el principio.

2. Elige cómo te conectarás

   Hay dos maneras de entrar, y ambas terminan en el mismo lugar:

   Aplicaciones de chat · sin clave

   claude.ai, Claude Desktop, ChatGPT

   En claude.ai y Claude Desktop, abra el Listado de flujos de consulta En el directorio de conectores de Anthropic, haga clic aquí. Conectar y aprobar. Agregándolo por URL, https://mcp.querystreams.com/mcp, es la alternativa. En ChatGPT, agrega Query Streams desde la aplicación (modo desarrollador por ahora) e inicia sesión con Query Streams. De cualquier manera, se abre una página de Query Streams: elige la organización y los permisos y haz clic. Aprobar conexión. Nada que copiar. La conexión aparece en el Conexiones pestaña y puede ser revocada allí.

   Herramientas para desarrolladores · una clave

   Claude Code, Cursor, VS Code y amigos

   En la página MCP haga clic Conectar un cliente de IAEl guía pregunta ¿Cómo se conectará su cliente de IA?: elegir Utilice una clave en un archivo de configuración., elige tu herramienta y luego Generar una clave para eso: un Nombre de la clave, Leer y Ejecutar consultas tictac, un Vencimiento (Nunca, 30 días, 90 días o 1 año). Configúralo muestra el fragmento con la clave completada y Comprueba la conexión espera la primera llamada.

   Ambos métodos utilizan los mismos tres permisos, que usted elige en la pantalla de consentimiento o en la clave:

   Leer

   Lista los conectores, explora tablas y columnas, lee tus consultas guardadas y reglas de alerta. Nunca devuelve datos de filas.

   Ejecutar consultas

   Ejecuta consultas SQL de solo lectura y consultas guardadas a través de tu agente y devuelve las filas. Sin esto, tu cliente de IA puede describir tus datos, pero no responder a partir de ellos.

   Analizar

   Perfila tablas, descubre relaciones y programa una ejecución de Inteligencia Semántica. Consume créditos de Nova AI y datos asignados, por lo que la pantalla de consentimiento nunca lo marca previamente.

   ¿Perdiste la llave? Está listado en el Conexiones pestaña: Mostrar la clave completa lo muestra de nuevo y Copiar clave completa Copia el permiso. Revoca el permiso allí si se pierde un portátil; todos los clientes que lo utilicen fallarán en su siguiente llamada, en unos cinco minutos.

3. Conectar con Claude

   Selecciona la receta del Claude que vayas a usar. La dirección del servidor es la misma en todas partes: https://mcp.querystreams.com/mcp.

   Claude en la web, Claude para escritorio y móvil Sin llave

   1. Abre el Listado de flujos de consulta en el Directorio de conectores de Anthropic y haga clic ConectarEn el escritorio, entonces se ubica debajo + → Conectores.
   2. Como alternativa, si su organización oculta los conectores de directorio: Configuración → Conectores → Agregar conector personalizado, nombre Flujos de consulta, URL https://mcp.querystreams.com/mcp, campos de OAuth vacíos, Añadir; luego en un chat + → Flujos de consulta → Conectar.
   3. Se abre una pestaña de Flujos de consulta. Inicie sesión si se le solicita, seleccione la organización y revise. Leer y Ejecutar consultas, opcionalmente Limitar a conectores específicosy haga clic Aprobar conexión.
   4. De vuelta en Claude verá "Conectado a flujos de consulta". La primera vez que Claude usa una herramienta, pregunta; elija Permitir siempre.

   Si lo agregas manualmente en Claude Desktop, usa Configuración → Conectores → Agregar, no el chat interno Agregar mercado Opción que requiere un repositorio Git. Los conectores se sincronizan con tu cuenta de Claude, por lo que las aplicaciones móviles y de escritorio los detectan automáticamente. Los nombres de los menús son de Anthropic y pueden cambiarse.

   Código Claude llave

   Un comando, con la clave de la pestaña Conexiones:

   Terminal

   claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp \ --header "X-MCP-Key: qsmcp_PESTE_YOUR_KEY_HERE"

   Eso escribe el proyecto actual. .mcp.json. Agregar --ámbito usuario Tener Query Streams en cada proyecto. Ejecutar /mcp Dentro de Claude Code para verlo conectado.

   Cursor llave

   Abrir Configuración del cursor → MCP → Agregar nuevo servidor MCPo editar .cursor/mcp.json en la raíz de tu espacio de trabajo:

   .cursor/mcp.json

   { "mcpServers": { "querystreams": { "url": "https://mcp.querystreams.com/mcp", "headers": { "X-MCP-Key": "qsmcp_PEGA_TU_CLAVE_AQUÍ" } } } }

   Reiniciar Cursor o ejecutar MCP: Reiniciar servidores; a flujos de consultas El distintivo aparece en la barra de estado del MCP.

   ¿Usar otra cosa? El Portal Conectar un cliente de IA guía tiene recetas listas para pegar para ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev y JetBrains AI, además de una Pegar y combinar herramienta que deja caer el flujos de consultas Entrada en un archivo de configuración que ya tienes. Cualquier cliente que utilice MCP a través de HTTP funciona: servidor https://mcp.querystreams.com/mcp, encabezado Clave X-MCP (un Autorización: Portador El encabezado con la misma clave también funciona).

4. Haz tu primera pregunta

   Empieza con algo cuya respuesta ya conozcas, para que puedas ver cómo Claude elige la herramienta adecuada. Tres que funcionan bien con tu cuenta de HubSpot:

   “¿Qué datos tengo en mi cuenta de HubSpot?”

   Claude enumera las tablas que puede ver, te indica cuáles tienen inteligencia semántica y te pregunta qué quieres consultar.

   “Muéstrame diez filas de hubspot.deals y explícame cada columna.”

   Claude primero lee la estructura de la tabla (Leer), luego ejecuta una consulta SELECT a través de su Agente (Ejecutar consultas) y describe qué significan dealstage y amount.

   “¿Cuántas filas tiene hubspot.deals por importe? ¿Qué importe tiene la mayor cantidad?”

   Claude escribe la cláusula GROUP BY en el dialecto de HubSpot, la ejecuta y responde con una frase que incluye una pequeña tabla. Continúa la conversación en el mismo chat; así se mantiene el contexto.

   Para confirmar el cableado, pregunte “¿Qué conectores de Query Streams tengo?”Claude llama qs_list_connectors, la guía del Portal Comprueba la conexión dice paso Conectadoy la clave o aplicación en el Conexiones La pestaña muestra su Último uso tiempo en cuestión de segundos.

Lo que Claude puede hacer una vez conectado

Su cliente de IA ve las herramientas de Query Streams; elige la correcta para su pregunta. El Portal Herramientas pestaña enumera todas las herramientas y modos con lo que incluye tu plan. Query Streams pide a tu cliente de IA que lea las columnas de cada tabla antes de consultarla, para que escriba los nombres reales en lugar de adivinarlos. En todos los planes, incluido Free:

El conjunto de herramientas analíticas. En los planes de pago, el Agente se encarga del trabajo preliminar en tu cuenta de HubSpot, para que tu cliente de IA pueda concentrarse en el análisis. La versión gratuita funciona como siempre.

Los valores predeterminados se encuentran en el Contexto pestaña: límite de celdas de texto, vista de esquema, tamaño del resultado, valores predeterminados de análisis y resultados retenidos.

Por qué la inteligencia semántica es importante aquí

Cada respuesta que recibe Claude está etiquetada con la procedencia de la estructura, y Claude ajusta el grado de confianza que deposita en lo que ve.

Si una base de datos importa, ejecute la Inteligencia Semántica en ella una vez. Nova → Inteligencia. El Conexiones La pestaña muestra un panel de cobertura por conector. Cómo funciona la inteligencia semántica.

Lo que permiten los planes

MCP está incluido en todos los planes, incluido el gratuito, sin coste adicional. Cada plan establece cuántas claves o aplicaciones conectadas puedes tener y cuántas llamadas por minuto puede realizar tu cliente de IA:

Una aplicación conectada cuenta como una clave. Además de la cifra por minuto, cualquier clave puede ejecutar como máximo 10 consultas por minuto. Una consulta se ejecuta durante un máximo de 60 segundos, a menos que su cliente de IA solicite más tiempo, hasta cinco minutos. Su plan también establece cuántas filas devuelve una consulta y, con el conjunto de herramientas analíticas, cuánto tiempo y qué tan grande puede ser un resultado retenido; la guía completa de MCP enumera todos los planes. Lo que recibe tu cliente de IA se descuenta de tu cuota de Data Realm, el mismo cupo que utilizan tus consultas de Excel y Sheets: el uso de AI-agent (MCP) cuenta cada byte enviado a tu cliente de IA, ya sean resultados, lecturas de esquemas o páginas de resultados retenidos, antes de cualquier compresión de transporte que negocie tu cliente, mientras que las consultas de hojas de cálculo cuentan el resultado comprimido que envía tu Network Agent. Las ejecuciones de Semantic Intelligence iniciadas desde tu cliente de IA consumen créditos de Nova AI, exactamente igual que si se iniciaran desde el Portal. Consulte la página de precios. para las asignaciones.

Mantenerlo seguro

Buenos pasos a seguir

• Guarda las consultas que consideres canónicas En el Generador de consultas, Claude recurre primero a las consultas guardadas, por lo que "clientes activos" significa lo que tu equipo diga que significa.
• Utiliza un proyecto Claude con Query Streams adjunto y coloque sus reglas de la casa en sus instrucciones: qué base de datos de HubSpot usar por defecto, qué consultas guardadas son las definiciones oficiales.
• Grant Analyze cuando se buscan respuestas más profundas. Analizar una columna antes de filtrarla marca la diferencia entre adivinar un código de estado y usar el correcto. Consume créditos de Nova AI, así que permanecerá desactivado hasta que lo indiques.
• Solicita un gráfico. claude.ai dibuja gráficos a partir de las filas que recibe Claude.

Cuando algo no funciona

Preguntas que hace la gente

Guías relacionadas

• Conecta Stripe con Claude mediante MCP.
• Conecta Shopify con Claude mediante MCP.
• Conecta Google Analytics 4 con Claude mediante MCP.
• Conecta Google Search Console con Claude mediante MCP.
• Conectar Query Streams a Claude mediante MCP: configuración, permisos y solución de problemas
• Cómo conectar HubSpot con Google Sheets
• Todas las guías MCP