Crear una app de autenticación MCP de HubSpot para OpenConnector

El proveedor actual de HubSpot en OpenConnector usa el flujo OAuth del MCP remoto de HubSpot. Crea una app de autenticación MCP en HubSpot, copia su client ID y client secret, y guarda esos valores para el servicio hubspot en OpenConnector.

Servicio de OpenConnector

ID del servicio	Proveedor	Tipo de autenticación
`hubspot`	Servidor MCP remoto de HubSpot	OAuth2 con PKCE

El proveedor de HubSpot se conecta a través de https://mcp.hubspot.com. La app de autenticación MCP de HubSpot controla los permisos del lado de HubSpot y el flujo de autorización de la cuenta.

Requisitos previos

Un entorno de ejecución de OpenConnector en funcionamiento.
Una cuenta de HubSpot con acceso a Developer Platform y MCP Auth Apps.
Permiso para crear una app de autenticación MCP para la cuenta de HubSpot que quieres conectar.
El origen de OpenConnector que los usuarios abren en el navegador, como http://localhost:3000 o https://connect.example.com.

Paso 1: Establecer la URL de callback de OpenConnector

Construye la URL de callback añadiendo /oauth/callback a tu origen de OpenConnector. Para pruebas locales, usa http://localhost:3000/oauth/callback. Para un despliegue público, establece OOMOL_CONNECT_ORIGIN, reinicia OpenConnector y usa la URL de callback pública, como https://connect.example.com/oauth/callback.

Paso 2: Crear una app de autenticación MCP de HubSpot

En HubSpot:

Abre la cuenta de HubSpot que quieres conectar.
Abre Development.
Abre MCP Auth Apps.
Crea una nueva app de autenticación MCP.
Introduce un nombre de app reconocible.
Establece la URL de redirección exactamente como la URL de callback de OpenConnector.
Guarda la app.

La guía oficial de HubSpot es Integrate AI tools with the HubSpot MCP server.

Paso 3: Copiar las credenciales del cliente

Desde los detalles de la app de autenticación MCP de HubSpot, copia:

Valor de HubSpot	Campo de OpenConnector
Client ID	`clientId`
Client Secret	`clientSecret`

Paso 4: Guardar el cliente de HubSpot en OpenConnector

Usa la consola web de OpenConnector:

Abre la consola web de OpenConnector, como http://localhost:3000.
Abre Providers y selecciona HubSpot.
Elige Configure OAuth Client o Edit OAuth Client.
Pega el client ID y el client secret de HubSpot.
Elige Save OAuth Client.

Paso 5: Conectar y probar

Después de guardar el cliente OAuth, elige Connect en la página del proveedor de HubSpot. Selecciona la cuenta de HubSpot, aprueba el acceso, vuelve a OpenConnector y confirma que la página del proveedor muestra la cuenta como conectada.

Usa los detalles de la acción de la consola antes de ejecutar acciones de CRM como hubspot.list_properties.

Solución de problemas

Síntoma	Qué comprobar
HubSpot indica que el client ID no es válido	Confirma que copiaste el Client ID de la app de autenticación MCP, no de otro tipo de app de HubSpot.
Falla la redirección o el callback	La URL de redirección en HubSpot debe coincidir exactamente con `<openconnector-origin>/oauth/callback`.
Falla el intercambio de tokens	Confirma que la app de autenticación MCP de HubSpot admite OAuth con PKCE y que OpenConnector usa el proveedor actual de HubSpot.
La selección de la cuenta de HubSpot es incorrecta	Cierra sesión en las cuentas de HubSpot adicionales en el navegador o usa un perfil de navegador independiente para la autorización.
Las acciones devuelven errores de permisos	Comprueba los permisos del usuario de HubSpot conectado y las reglas de acceso actuales de la app MCP de HubSpot.