Payhip über MCP mit Microsoft Copilot verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Payhip klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Payhip + Microsoft Copilot

Verwalte die Gutscheincodes deines Payhip-Shops und prüfe Software-Lizenzschlüssel aus einem KI-Agent: Gutscheine auflisten und lesen, nach deiner Freigabe neue anlegen, den Lizenzschlüssel eines Käufers prüfen und, wenn du es erlaubst, ihn sperren, wieder freischalten oder seine Aktivierungen zählen.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

PAYHIP_API_KEY

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 2 Minuten. Du brauchst einen Payhip-Shop und seinen API-Schlüssel. Für Lizenzschlüssel brauchst du außerdem ein Produkt, bei dem Lizenzschlüssel eingeschaltet sind.

1. Öffne in Payhip Settings → Developer und kopiere den API key.
2. Füge nur den Schlüssel in PAYHIP_API_KEY ein. Die Gutschein-Tools nutzen ihn.
3. Optional, für Lizenzschlüssel: Öffne das Produkt in Payhip, setze den Haken bei Generate unique license keys, falls er noch fehlt, und kopiere den product secret key, der unter dieser Checkbox steht, in PAYHIP_PRODUCT_SECRET_KEY.
4. Installiere den Connector und rufe payhip_list_coupons auf: Es listet deine Gutscheincodes und bestätigt, dass der API-Schlüssel funktioniert. Hast du einen Product Secret Key gesetzt, prüfst du mit payhip_verify_license und dem Schlüssel eines deiner Käufer auch die Lizenzseite.

Ein lizenziertes Produkt pro Installation: Ein Product Secret Key gehört zu genau einem Produkt. Um die Schlüssel mehrerer Produkte zu prüfen, installierst du den Connector einmal pro Produkt und gibst jeder Installation den Namen des Produkts. Gutscheine funktionieren in jeder Installation, weil sie den API-Schlüssel des Shops verwenden.

Was sie liest: die Gutscheincodes deines Shops mit Code, Art (ein Produkt, alle Produkte oder eine Kollektion), Rabatt in Prozent oder als Betrag, Start- und Enddatum, Mindestbestellwert, Nutzungslimit und Notizen; und für das eingerichtete Produkt den Zustand eines Lizenzschlüssels: ob er aktiv ist, die E-Mail des Käufers, Produkt und Variante, wie oft er genutzt wurde und wann er ausgestellt wurde.

Nur Gutscheine und Lizenzschlüssel: Die Payhip-API deckt derzeit nur diese beiden Bereiche ab. Produkte, Verkäufe, Kunden und Auszahlungen sind darüber nicht verfügbar.

Die Daten lesen: Beträge (Rabattbetrag, Mindestbestellwert) stehen in Cent, der Prozentrabatt ist ein Prozentwert. Eine leere Antwort von payhip_verify_license heißt, dass es den Schlüssel für dieses Produkt nicht gibt. Payhip sperrt einen Schlüssel automatisch, wenn der Kauf erstattet wird. Die Nutzungen eines Schlüssels sind ein Zähler, den deine Software hoch- und runtersetzt; Payhip erzwingt kein Limit, das macht deine Software.

Bei der Installation deaktiviert: payhip_create_coupon, payhip_disable_license, payhip_enable_license, payhip_increase_license_usage und payhip_decrease_license_usage. Ein neuer Gutschein gilt an der Kasse, sobald er existiert, und ein gesperrter Schlüssel sperrt den Käufer aus deiner Software aus, bis er wieder freigeschaltet wird. Abo-Produkte können über die API keine Gutscheine bekommen. Ein Administrator schaltet die ein, die du brauchst.

Fragt vor jeder Änderung: Ist ein Schreibtool eingeschaltet, zeigt dir die KI den Code, den Rabatt und wofür er gilt, oder den Lizenzschlüssel und was mit ihm passiert, und wartet auf dein Ja.

Limits: Gutscheinlisten kommen in Seiten mit bis zu 100 Einträgen. Bei einem großen Shop blättert die KI also durch, statt alles auf einmal abzufragen.

Häufige Fehler: 401 authentication_fail bedeutet, dass der API-Schlüssel oder der Product Secret Key falsch ist oder fehlt: Kopiere PAYHIP_API_KEY erneut aus Settings → Developer und prüfe für die Lizenz-Tools PAYHIP_PRODUCT_SECRET_KEY auf der Produktseite. Die Firewall von Payhip prüft Gutschein-Aufrufe aus Rechenzentrumsadressen besonders, deshalb laufen Gutschein-Aufrufe über den ausgehenden Proxy von AnythingMCP, wo einer eingerichtet ist (wie auf AnythingMCP Cloud). Auf einem selbst gehosteten Server ohne CONNECTOR_PROXY_URL können Gutschein-Aufrufe mit 403 und einer HTML-Seite antworten.

Der Connector liest keine Produkte, Verkäufe, Kunden oder Auszahlungen und stellt weder Erstattungen noch neue Lizenzschlüssel aus.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Microsoft Copilot hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Payhip-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

Verfügbare Tools

Beispiel-Prompts

• „Ist der Lizenzschlüssel 7XK2-9QPL-44MZ-H1TR gültig? Wer hat ihn gekauft, und wie oft wurde er schon genutzt?“
• „Liste unsere Gutscheincodes mit dem jeweiligen Rabatt auf und sag mir, welche diesen Monat ablaufen.“
• „Welche Bedingungen hat der Gutschein HERBST20: Mindestbestellwert, Nutzungslimit und für welches Produkt gilt er?“
• „Ein Käufer sagt, sein Schlüssel geht nach einer Erstattung nicht mehr. Prüf, ob er noch aktiv ist und zu welcher E-Mail er gehört.“
• „Welche unserer Gutscheine gelten für alle Produkte, und welche nur für ein Produkt oder eine Kollektion?“

FAQ

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden