lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

configuración intermedio mcpcrmclaude-code

HubSpot MCP: consulta y actualiza el CRM desde un agente

Conecta el contexto de contactos y negocios a tu agente y revisa las actualizaciones del CRM sin cambiar de herramienta.

✓ verificado el 27 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Paso 1: crea el conector remoto

En HubSpot abre Development, MCP Connectors y Create MCP connector. Define nombre y URL de redirección para tu cliente según la guía oficial.

Paso 2: autoriza la conexión

Configura el cliente con https://mcp.hubspot.com, el Client ID, Client secret y Redirect URL de la página de detalles del conector. La URL de redirección debe coincidir exactamente en ambos lados. El cliente debe admitir PKCE. Completa OAuth seleccionando la cuenta HubSpot y autorizando los permisos de tu usuario; crear el conector por sí solo no autoriza consultas. Revisa los permisos que concedas; no guardes sus secretos en el repositorio.

Paso 3: empieza con lectura

Ejecuta get_user_details para conocer herramientas y objetos disponibles. Busca un registro de prueba e inspecciona su identificador y propiedades antes de pedir una actualización.

Comprobación

Compara el registro obtenido con el CRM. Si pruebas una escritura autorizada, cambia una propiedad de prueba y vuelve a leerla para confirmar el resultado.

Si algo falla

Si faltan objetos o propiedades, revisa la cuenta, las autorizaciones del conector y la configuración de Sensitive Data. No amplíes a todos los permisos para resolver una consulta concreta.

Fuente del procedimiento.

ver en .md ¿Prefieres el recurso entero?

Qué es

HubSpot distingue un MCP remoto para datos del CRM y un MCP local para desarrollar sobre su plataforma. Este recurso trata la conexión remota, que da a clientes compatibles acceso de lectura y escritura según los permisos concedidos.

Para qué te sirve

  • Cuando preparas una reunión y necesitas contexto reciente de una cuenta.
  • Cuando revisas negocios por etapa y propietario.
  • Cuando debes registrar un seguimiento y comprobarlo en el CRM.

Cómo funciona

La conexión remota usa autorización de usuario para consultar objetos e interacciones de HubSpot. El conector y los permisos que concede el usuario determinan el alcance. El MCP de desarrollo, en cambio, funciona a través del CLI y sirve para construir extensiones; no sustituye al acceso remoto al CRM.

Antes de empezar

Una cuenta HubSpot y permiso para crear un conector MCP en Development. El cliente necesita OAuth con PKCE. Los scopes disponibles se determinan por las herramientas y el acceso autorizado durante la instalación. Si está activada Sensitive Data, ciertas actividades y conversaciones no serán accesibles por MCP.

Límites y alternativas

Un permiso de escritura puede modificar datos comerciales; confirma el registro y las propiedades antes de aplicarlo. No presupongas que toda propiedad u objeto está disponible con cualquier cuenta. La UI del CRM es una alternativa para cambios aislados que requieren revisión visual.

Recursos