Connexion de Payhawk à votre Assistant IA

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.

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 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.

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.

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.

4. Connectez-vous avec vos identifiants lorsque vous y êtes invité(e).

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.

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.

   {
     "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é).

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.

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).

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.

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 :

{
  "mcpServers": {
    "Payhawk Customer MCP": {
      "type": "http",
      "url": "https://mcp.payhawk.com/mcp",
      "tools": ["*"]
    }
  }
}

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 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.

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 :

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.

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 :

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 :

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.

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.

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).

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 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.

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.

4. Laissez Authentication (Authentification) sur Automatic (Automatique) et cliquez sur Save (Enregistrer).

Payhawk apparaît désormais dans votre liste d’outils.