Payhawk mit Ihrem KI-Assistenten verbinden

Claude unterstützt Payhawk MCP im Web, in der Desktop-App und in der mobilen App.

Prüfen Sie zunächst, ob Sie selbst Konnektoren hinzufügen können.

• Benutzerdefinierte Konnektoren funktionieren in jedem Claude-Tarif (Free, Pro, Max, Team und Enterprise; im Free-Tarif ist einer zulässig). Demzufolge stellt dieser Aspekt selten ein Hindernis dar.

• Bei einem persönlichen Free-, Pro- oder Max-Konto können Sie Payhawk selbst hinzufügen.

• In einem Team- oder Enterprise-Workspace kann nur ein Claude-Inhaber einen benutzerdefinierten Konnektor hinzufügen. Bitten Sie daher Ihren Claude-Inhaber, Payhawk einmalig hinzuzufügen, und stellen Sie anschließend individuell eine Verbindung her. Ob Sie Payhawk Administrator sind, spielt hierbei keine Rolle. Es handelt sich hierbei um eine Berechtigung von Claude, nicht um eine von Payhawk.

Wenn Sie ihn selbst hinzufügen (Free, Pro, Max):

1. Gehen Sie in der Claude-Desktop-App zu Einstellungen > Konnektoren.

2. Klicken Sie auf Benutzerdefinierten Konnektor hinzufügen.

3. Geben Sie einen Namen ein, zum Beispiel Payhawk, sowie die Payhawk-MCP-Server-URL https://mcp.payhawk.com/mcp.

4. Behalten Sie die Optionen bei, die Claude als Erkannt markiert: Jetzt anmelden unter Authentifizierung und Automatisch registrieren unter OAuth-Client.

5. Melden Sie sich bitte mit Ihren Payhawk-Anmeldeinformationen an, sobald Sie dazu aufgefordert werden.

Sie können Payhawk auch über die mobile Claude-App auf demselben Bildschirm hinzufügen.

Falls Ihr Claude-Besitzer dies hinzufügt (Team, Unternehmen):

1. Der Eigentümer navigiert zu Organisationseinstellungen > Konnektoren, klickt auf Hinzufügen, bewegt den Mauszeiger über Benutzerdefiniert und wählt Web aus.

2. Der Eigentümer fügt die  https://mcp.payhawk.com/mcp Payhawk-MCP-Server-URL ein und klickt auf Hinzufügen.

3. Alle anderen gehen zu Einstellungen > Konnektoren, suchen „Payhawk“, klicken auf Verbinden und melden sich mit ihren eigenen Payhawk-Zugangsdaten an. Jede Person meldet sich unter ihrem eigenen Konto an, sodass jeder seine eigenen Payhawk-Berechtigungen behält.

Payhawk wird nun in Ihren Claude-Tools angezeigt.

So verbinden Sie Payhawk mit Claude Code:

1. Führen Sie in einem Terminal claude mcp add --transport http payhawk https://mcp.payhawk.com/mcp aus. Wenn Payhawk in all Ihren Projekten und nicht nur im aktuellen verfügbar sein soll, fügen Sie --scope user hinzu.

2. Starten Sie Claude Code und geben Sie /mcp ein.

3. Wählen Sie payhawk aus und folgen Sie den Schritten in Ihrem Browser, um sich mit Ihren Payhawk-Anmeldedaten anzumelden.

Sie können sich auch im Terminal mit claude mcp login payhawk anmelden und mit claude mcp logout payhawk abmelden.

Nicht interaktive Ausführungen (claude -p) können die Anmeldung nicht abschließen. Melden Sie sich daher zuerst einmal in einer interaktiven Sitzung an. Wenn Sie den Server mit claude mcp remove payhawk entfernen, wird auch Ihre gespeicherte Anmeldung entfernt.

Payhawk MCP funktioniert in der ChatGPT-Desktop-App, auch im Free-Tarif. So verbinden Sie Payhawk mit ChatGPT:

1. Gehen Sie in der ChatGPT-Desktop-App zu Einstellungen > Plugins > Hinzufügen > MCP-Server hinzufügen.

