# Instrucciones para el agente: HubSpot MCP: consulta y actualiza el CRM desde un agente

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.

- Dificultad: intermedio
- Guía completa: https://lab.wisd.ai/hub/hubspot-mcp

---

## 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](https://developers.hubspot.com/mcp).