--- title: "Connexion de Payhawk à votre Assistant IA - Payhawk Help Center" slug: "connecting-payhawk-mcp" description: "Connectez le Payhawk MCP à Claude, ChatGPT, Cursor, Notion et aux autres Assistants IA pris en charge, avec l'URL du serveur MCP et vos identifiants Payhawk." updated: 2026-10-28T14:33:32Z published: 2026-10-28T14:33:32Z canonical: "payhawk.com/connecting-payhawk-mcp" --- > ## Documentation Index > Fetch the complete documentation index at: https://payhawk.com/help/llms.txt > Use this file to discover all available pages before exploring further. # Connexion de Payhawk à votre Assistant IA Le Payhawk MCP connecte votre compte à votre Assistant IA, afin que vous puissiez interroger vos données en temps réel et agir dessus dans l’Assistant IA que vous utilisez déjà, comme Claude, ChatGPT ou Cursor, en utilisant vos propres identifiants et autorisations. ## Avant de commencer Pour connecter le Payhawk MCP, il vous faut : - Un compte Payhawk actif. Connectez-vous avec les mêmes identifiants que ceux utilisés pour le [portail web Payhawk](http://portal.payhawk.com/). - L'URL du serveur Payhawk MCP ([https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp), également disponible dans les sections suivantes). Chaque personne se connecte avec ses propres identifiants Payhawk, de sorte que chacun conserve ses propres autorisations Payhawk. Vous restez connecté(e) tant que vous utilisez la connexion. Vous devez vous reconnecter après 7 jours sans utilisation, et au plus tard tous les 30 jours. ## Assistants IA pris en charge Le tableau suivant répertorie les Assistants IA pris en charge par le Payhawk MCP : | Assistant IA | Éditeur | Bon à savoir | | --- | --- | --- | | [Claude](/help/fr/connecting-payhawk-mcp#connecting-to-claude) | Anthropic | Web, applications de bureau et mobile. Avec un abonnement Team ou Enterprise, seul un propriétaire Claude peut ajouter Payhawk. | | [Claude Code](/help/fr/connecting-payhawk-mcp#connecting-to-claude-code) | Anthropic | Configuration dans un terminal. | | [ChatGPT](/help/fr/connecting-payhawk-mcp#connecting-to-chatgpt) | OpenAI | Application de bureau, avec tous les abonnements, y compris Free. | | [Codex CLI](/help/fr/connecting-payhawk-mcp#connecting-to-codex) | OpenAI | Configuration dans un terminal. Pour utiliser l'application de bureau Codex, suivez les étapes pour ChatGPT. Les composants d'interface s'affichent sous forme de texte. | | [Cursor](/help/fr/connecting-payhawk-mcp#connecting-to-cursor) | Anysphere | Configuration dans votre fichier `mcp.json`. | | [Application GitHub Copilot](/help/fr/connecting-payhawk-mcp#connecting-to-the-github-copilot-app) | GitHub | | | [GitHub Copilot dans VS Code](/help/fr/connecting-payhawk-mcp#connecting-to-github-copilot-in-vs-code) | GitHub | Configuration depuis la Command Palette (palette de commandes). | | [Microsoft Copilot Studio](/help/fr/connecting-payhawk-mcp#connecting-to-microsoft-copilot-studio) | Microsoft | | | [Microsoft 365 Copilot](/help/fr/connecting-payhawk-mcp#connecting-to-microsoft-365-copilot) | Microsoft | Un administrateur Microsoft 365 doit approuver l'agent Payhawk. | | [Langdock](/help/fr/connecting-payhawk-mcp#connecting-to-langdock) | Langdock | | | [Notion](/help/fr/connecting-payhawk-mcp#connecting-to-notion) | Notion | | | [Dust](/help/fr/connecting-payhawk-mcp#connecting-to-dust) | Dust | | > [!TIP] > Payhawk accepte uniquement les connexions depuis les Assistants IA du tableau. Dans toute autre application, la connexion échoue avec une erreur mentionnant `host-not-allowed` ou « The client redirect URI is not allowed » (« L'URI de redirection du client n'est pas autorisée »). Pour demander la prise en charge d'une autre application, contactez l'assistance Payhawk à l'adresse [support@payhawk.com](mailto:support@payhawk.com). ## Connexion à Claude Claude prend en charge le Payhawk MCP sur le web, dans l'application de bureau et dans l'application mobile. Vérifiez d'abord si vous pouvez ajouter des connecteurs vous-même. - Les connecteurs personnalisés fonctionnent avec tous les abonnements Claude (Free, Pro, Max, Team et Enterprise ; Free en autorise un seul), l'abonnement constitue donc rarement un obstacle. - Avec un compte personnel Free, Pro ou Max, vous pouvez ajouter le connecteur vous-même. - Dans un espace de travail Team ou Enterprise, seul un propriétaire Claude peut ajouter un connecteur personnalisé. Demandez-lui d'ajouter Payhawk à une seule reprise, puis connectez-vous-y individuellement. Le fait d'être administrateur Payhawk n'a aucune incidence ici : il s'agit d'une autorisation Claude, et non d'une autorisation liée à la plateforme. Si vous l'ajoutez vous-même (Free, Pro, Max) : 1. Dans l'application de bureau Claude, accédez à **Paramètres** > **Connecteurs**. 2. Cliquez sur **Ajouter un connecteur personnalisé**. 3. Saisissez un nom, par exemple **Payhawk**, et l'URL du serveur Payhawk MCP [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp). 4. Conservez les options que Claude indique comme **Détecté** : **Se connecter maintenant** sous **Authentification** et **Enregistrer automatiquement** sous **Client OAuth**. 5. Connectez-vous avec vos identifiants lorsque vous y êtes invité(e). Vous pouvez également ajouter Payhawk depuis l'application mobile Claude, sur le même écran. Si votre propriétaire Claude l'ajoute (Team, Enterprise) : 1. Le propriétaire accède à **Paramètres de l'organisation** > **Connecteurs**, clique sur **Ajouter**, survole **Personnalisé** et sélectionne **Web**. 2. Le propriétaire colle l'URL du serveur Payhawk MCP [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp) et clique sur **Ajouter**. 3. Tous les autres utilisateurs accèdent à **Paramètres** > **Connecteurs**, trouvent Payhawk, cliquent sur **Connecter** et se connectent avec leurs propres identifiants. Chaque personne se connecte en son nom, de sorte que chacun conserve ses propres autorisations. Payhawk apparaît désormais dans vos outils Claude. ## Connexion à Claude Code Pour connecter Payhawk à Claude Code : 1. Dans un terminal, exécutez `claude mcp add --transport http payhawk https://mcp.payhawk.com/mcp`. Pour rendre Payhawk disponible dans tous vos projets et pas uniquement dans le projet actuel, ajoutez `--scope user`. 2. Lancez Claude Code et saisissez `/mcp`. 3. Sélectionnez **payhawk** et suivez les étapes dans votre navigateur pour vous connecter avec vos identifiants Payhawk. Vous pouvez aussi vous connecter depuis le terminal avec `claude mcp login payhawk` et vous déconnecter avec `claude mcp logout payhawk`. Les exécutions non interactives (`claude -p`) ne peuvent pas terminer la connexion : connectez-vous donc d'abord une fois depuis une session interactive. Si vous supprimez le serveur avec `claude mcp remove payhawk`, votre connexion enregistrée est également supprimée. ## Connexion à ChatGPT Le Payhawk MCP fonctionne dans l'application de bureau ChatGPT, y compris avec l'abonnement Free. Pour connecter Payhawk à ChatGPT : 1. Dans l'application de bureau ChatGPT, accédez à **Paramètres** > **Plugins** > **Ajouter** > **Ajouter un serveur MCP**. 2. Saisissez un nom, par exemple **Payhawk**. 3. Choisissez **Streamable HTTP** et collez l'URL du serveur Payhawk MCP [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp). 4. Connectez-vous avec vos identifiants lorsque vous y êtes invité(e). ## Connexion à Codex L'application de bureau Codex fait désormais partie de l'application de bureau ChatGPT. Pour y utiliser Payhawk, suivez les étapes pour ChatGPT. Pour connecter Payhawk à Codex CLI (l'outil en ligne de commande) : 1. Dans un terminal, exécutez `codex mcp add payhawk --url https://mcp.payhawk.com/mcp`. 2. Exécutez `codex mcp login payhawk`. 3. Connectez-vous avec vos identifiants Payhawk dans la fenêtre du navigateur qui s’ouvre. Les composants d'interface, tels que les widgets de vol ou d'approbation, ne s'affichent pas dans Codex. La réponse est fournie sous forme de texte. ## Connexion à Cursor Pour connecter Payhawk à Cursor : 1. Dans Cursor, accédez à **Customize** (Personnaliser) > **MCPs** > **New MCP Server** (Nouveau serveur MCP). Cursor ouvre votre fichier `mcp.json`. 2. Ajoutez Payhawk dans `"mcpServers"`, comme dans l'exemple suivant. Si le fichier contient déjà d'autres serveurs, ajoutez une virgule après l'entrée précédente. ```plaintext {  "mcpServers": {    "payhawk": { "url": "https://mcp.payhawk.com/mcp" }  } } ``` 3. Enregistrez le fichier et revenez à **Customize** (Personnaliser) > **MCPs**. 4. Sous **Needs Attention** (Nécessite une attention), cliquez sur **Authenticate** (S'authentifier) à côté de Payhawk et connectez-vous avec vos identifiants Payhawk. Payhawk apparaît désormais sous **Connected** (Connecté). ## Connexion à l'application GitHub Copilot Pour connecter Payhawk à l'application GitHub Copilot : 1. Dans l'application GitHub Copilot, accédez à **Customize** (Personnaliser) > **Installed** (Installé). 2. À côté de **MCP Servers** (Serveurs MCP), cliquez sur **Add server** (Ajouter un serveur) > **Add custom server** (Ajouter un serveur personnalisé). 3. Dans **Server name** (Nom du serveur), saisissez un nom, par exemple **payhawk**. 4. Dans **Server type** (Type de serveur), choisissez **HTTP**. 5. Dans **URL**, collez l'URL du serveur Payhawk MCP [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp). 6. Laissez **Headers** (En-têtes), **OAuth Client ID** (ID client OAuth) et **Timeout** (Délai d'expiration) vides, puis cliquez sur **Add server** (Ajouter un serveur). 7. Connectez-vous avec vos identifiants lorsque vous y êtes invité(e). ## Connexion à GitHub Copilot dans VS Code Pour connecter Payhawk à GitHub Copilot dans VS Code : 1. Dans VS Code, ouvrez la Command Palette (palette de commandes) avec `Cmd+Shift+P` sur Mac ou `Ctrl+Shift+P` sur Windows et exécutez **MCP: Add Server** (MCP : Ajouter un serveur). 2. Choisissez **HTTP**. 3. Collez l'URL du serveur Payhawk MCP [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp). 4. Saisissez un nom, par exemple **Payhawk Customer MCP**. 5. Choisissez **Global** ou **Workspace** (Espace de travail). VS Code ajoute Payhawk à votre fichier `mcp-config.json`, comme dans l'exemple suivant : ```plaintext {  "mcpServers": {    "Payhawk Customer MCP": {      "type": "http",      "url": "https://mcp.payhawk.com/mcp",      "tools": ["*"]    }  } } ``` ## Connexion à Microsoft Copilot Studio Pour connecter Payhawk à Microsoft Copilot Studio : 1. Dans Copilot Studio, accédez à **Tools** (Outils) et cliquez sur **New tool** (Nouvel outil). 2. Sélectionnez **Model Context Protocol**. 3. Remplissez les champs obligatoires : un nom dans **Server name** (Nom du serveur), par exemple **Payhawk MCP**, une description dans **Server description** (Description du serveur) et l'URL du serveur Payhawk MCP [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp) dans **Server URL** (URL du serveur). 4. Dans **Authentication** (Authentification), choisissez **OAuth 2.0** et, dans **Type**, choisissez **Dynamic discovery** (Découverte dynamique). 5. Cliquez sur **Create** (Créer). Payhawk apparaît désormais dans votre liste d’outils. ## Connexion à Microsoft 365 Copilot Microsoft 365 Copilot ne propose pas d'option pour ajouter un connecteur. Vous empaquetez plutôt Payhawk sous forme d'agent dans VS Code et le publiez dans votre organisation. ### Ce dont vous avez besoin Pour publier Payhawk dans Microsoft 365 Copilot, il vous faut : - Un compte professionnel Microsoft 365. Les comptes Microsoft personnels ne fonctionnent pas. - Un administrateur général ou un administrateur Teams de Microsoft 365 pour les étapes d'approbation. - Visual Studio Code avec l'extension **Microsoft 365 Agents Toolkit**, version 6.12.0 ou ultérieure. ### Autoriser les applications personnalisées (une fois, par un administrateur) Dans le [centre d’administration Teams](https://admin.teams.microsoft.com) : 1. Accédez à **Teams apps** (Applications Teams) > **Setup policies** (Stratégies de configuration) > **Global (Org-wide default)** (Global (valeur par défaut de l'organisation)), activez **Upload custom apps** (Charger des applications personnalisées) et cliquez sur **Save** (Enregistrer). 2. Accédez à **Teams apps** (Applications Teams) > **Manage apps** (Gérer les applications) > **Actions** > **Org-wide app settings** (Paramètres d'application à l'échelle de l'organisation), activez **Let users interact with custom apps in preview** (Autoriser les utilisateurs à interagir avec les applications personnalisées en préversion) et cliquez sur **Save** (Enregistrer). L'application des modifications peut prendre jusqu'à 24 heures. ### Créer l'agent dans VS Code Pour créer l'agent Payhawk : 1. Dans VS Code, cliquez sur l'icône **Microsoft 365 Agents Toolkit** dans la barre de gauche. 2. Cliquez sur **Create a New Agent/App** (Créer un nouvel agent ou une nouvelle application) > **Declarative Agent** (Agent déclaratif) > **Add an Action** (Ajouter une action) > **Start with an MCP Server** (Commencer avec un serveur MCP). 3. Pour l'URL du serveur, saisissez [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp). 4. Pour l'authentification, sélectionnez **OAuth (with dynamic registration)** (OAuth (avec enregistrement dynamique)). 5. Choisissez un dossier pour le projet et nommez l'agent, par exemple **Payhawk**. 6. Dans la nouvelle fenêtre VS Code, cliquez sur **Trust** (Faire confiance). Si vous avez manqué l'invite, cliquez sur **Restricted Mode** (Mode restreint) dans la barre d'état, puis sur **Trust** (Faire confiance). ### Définir le nom et la description Définissez un vrai nom et une vraie description pour l'agent. Si vous ignorez cette étape, les utilisateurs voient un texte d'exemple et un suffixe « dev » dans le nom. 1. Dans `appPackage/manifest.json`, remplacez les valeurs d'exemple de `developer.name`, `name.full`, `description.short` et `description.full`. 2. Dans `appPackage/declarativeAgent.json`, remplacez `description`. 3. Créez le fichier `env/.env.prod` avec le contenu suivant : ```plaintext TEAMSFX_ENV=prod APP_NAME_SUFFIX= ``` ### Publier l'agent Pour envoyer l'agent à votre administrateur pour approbation : 1. Dans le volet **Lifecycle** (Cycle de vie), cliquez sur **Provision** (Provisionner) et choisissez **prod**. 2. Cliquez sur **Publish** (Publier) et choisissez **prod**. ### Approuver l'agent (par un administrateur) Dans le [centre d’administration Microsoft 365](https://admin.microsoft.com) : 1. Accédez à **Agents** > **All agents** (Tous les agents) > **Requests** (Demandes). 2. Ouvrez l'agent Payhawk et cliquez sur **Publish to store** (Publier dans le Store). 3. Sous **Select users or groups who can install the agent** (Sélectionner les utilisateurs ou les groupes qui peuvent installer l'agent), choisissez **All users** (Tous les utilisateurs) ou des groupes spécifiques. Vous pouvez aussi choisir qui reçoit l'agent préinstallé dans sa barre latérale. 4. Acceptez la stratégie de sécurité par défaut, vérifiez les autorisations et cliquez sur **Publish** (Publier). Si l'étape de la stratégie de sécurité ne cesse de charger, approuvez plutôt l'agent dans le centre d'administration Teams : accédez à **Teams apps** (Applications Teams) > **Manage apps** (Gérer les applications), trouvez l'agent Payhawk et publiez-le ou autorisez-le. Les utilisateurs ouvrent ensuite Payhawk sous **Agents** dans la barre latérale de Copilot. La première fois qu'ils posent une question, ils cliquent sur **Sign in** (Se connecter), se connectent avec leurs identifiants Payhawk et approuvent l'accès. ## Connexion à Langdock Pour connecter Payhawk à Langdock : 1. Dans Langdock, accédez à **Integrations** (Intégrations) > **Create** (Créer) > **Integration** (Intégration). 2. Sélectionnez **Connect remote MCP** (Connecter un MCP distant). 3. Dans **Server URL** (URL du serveur), collez l'URL du serveur Payhawk MCP [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp). 4. Dans **Authentication method** (Méthode d'authentification), choisissez **OAuth 2.0 (Dynamic Client Registration)** (OAuth 2.0 (enregistrement dynamique du client)). 5. Connectez-vous avec vos identifiants lorsque vous y êtes invité(e). ## Connexion à Notion Pour connecter Payhawk à Notion : 1. Dans Notion, accédez à **Settings** (Paramètres) > **Connections** (Connexions). 2. Cliquez sur **+ Add connection** (+ Ajouter une connexion) > **Custom MCP connection** (Connexion MCP personnalisée). 3. Dans **MCP server URL** (URL du serveur MCP), saisissez l'URL du serveur Payhawk MCP [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp) et, dans **Name** (Nom), saisissez un nom, par exemple **Payhawk**. 4. Dans **Authentication** (Authentification), choisissez **OAuth**. 5. Cliquez sur **Connect** (Connecter). Notion affiche un avis indiquant qu'il n'a pas vérifié ce serveur, ce qui est normal pour les serveurs personnalisés. 6. Lorsque Notion vous redirige vers Payhawk, connectez-vous avec vos identifiants Payhawk. ## Connexion à Dust Pour connecter Payhawk à Dust : 1. Dans Dust, accédez à **Spaces** (Espaces) > **Tools** (Outils) et cliquez sur **Add tools** (Ajouter des outils). 2. Cliquez sur **Add MCP server** (Ajouter un serveur MCP). 3. Dans **URL**, collez l'URL du serveur Payhawk MCP [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp). 4. Laissez **Authentication** (Authentification) sur **Automatic** (Automatique) et cliquez sur **Save** (Enregistrer). Payhawk apparaît désormais dans votre liste d’outils. ## Après avoir connecté Payhawk à votre Assistant IA Une fois connecté(e), vous pouvez poser des questions sur les dépenses, les factures, les transactions par carte, les fournisseurs et les budgets. Vous pouvez également demander à votre Assistant IA d'effectuer des actions, comme recoder des dépenses, approuver des éléments, bloquer des cartes ou créer des demandes. Chaque modification affiche d'abord un aperçu et attend votre confirmation explicite. Pour des informations plus pratiques, consultez l'article sur [comment tirer le meilleur parti du Payhawk MCP](/help/payhawk-mcp-questions-and-actions).