2. Geben Sie einen Namen ein, zum Beispiel Payhawk.

3. Wählen Sie Streamable HTTP aus und fügen Sie die Payhawk-MCP-Server-URL https://mcp.payhawk.com/mcp ein.

4. Melden Sie sich bitte mit Ihren Payhawk-Anmeldeinformationen an, sobald Sie dazu aufgefordert werden.

Die Codex-Desktop-App ist jetzt Teil der ChatGPT-Desktop-App. Um Payhawk dort zu nutzen, folgen Sie den Schritten für ChatGPT. So verbinden Sie Payhawk mit Codex CLI (dem Befehlszeilen-Tool):

1. Führen Sie in einem Terminal codex mcp add payhawk --url https://mcp.payhawk.com/mcp aus.

2. Führen Sie codex mcp login payhawk aus.

3. Melden Sie sich im sich öffnenden Browserfenster mit Ihren Payhawk-Anmeldedaten an.

UI-Komponenten wie Flug- oder Genehmigungs-Widgets werden in Codex nicht angezeigt. Sie erhalten die Antwort als Text.

So verbinden Sie Payhawk mit Cursor:

1. Gehen Sie in Cursor zu Customize (Anpassen) > MCPs > New MCP Server (Neuer MCP-Server). Cursor öffnet Ihre Datei mcp.json.

2. Fügen Sie Payhawk wie im folgenden Beispiel unter "mcpServers" hinzu. Wenn die Datei bereits andere Server enthält, setzen Sie nach dem vorherigen Eintrag ein Komma.

   {
     "mcpServers": {
       "payhawk": { "url": "https://mcp.payhawk.com/mcp" }
     }
   }

3. Speichern Sie die Datei und kehren Sie zu Customize (Anpassen) > MCPs zurück.

4. Klicken Sie unter Needs Attention (Aufmerksamkeit erforderlich) neben Payhawk auf Authenticate (Authentifizieren) und melden Sie sich mit Ihren Payhawk-Anmeldedaten an.

Payhawk wird nun unter Connected (Verbunden) angezeigt.

So verbinden Sie Payhawk mit der GitHub Copilot-App:

1. Gehen Sie in der GitHub Copilot-App zu Customize (Anpassen) > Installed (Installiert).

2. Klicken Sie neben MCP Servers (MCP-Server) auf Add server (Server hinzufügen) > Add custom server (Benutzerdefinierten Server hinzufügen).

3. Geben Sie unter Server name (Servername) einen Namen ein, zum Beispiel payhawk.

4. Wählen Sie unter Server type (Servertyp) die Option HTTP aus.

5. Fügen Sie unter URL die Payhawk-MCP-Server-URL https://mcp.payhawk.com/mcp ein.

6. Lassen Sie Headers (Header), OAuth Client ID (OAuth-Client-ID) und Timeout (Zeitüberschreitung) leer und klicken Sie auf Add server (Server hinzufügen).

7. Melden Sie sich bitte mit Ihren Payhawk-Anmeldeinformationen an, sobald Sie dazu aufgefordert werden.

So verbinden Sie Payhawk mit GitHub Copilot in VS Code:

1. Öffnen Sie in VS Code die Command Palette (Befehlspalette) mit Cmd+Shift+P auf dem Mac oder Ctrl+Shift+P unter Windows und führen Sie MCP: Add Server (MCP: Server hinzufügen) aus.

2. Wählen Sie HTTP aus.

3. Fügen Sie die Payhawk-MCP-Server-URL https://mcp.payhawk.com/mcp ein.

4. Geben Sie einen Namen ein, zum Beispiel Payhawk Customer MCP.

5. Wählen Sie Global oder Workspace (Arbeitsbereich) aus.

VS Code fügt Payhawk wie im folgenden Beispiel zu Ihrer Datei mcp-config.json hinzu:

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

So verbinden Sie Payhawk mit Microsoft Copilot Studio:

1. Gehen Sie in Copilot Studio zu Tools und klicken Sie auf New tool (Neues Tool).

