---
author: OOMOL
author_url: https://oomol.com/fr/about/
title: Créer une app d’authentification MCP HubSpot pour OpenConnector
description: Créez une app d’authentification MCP HubSpot, configurez l’URL de
  redirection OpenConnector et connectez HubSpot avec OAuth.
lang: fr
canonical_url: https://oomol.com/fr/docs/openconnector-hubspot-oauth-app/
markdown_url: https://oomol.com/fr/docs/openconnector-hubspot-oauth-app.md
---

# 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 :

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

Consultez le guide officiel HubSpot [Integrate AI tools with the HubSpot MCP server](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-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 :

1. Ouvrez la console web d’OpenConnector, par exemple `http://localhost:3000`.
2. Ouvrez **Providers** et sélectionnez **HubSpot**.
3. Choisissez **Configure OAuth Client** ou **Edit OAuth Client**.
4. Collez l’ID et le secret du client HubSpot.
5. 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. |
