Affiliate-Partner per Claude, ChatGPT oder Cursor gewinnen – mit dem MCP-Server von GetAff

Was Sie brauchen

• Ein GetAff-Konto mit mindestens einer Website und deren Partnerprogramm: Jedes Werkzeug der Partnersuche arbeitet mit einer Website, identifiziert über ihre siteId.
• Einen MCP-Client: claude.ai, Claude Desktop, Claude Code, ChatGPT, Cursor, VS Code oder jeden Client, der Streamable HTTP unterstützt.
• Für kostenpflichtige Schritte (Live-Suchen in Creator-Daten, E-Mail-Suchen): den Pro-Tarif. Die kostenlosen Quellen – der Creator-Index von GetAff, ähnliche Creator wie in Ihrer Auswahl und die Promoter Ihrer Wettbewerber – funktionieren in jedem Tarif.
• Für die Ansprache: ein in der App verbundenes Gmail-Postfach und vollständige Absendereinstellungen (Name, Unternehmen, Postanschrift).

Der Server ist unter einer einzigen URL erreichbar, https://www.getaff.org/api/mcp. Die Erkennung (initialize, tools/list) antwortet ohne Zugangsdaten, damit ein Client die Werkzeuge anzeigen kann; jeder Werkzeugaufruf erfordert Zugangsdaten.

Assistenten per OAuth verbinden

Am einfachsten geht es mit OAuth 2.1: nichts zu kopieren, nichts einzufügen. Öffnen Sie in claude.ai Einstellungen › Konnektoren › Benutzerdefinierten Konnektor hinzufügen; fügen Sie in ChatGPT einen Connector (App) hinzu. Geben Sie in beiden Fällen die Server-URL ein. Der Client erhält von GetAff eine 401, folgt den darin verwiesenen Metadaten und öffnet die Zustimmungsseite von GetAff.

1. Melden Sie sich bei GetAff an, falls Sie es noch nicht sind.
2. Lesen Sie die Zustimmungsseite: Sie nennt die Anwendung, wohin sie Sie zurückleitet und was sie tun darf.
3. Haken Sie die Berechtigungen (Scopes) an, die Sie erteilen möchten. spend ist nie vorab angehakt.
4. Bestätigen Sie. Der Konnektor ist bereit; das Token ist an den MCP-Server gebunden und wird von der REST-API abgelehnt.

Zugriffstoken gelten eine Stunde; Refresh-Token gelten 30 Tage und werden bei jeder Nutzung erneuert. Sie können eine Anwendung jederzeit unter Kontoeinstellungen › API › Verbundene Anwendungen trennen.

Alternativ mit einem API-Schlüssel

Clients ohne OAuth-Unterstützung – oder Skripte – authentifizieren sich mit einem API-Schlüssel (gaff_live_…), den Sie auf der Seite API-Schlüssel erstellen. Mit Claude Code genügt ein Befehl:

claude mcp add --transport http getaff https://www.getaff.org/api/mcp \
  --header "Authorization: Bearer $GETAFF_API_KEY"

In Cursor deklarieren Sie den Server in ~/.cursor/mcp.json; der Schlüssel wird aus Ihrer Umgebung gelesen:

{
  "mcpServers": {
    "getaff": {
      "url": "https://www.getaff.org/api/mcp",
      "headers": { "Authorization": "Bearer ${env:GETAFF_API_KEY}" }
    }
  }
}

Die MCP-Dokumentation enthält die Konfigurationen für Claude Desktop, VS Code und die OpenAI-API. Bewahren Sie den Schlüssel in einer Umgebungsvariablen oder im Secret-Speicher des Clients auf, niemals in einer gemeinsam genutzten Konfigurationsdatei.

Die Scopes wählen

Scopes legen fest, was der Assistent darf. Keiner schließt einen anderen ein, außer read, das alle Zugangsdaten mitbringen.

• read – Websites, Kriterien, Ergebnisse, Auswahl, Interessenten, Sequenzen.
• search – Suchen, die keine Credits verbrauchen: kostenlose Quellen der Partnersuche, der Creator-Index, ähnliche Creator, Wettbewerberabfragen, Gesprächsrunden.
• write – Änderungen an Ihren Daten: Kriterien, Auswahl, Interessenten, Wettbewerber, Aufnahme in eine Sequenz.
• spend – Credits der Anbieter: Live-Suchen und kostenpflichtige E-Mail-Suchen, stets zusätzlich hinter einer Bestätigung.

Ein sinnvoller Start ist read search write: Der Assistent kann suchen, bewerten und vormerken, alles Kostenpflichtige bleibt aber außer Reichweite. Braucht er später spend, erhält ein OAuth-Client eine 403 insufficient_scope und kann Sie bitten, den Scope zu erteilen – eine Erweiterung, die Sie auf der Zustimmungsseite bestätigen.

Der Ablauf, Werkzeug für Werkzeug

Sie müssen die Werkzeuge nicht nennen: Der Assistent liest ihre Beschreibungen und wählt selbst. Wer die Reihenfolge kennt, schreibt bessere Prompts und kann nachprüfen, was der Assistent getan hat.

