Cómo conectar HubSpot a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → HubSpot, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

HubSpot + Gemini

Deja que tu IA trabaje en HubSpot CRM: busca y actualiza contactos, empresas, negocios y tickets, consulta qué está asociado con qué, revisa pipelines y propietarios, y registra notas y tareas. Una cuenta, con una clave de servicio que creas tú mismo.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

HUBSPOT_ACCESS_TOKEN

Paso 1 — Obtener credenciales

1. En HubSpot, abre Development en la barra lateral izquierda, luego Keys → Service keys, y haz clic en Create service key. Necesitas ser superadministrador o un usuario con acceso a las herramientas de desarrollo.
2. Ponle un nombre a la clave (por ejemplo "AnythingMCP"), haz clic en Add new scope, marca los scopes que se indican más abajo y luego haz clic en Update y Create.
3. Abre la clave, haz clic en Show y luego en Copy. Las claves de servicio empiezan por pat- (por ejemplo pat-eu1-...).
4. Pega la clave en HUBSPOT_ACCESS_TOKEN, sin la palabra Bearer, e instala el conector.
5. Empieza con hubspot_get_account: muestra a qué cuenta de HubSpot (Hub ID) pertenece la clave, su zona horaria y su moneda.

Apps privadas heredadas: las cuentas más antiguas pueden tener todavía una app privada (Development → Legacy apps, antes Settings → Integrations → Private Apps). Su token de acceso funciona igual: pégalo en HUBSPOT_ACCESS_TOKEN.

Scopes:

• Lectura: crm.objects.contacts.read (cubre también notas y tareas), crm.objects.companies.read, crm.objects.deals.read, crm.objects.tickets.read, crm.objects.owners.read.
• Escritura: crm.objects.contacts.write (necesario también para notas y tareas), crm.objects.companies.write, crm.objects.deals.write, crm.objects.tickets.write.

Solo lectura: da a la clave solo los scopes de lectura y desactiva hubspot_create_object, hubspot_update_object, hubspot_associate_records, hubspot_create_note y hubspot_create_task.

Desactivadas al instalar: hubspot_archive_object. Actívala solo si la IA debe eliminar registros. Los registros archivados van a la papelera de reciclaje de HubSpot y se pueden restaurar desde ahí durante 90 días.

Ajustes de privacidad de datos: si la privacidad de datos (RGPD) está activada en tu cuenta de HubSpot, HubSpot exige una base jurídica para el tratamiento, la propiedad hs_legal_basis, en cada contacto nuevo. Indica a la IA qué base jurídica debe usar cuando cree contactos; sin ella, HubSpot responde "The following required properties were missing".

Límites: HubSpot permite 100 solicitudes cada 10 segundos por clave en Free y Starter (más en Professional y Enterprise), 250.000 solicitudes al día por cuenta y 5 búsquedas por segundo. Si se supera un límite, HubSpot responde 429: espera unos segundos y vuelve a intentarlo.

Errores frecuentes: 401 significa que la clave es incorrecta, caducó o se rotó: vuelve a copiarla. 403 indica el scope que falta: añádelo a la clave en Edit. 404 significa que el id o el tipo de objeto es incorrecto. 400 VALIDATION_ERROR indica la propiedad o el filtro erróneo, por ejemplo un nombre de propiedad desconocido o un valor de lista desplegable que no es una de sus opciones.

El conector no gestiona correos de marketing, formularios, listas, workflows, archivos, presupuestos ni precios de partidas, fusiones ni escrituras por lotes.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de HubSpot.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué negocios del pipeline de ventas está previsto cerrar este mes y quién es su propietario?"
• "Busca el contacto [email protected] y muéstrame su empresa y sus negocios abiertos."
• "Pasa el negocio de Acme Corp a la siguiente etapa y añade una nota con un resumen de la llamada de hoy."
• "Crea una tarea de seguimiento para mí en el negocio de Globex, con vencimiento el próximo viernes."

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse