Créer une app d’authentification MCP HubSpot pour OpenConnector

Le fournisseur HubSpot actuel d’OpenConnector utilise le flux OAuth MCP distant de HubSpot. Créez une app d’authentification MCP dans HubSpot, copiez son ID et son secret client, puis enregistrez ces valeurs pour le service hubspot dans OpenConnector.

Service OpenConnector

ID du service	Fournisseur	Type d’authentification
`hubspot`	Serveur MCP distant HubSpot	OAuth2 avec PKCE

Le fournisseur HubSpot se connecte via https://mcp.hubspot.com. L’app d’authentification MCP HubSpot contrôle les permissions côté HubSpot et le flux d’autorisation du compte.

Prérequis

Un runtime OpenConnector en cours d’exécution.
Un compte HubSpot ayant accès à Developer Platform et aux MCP Auth Apps.
La permission de créer une app d’authentification MCP pour le compte HubSpot à connecter.
L’origine OpenConnector ouverte par les utilisateurs dans le navigateur, par exemple http://localhost:3000 ou https://connect.example.com.

Étape 1 : définir l’URL de callback OpenConnector

Ajoutez /oauth/callback à l’origine OpenConnector pour construire l’URL de callback. Pour un test local, utilisez http://localhost:3000/oauth/callback. Pour un déploiement public, définissez OOMOL_CONNECT_ORIGIN, redémarrez OpenConnector et utilisez l’URL de callback publique, par exemple https://connect.example.com/oauth/callback.

Étape 2 : créer une app d’authentification MCP HubSpot

Dans HubSpot :

Ouvrez le compte HubSpot à connecter.
Ouvrez Development.
Ouvrez MCP Auth Apps.
Créez une nouvelle app d’authentification MCP.
Saisissez un nom d’app reconnaissable.
Définissez l’URL de redirection sur l’URL de callback OpenConnector exacte.
Enregistrez l’app.

Consultez le guide officiel HubSpot Integrate AI tools with the HubSpot MCP server.

Étape 3 : copier les identifiants du client

Depuis les détails de l’app d’authentification MCP HubSpot, copiez :

Valeur HubSpot	Champ OpenConnector
Identifiant client	`clientId`
Secret client	`clientSecret`

Étape 4 : enregistrer le client HubSpot dans OpenConnector

Utilisez la console web d’OpenConnector :

Ouvrez la console web d’OpenConnector, par exemple http://localhost:3000.
Ouvrez Providers et sélectionnez HubSpot.
Choisissez Configure OAuth Client ou Edit OAuth Client.
Collez l’ID et le secret du client HubSpot.
Choisissez Save OAuth Client.

Étape 5 : connecter et tester

Après avoir enregistré le client OAuth, choisissez Connect sur la page du fournisseur HubSpot. Sélectionnez le compte HubSpot, approuvez l’accès, revenez dans OpenConnector et vérifiez que la page du fournisseur indique que le compte est connecté.

Consultez les détails de l’opération dans la console avant d’exécuter des opérations CRM comme hubspot.list_properties.

Résolution des problèmes

Symptôme	Vérification
HubSpot indique que l’ID client est invalide	Vérifiez que vous avez copié le Client ID de l’app d’authentification MCP, et non celui d’un autre type d’app HubSpot.
La redirection ou le callback échoue	L’URL de redirection dans HubSpot doit correspondre exactement à `<openconnector-origin>/oauth/callback`.
L’échange de jeton échoue	Vérifiez que l’app d’authentification MCP HubSpot prend en charge OAuth avec PKCE et qu’OpenConnector utilise le fournisseur HubSpot actuel.
Le mauvais compte HubSpot est sélectionné	Déconnectez les comptes HubSpot supplémentaires dans le navigateur ou utilisez un profil distinct pour l’autorisation.
Les opérations renvoient des erreurs de permission	Vérifiez les permissions de l’utilisateur HubSpot connecté et les règles d’accès actuelles de l’app MCP HubSpot.