--- title: "Payhawk mit Ihrem KI-Assistenten verbinden - Payhawk Help Center" slug: "connecting-payhawk-mcp" description: "Verbinden Sie Payhawk MCP über die MCP-Server-URL und Ihre Payhawk-Anmeldedaten mit Claude, ChatGPT, Cursor, Notion und anderen unterstützten KI-Assistenten." updated: 2026-10-28T14:33:19Z published: 2026-10-28T14:33:19Z 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. # Payhawk mit Ihrem KI-Assistenten verbinden Payhawk MCP verbindet Ihr Payhawk-Konto mit Ihrem KI-Assistenten. Damit können Sie in dem KI-Assistenten, den Sie bereits verwenden, etwa Claude, ChatGPT oder Cursor, mit Ihren eigenen Anmeldedaten und Berechtigungen Abfragen zu Ihren aktuellen Payhawk-Daten stellen und entsprechend darauf reagieren. ## Bevor Sie starten Zum Verbinden von Payhawk MCP benötigen Sie: - Ein aktives Payhawk Konto. Melden Sie sich mit denselben Zugangsdaten an, die Sie auch für das [Payhawk-Webportal](http://portal.payhawk.com/) verwenden. - Die Payhawk MCP Server-URL ([https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp), auch in den folgenden Abschnitten verfügbar). Jede Person meldet sich mit ihren eigenen Payhawk-Anmeldedaten an, sodass jeder seine eigenen Payhawk-Berechtigungen behält. Sie bleiben angemeldet, solange Sie die Verbindung nutzen. Nach 7 Tagen ohne Nutzung und spätestens alle 30 Tage müssen Sie sich erneut anmelden. ## Unterstützte KI-Assistenten In der folgenden Tabelle sind die KI-Assistenten aufgeführt, die Payhawk MCP unterstützt: | KI-Assistent | Anbieter | Gut zu wissen | | --- | --- | --- | | [Claude](/help/de/connecting-payhawk-mcp#connecting-to-claude) | Anthropic | Web, Desktop-App und mobile App. In einem Team- oder Enterprise-Tarif kann nur ein Claude-Inhaber Payhawk hinzufügen. | | [Claude Code](/help/de/connecting-payhawk-mcp#connecting-to-claude-code) | Anthropic | Einrichtung in einem Terminal. | | [ChatGPT](/help/de/connecting-payhawk-mcp#connecting-to-chatgpt) | OpenAI | Desktop-App, in allen Tarifen einschließlich Free. | | [Codex CLI](/help/de/connecting-payhawk-mcp#connecting-to-codex) | OpenAI | Einrichtung in einem Terminal. Folgen Sie für die Codex-Desktop-App den Schritten für ChatGPT. UI-Komponenten werden als Text angezeigt. | | [Cursor](/help/de/connecting-payhawk-mcp#connecting-to-cursor) | Anysphere | Einrichtung in Ihrer Datei `mcp.json`. | | [GitHub Copilot-App](/help/de/connecting-payhawk-mcp#connecting-to-the-github-copilot-app) | GitHub | | | [GitHub Copilot in VS Code](/help/de/connecting-payhawk-mcp#connecting-to-github-copilot-in-vs-code) | GitHub | Einrichtung über die Command Palette (Befehlspalette). | | [Microsoft Copilot Studio](/help/de/connecting-payhawk-mcp#connecting-to-microsoft-copilot-studio) | Microsoft | | | [Microsoft 365 Copilot](/help/de/connecting-payhawk-mcp#connecting-to-microsoft-365-copilot) | Microsoft | Ein Microsoft 365-Administrator muss den Payhawk-Agenten genehmigen. | | [Langdock](/help/de/connecting-payhawk-mcp#connecting-to-langdock) | Langdock | | | [Notion](/help/de/connecting-payhawk-mcp#connecting-to-notion) | Notion | | | [Dust](/help/de/connecting-payhawk-mcp#connecting-to-dust) | Dust | | > [!TIP] > Payhawk akzeptiert Anmeldungen nur von den KI-Assistenten in der Tabelle. In jeder anderen App schlägt die Anmeldung mit einem Fehler fehl, der `host-not-allowed` oder „The client redirect URI is not allowed“ („Der Client-Umleitungs-URI ist nicht zulässig“) enthält. Wenn Sie Unterstützung für eine andere App anfragen möchten, wenden Sie sich an den Payhawk Support unter [support@payhawk.com](mailto:support@payhawk.com). ## Mit Claude 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](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](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. ## Mit Claude Code verbinden 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. ## Mit ChatGPT verbinden 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](https://mcp.payhawk.com/mcp) ein. 4. Melden Sie sich bitte mit Ihren Payhawk-Anmeldeinformationen an, sobald Sie dazu aufgefordert werden. ## Mit Codex verbinden 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. ## Mit Cursor verbinden 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. ```plaintext {  "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. ## Mit der GitHub Copilot-App verbinden 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](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. ## Mit GitHub Copilot in VS Code verbinden 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](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: ```plaintext {  "mcpServers": {    "Payhawk Customer MCP": {      "type": "http",      "url": "https://mcp.payhawk.com/mcp",      "tools": ["*"]    }  } } ``` ## Mit Microsoft Copilot Studio verbinden 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](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. ## Mit Microsoft 365 Copilot verbinden 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](https://admin.teams.microsoft.com): 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](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: ```plaintext 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](https://admin.microsoft.com): 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. ## Mit Langdock verbinden 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](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. ## Mit Notion verbinden 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](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. ## Mit Dust verbinden 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](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. ## Nachdem Sie Payhawk mit Ihrem KI-Assistenten verbunden haben Sobald Sie angemeldet sind, können Sie Fragen zu Ausgaben, Rechnungen, Kartentransaktionen, Lieferanten und Budgets stellen. Außerdem können Sie Ihren KI-Assistenten bitten, bestimmte Aufgaben auszuführen, wie z. B. Ausgaben neu zu erfassen, Posten zu genehmigen, Karten zu sperren und Anfragen zu erstellen. Bei jeder Änderung wird zunächst eine Vorschau angezeigt, und das System wartet auf Ihre ausdrückliche Bestätigung. Weitere praktische Informationen finden Sie im Artikel zum Thema [So nutzen Sie Payhawk MCP optimal](/help/payhawk-mcp-questions-and-actions).