1. list_sites – Ihre Websites und das Programm jeder Website. Der Assistent ruft es zuerst auf, weil alle anderen Werkzeuge eine siteId benötigen.
2. get_criteria (optional) – die Keywords, Nischen, Plattformen, Länder, Sprachen, Reichweitenklassen und die Aktualität, die die nächste Suche verwendet, sowie die Themenbegriffe, auf die das Ranking abgleicht. update_criteria ändert sie.
3. search_partners – eine Suche über alle Quellen, zusammengeführt und für Ihr Programm sortiert, jeder Creator mit einem Passungswert von 0 bis 100.
4. explain_ranking – warum ein Creator dort steht, wo er steht: Themenübereinstimmung, Markt, Sprache, Reichweite, jüngste Aktivität, Hinweise aus dem Wettbewerb, Ähnlichkeit mit Ihrer Auswahl.
5. shortlist_add – merkt Creator der letzten Suche über ihren key vor (zum Beispiel instagram:1784140). Die Auswahl fasst 100.
6. shortlist_to_prospects – macht ausgewählte Creator zu privaten Interessenten. Kostenlos; zählt auf das Entdeckungskontingent Ihres Tarifs.
7. find_emails – kostenpflichtige Abfragen bei den Creator-Datenanbietern für Interessenten ohne Adresse (Pro), mit Kostenbestätigung.
8. enrol_in_sequence – plant die dreistufige Ansprache-Sequenz für einen Interessenten aus Ihrem verbundenen Postfach, nach einer Bestätigung.

Prompts, die funktionieren

Seien Sie konkret bei Markt, Zielgruppe und nächstem Schritt. Einige Prompts, die sich direkt auf den Ablauf abbilden:

• „Liste meine GetAff-Websites auf und zeig mir dann die Kriterien der ersten.“
• „Suche für meine Website zur Hochzeitsplanung Partner in Frankreich und Belgien, auf Instagram und YouTube, mit Micro- und Mid-Tier-Reichweite. Nur kostenlose Quellen.“
• „Warum steht der dritte Creator vor dem fünften? Erkläre beide Rankings.“
• „Füge die fünf Creator mit der stärksten Themenübereinstimmung zu meiner Auswahl hinzu und mach die Auswahl dann zu Interessenten.“
• „Finde die E-Mail-Adressen dieser Interessenten. Nenn mir zuerst die Kosten.“
• „Bereite die Ansprache-Sequenz für den ersten Interessenten vor und zeig mir die Zusammenfassung, bevor du irgendetwas planst.“

Wirken Ergebnisse themenfremd, sagen Sie es: „Markiere den Begriff Budget als themenfremd und suche erneut“ entspricht correct_topic_term, und die nächste Suche berücksichtigt Ihre Korrektur im Ranking.

Kosten und Versand werden immer bestätigt

Zwei Arten von Werkzeugen wirken über Ihre eigenen Daten hinaus: solche, die Anbieter-Credits verbrauchen (search_partners mit includeLive, find_emails), und das eine, das echte E-Mails plant (enrol_in_sequence). Beide folgen denselben zwei Schritten.

1. Der erste Aufruf gibt nichts aus und plant nichts. Er liefert eine Schätzung – Credits, Anbieter, was heute noch übrig ist – oder eine Zusammenfassung der Sequenz (Interessent, Postfach, Entwurf), zusammen mit einem confirmToken.
2. Der Assistent zeigt Ihnen die Kosten oder die Zusammenfassung und wartet auf ein ausdrückliches Ja.
3. Derselbe Aufruf mit denselben Argumenten plus confirmToken wird ausgeführt – und verbraucht höchstens die bestätigten Credits.

Das Token ist an Ihre Zugangsdaten, das Werkzeug und die exakten Argumente gebunden und läuft nach 15 Minuten ab. Ein wiederholter bestätigter Aufruf liefert sein erstes Ergebnis erneut, statt doppelt zu bezahlen.

{ "name": "find_emails",
  "arguments": { "ids": ["kJ2p8wQxYb_ig_1784140"], "confirmToken": "gcf_…" } }

Was der Server nicht tut

• Credits ohne ein Bestätigungstoken ausgeben, das für genau diesen Aufruf ausgestellt wurde.
• Direkt eine E-Mail senden: Die Aufnahme plant nur eine Sequenz, nach allen Prüfungen der App – gültige und nicht gesperrte Adresse, Compliance-Regeln des Empfängerlandes, vollständige Absendereinstellungen, ein veröffentlichtes Programm.
• Eine Browsersitzung akzeptieren: Nur ein API-Schlüssel oder ein für diesen Server ausgestelltes OAuth-Token authentifiziert.
• Einen Schlüssel, ein Token oder Netzwerk-Zugangsdaten in einem Werkzeugergebnis zurückgeben.
• Creator-Texte als Anweisungen ausgeben: Namen, Handles und Bios stammen aus öffentlichen Profilen und sind in jedem Ergebnis als Daten Dritter gekennzeichnet.

Die Limits Ihres Tarifs gelten für den Assistenten genau so wie für Sie in der App: dieselben Tageskontingente, dasselbe Entdeckungskontingent, dieselben Ratenbegrenzungen. Ein Assistent ist nie ein Weg, sie zu umgehen.

Weiterführend

Der Assistent erfährt erst dann, dass eine Suche beendet ist oder ein Interessent geantwortet hat, wenn er erneut ein Werkzeug aufruft. Für eine Integration, die selbstständig reagieren soll, registrieren Sie einen Webhook. Für einen geplanten Job ohne Assistenten gibt es dieselben Operationen über die REST-API.