2. Wählen Sie Model Context Protocol aus.

3. Füllen Sie die Pflichtfelder aus: einen Namen unter Server name (Servername), zum Beispiel Payhawk MCP, eine Beschreibung unter Server description (Serverbeschreibung) und die Payhawk-MCP-Server-URL https://mcp.payhawk.com/mcp unter Server URL (Server-URL).

4. Wählen Sie unter Authentication (Authentifizierung) die Option OAuth 2.0 und unter Type (Typ) die Option Dynamic discovery (Dynamische Erkennung) aus.

5. Klicken Sie auf Create (Erstellen).

Payhawk wird nun in Ihrer Liste der Tools angezeigt.

Microsoft 365 Copilot bietet keine Option zum Hinzufügen eines Konnektors. Stattdessen verpacken Sie Payhawk in VS Code als Agenten und veröffentlichen ihn in Ihrer Organisation.

Was Sie benötigen

Um Payhawk in Microsoft 365 Copilot zu veröffentlichen, benötigen Sie:

• Ein Microsoft 365-Geschäftskonto. Private Microsoft-Konten funktionieren nicht.

• Einen Globalen Administrator oder Teams-Administrator von Microsoft 365 für die Genehmigungsschritte.

• Visual Studio Code mit der Erweiterung Microsoft 365 Agents Toolkit, Version 6.12.0 oder höher.

Benutzerdefinierte Apps zulassen (einmalig, durch einen Administrator)

Im Teams Admin Center:

1. Gehen Sie zu Teams apps (Teams-Apps) > Setup policies (Einrichtungsrichtlinien) > Global (Org-wide default) (Global (organisationsweiter Standard)), aktivieren Sie Upload custom apps (Benutzerdefinierte Apps hochladen) und klicken Sie auf Save (Speichern).

2. Gehen Sie zu Teams apps (Teams-Apps) > Manage apps (Apps verwalten) > Actions (Aktionen) > Org-wide app settings (Organisationsweite App-Einstellungen), aktivieren Sie Let users interact with custom apps in preview (Benutzern die Interaktion mit benutzerdefinierten Apps in der Vorschau erlauben) und klicken Sie auf Save (Speichern).

Es kann bis zu 24 Stunden dauern, bis die Änderungen wirksam werden.

Den Agenten in VS Code erstellen

So erstellen Sie den Payhawk-Agenten:

1. Klicken Sie in VS Code in der linken Leiste auf das Symbol Microsoft 365 Agents Toolkit.

2. Klicken Sie auf Create a New Agent/App (Neuen Agenten oder neue App erstellen) > Declarative Agent (Deklarativer Agent) > Add an Action (Aktion hinzufügen) > Start with an MCP Server (Mit einem MCP-Server beginnen).

3. Geben Sie als Server-URL https://mcp.payhawk.com/mcp ein.

4. Wählen Sie für die Authentifizierung OAuth (with dynamic registration) (OAuth (mit dynamischer Registrierung)) aus.

5. Wählen Sie einen Ordner für das Projekt und benennen Sie den Agenten, zum Beispiel Payhawk.

6. Klicken Sie im neuen VS Code-Fenster auf Trust (Vertrauen). Wenn Sie die Abfrage verpasst haben, klicken Sie in der Statusleiste auf Restricted Mode (Eingeschränkter Modus) und dann auf Trust (Vertrauen).

Namen und Beschreibung festlegen

Legen Sie einen echten Namen und eine echte Beschreibung für den Agenten fest. Wenn Sie diesen Schritt überspringen, sehen Benutzer Platzhaltertext und das Suffix „dev“ im Namen.

1. Ersetzen Sie in appPackage/manifest.json die Platzhalterwerte von developer.name, name.full, description.short und description.full.

2. Ersetzen Sie in appPackage/declarativeAgent.json den Wert description.

3. Erstellen Sie die Datei env/.env.prod mit folgendem Inhalt:

TEAMSFX_ENV=prod
APP_NAME_SUFFIX=

Den Agenten veröffentlichen

So senden Sie den Agenten zur Genehmigung an Ihren Administrator:

1. Klicken Sie im Bereich Lifecycle (Lebenszyklus) auf Provision (Bereitstellen) und wählen Sie prod aus.

2. Klicken Sie auf Publish (Veröffentlichen) und wählen Sie prod aus.

Den Agenten genehmigen (durch einen Administrator)

Im Microsoft 365 Admin Center:

1. Gehen Sie zu Agents (Agenten) > All agents (Alle Agenten) > Requests (Anfragen).

2. Öffnen Sie den Payhawk-Agenten und klicken Sie auf Publish to store (Im Store veröffentlichen).

3. Wählen Sie unter Select users or groups who can install the agent (Benutzer oder Gruppen auswählen, die den Agenten installieren können) die Option All users (Alle Benutzer) oder bestimmte Gruppen aus. Sie können auch festlegen, bei wem der Agent in der Seitenleiste vorinstalliert wird.

4. Akzeptieren Sie die Standard-Sicherheitsrichtlinie, prüfen Sie die Berechtigungen und klicken Sie auf Publish (Veröffentlichen).

Wenn der Schritt der Sicherheitsrichtlinie nicht fertig lädt, genehmigen Sie den Agenten stattdessen im Teams Admin Center: Gehen Sie zu Teams apps (Teams-Apps) > Manage apps (Apps verwalten), suchen Sie den Payhawk-Agenten und veröffentlichen oder erlauben Sie ihn.

Die Benutzer öffnen Payhawk dann in der Copilot-Seitenleiste unter Agents (Agenten). Wenn sie zum ersten Mal etwas fragen, klicken sie auf Sign in (Anmelden), melden sich mit ihren Payhawk-Anmeldedaten an und genehmigen den Zugriff.

So verbinden Sie Payhawk mit Langdock:

1. Gehen Sie in Langdock zu Integrations (Integrationen) > Create (Erstellen) > Integration.

2. Wählen Sie Connect remote MCP (Remote-MCP verbinden) aus.

3. Fügen Sie unter Server URL (Server-URL) die Payhawk-MCP-Server-URL https://mcp.payhawk.com/mcp ein.

4. Wählen Sie unter Authentication method (Authentifizierungsmethode) die Option OAuth 2.0 (Dynamic Client Registration) (OAuth 2.0 (dynamische Client-Registrierung)) aus.

5. Melden Sie sich bitte mit Ihren Payhawk-Anmeldeinformationen an, sobald Sie dazu aufgefordert werden.

So verbinden Sie Payhawk mit Notion:

1. Gehen Sie in Notion zu Settings (Einstellungen) > Connections (Verbindungen).

2. Klicken Sie auf + Add connection (+ Verbindung hinzufügen) > Custom MCP connection (Benutzerdefinierte MCP-Verbindung).

3. Geben Sie unter MCP server URL (MCP-Server-URL) die Payhawk-MCP-Server-URL https://mcp.payhawk.com/mcp und unter Name einen Namen ein, zum Beispiel Payhawk.

4. Wählen Sie unter Authentication (Authentifizierung) die Option OAuth aus.

5. Klicken Sie auf Connect (Verbinden). Notion zeigt einen Hinweis an, dass dieser Server nicht geprüft wurde. Das ist bei benutzerdefinierten Servern normal.

6. Wenn Notion Sie zu Payhawk weiterleitet, melden Sie sich mit Ihren Payhawk-Anmeldedaten an.

So verbinden Sie Payhawk mit Dust:

1. Gehen Sie in Dust zu Spaces (Bereiche) > Tools und klicken Sie auf Add tools (Tools hinzufügen).

2. Klicken Sie auf Add MCP server (MCP-Server hinzufügen).

3. Fügen Sie unter URL die Payhawk-MCP-Server-URL https://mcp.payhawk.com/mcp ein.

4. Lassen Sie Authentication (Authentifizierung) auf Automatic (Automatisch) eingestellt und klicken Sie auf Save (Speichern).

Payhawk wird nun in Ihrer Liste der Tools angezeigt.