KI-Agenten über MCP verbinden

Client auswählen

Endpunkt: https://mcp.fairvalid.com/mcp. Transport: Streamable HTTP.

Verbinden Sie sich per API-Schlüssel oder OAuth-Anmeldung. Berechtigte ChatGPT-, Claude- und Grok-Verbindungen können OAuth nutzen; die Konto- und Rollenanforderungen Ihres Clients finden Sie unten. Codex, Claude Code und Hermes unterstützen außerdem direkte Verbindungen per API-Schlüssel.

Erstellen Sie für API-Key-Clients als Owner oder Manager des Workspace unter API-Schlüssel einen benannten Test-Key. Speichern Sie ihn in den geschützten Zugangsdaten des Clients oder in den dokumentierten Umgebungseinstellungen. Fügen Sie einen Key niemals in einen Prompt, ein Tool-Argument, eine URL oder eine eingecheckte Konfiguration ein.

Der OAuth-Ablauf öffnet fairvalid.com für Anmeldung und Zustimmung. Sie wählen einen vorhandenen Live-API-Schlüssel, der die angeforderten Berechtigungen abdeckt, und prüfen dessen Workspace und Gesamtlimit. Mit der Freigabe werden die angeforderten Berechtigungen gemeinsam erteilt, im Rahmen der Scopes dieses Schlüssels. Sie müssen den Schlüssel nicht in den KI-Client einfügen. Wird der ausgewählte Schlüssel widerrufen, enden auch seine Verbindungen. OAuth verwendet Live-Schlüssel; nutzen Sie für die Sandbox eine direkte Verbindung mit einem Testschlüssel.

Client-Anleitungen überprüft am 23. Oktober 2026. Das gehostete MCP-Protokoll hat die Produktionsabnahme mit dem offiziellen SDK bestanden. Das bedeutet nicht, dass jeder genannte Client getestet wurde; führen Sie den Verbindungstest in Ihrem Client durch, bevor Sie sich darauf verlassen.

ChatGPT

Verwenden Sie die folgende OAuth-Einrichtung. Aktuelle benutzerdefinierte MCP-Verbindungen erfordern ChatGPT Business oder Enterprise/Edu im Web sowie die Berechtigung, Plugins mit MCPs zu erstellen. Bei Business ist ein Admin oder Owner erforderlich; bei Enterprise/Edu können ausgewählte Mitglieder berechtigt werden.

1. Öffnen Sie Plugins, wählen Sie die Plus-Schaltfläche und dann Add custom MCP server. Der aktuelle Plugins-Ablauf erfordert keinen Developer Mode.
2. Nennen Sie die Verbindung FairValid und geben Sie https://mcp.fairvalid.com/mcp als öffentlichen HTTPS-Endpunkt ein.
3. Wählen Sie OAuth mit automatischer Client-Registrierung. FairValid verwendet eine öffentliche Client-Registrierung: Sie müssen weder eine Client-ID noch ein Client-Secret angeben. Geben Sie in keines der beiden Felder einen API-Schlüssel ein.
4. Schließen Sie die oben beschriebene Anmeldung und Einwilligung bei FairValid ab. Lesen Sie die Warnung von ChatGPT, wählen Sie dann „Als Plugin erstellen“ und sehen Sie sich die sechs erkannten Tools an.
5. Installieren Sie das Plugin, öffnen Sie eine neue Unterhaltung, geben Sie @ ein und wählen Sie FairValid aus. Führen Sie die unten stehende schreibgeschützte Verbindungsprüfung durch, bevor Sie eine Live-Verifizierung anfordern.

Offizielle Dokumentation: OpenAI: einen benutzerdefinierten MCP-Server verbinden · OpenAI: OAuth-Authentifizierung

Claude Web und Desktop

Verwenden Sie einen benutzerdefinierten Remote-Connector mit OAuth. Dies ist dieselbe kontogebundene Verbindung in Claude im Web und in Claude Desktop; sie läuft über die Server von Anthropic. Bei Team und Enterprise fügt zuerst ein Owner der Organisation den Connector hinzu. Enterprise-Mitglieder mit einer benutzerdefinierten Rolle, die Organisationsbibliotheken verwalten darf, können ihn ebenfalls hinzufügen.

Some organizations have a Request headers beta. For that alternative, choose No sign-in and add a required Authorization header with the full value Bearer <your FairValid API key>. If Request headers is absent, use OAuth or the Claude Code instructions below. The API key is not an OAuth client secret.

1. Öffnen Sie Customize → Connectors → Add custom connector. Bei einer verwalteten Organisation beginnt ein Owner oder eine berechtigte Enterprise-Rolle unter Organization settings → Connectors → Add → Custom → Web.
2. Geben Sie FairValid und https://mcp.fairvalid.com/mcp ein.
3. Wählen Sie „Jetzt anmelden“. Falls eine Auswahl für den OAuth-Client erscheint, wählen Sie „Automatisch registrieren“. Lassen Sie die Felder für manuell registrierte Client-ID und Secret leer.
4. Melden Sie sich auf fairvalid.com an, überprüfen Sie den ausgewählten Live-Schlüssel und die Berechtigungen und genehmigen Sie die Verbindung. Aktivieren Sie FairValid über die Connector-Einstellungen der Unterhaltung.
5. Führen Sie die unten stehende schreibgeschützte Verbindungsprüfung aus. Verwenden Sie die Sandbox-Prüfung nur, wenn Sie die Verbindung mit einem Test-API-Schlüssel über Request-Header hergestellt haben.

Offizielle Dokumentation: Anthropic: Benutzerdefinierte Connectors und Authentifizierung · Anthropic: Verfügbarkeit von Remote-Connectors

Claude Code

Claude Code unterstützt eine direkte Verbindung per API-Schlüssel. Setzen Sie FAIRVALID_API_KEY in der Umgebung, aus der Claude Code gestartet wird, und verwenden Sie für die erste Prüfung einen Test-Schlüssel. Bewahren Sie das eigentliche Secret nicht in Projektdateien auf.

1. Fügen Sie die folgende Konfiguration in die .mcp.json des Projekts ein. Behalten Sie vorhandene Server bei. Der literale Umgebungsverweis gehört in die Datei, der Wert des Schlüssels jedoch nicht.
2. Starten Sie Claude Code mit verfügbarem FAIRVALID_API_KEY. Bestätigen Sie die MCP-Konfiguration des Projekts, falls Sie dazu aufgefordert werden.
3. Führen Sie claude mcp list aus und prüfen Sie anschließend /mcp in der Sitzung. Vergewissern Sie sich, dass FairValid verbunden ist und sechs Tools bereitstellt, und führen Sie dann die Sandbox-Prüfung unten durch.

{
  "mcpServers": {
    "fairvalid": {
      "type": "http",
      "url": "https://mcp.fairvalid.com/mcp",
      "headers": {
        "Authorization": "Bearer ${FAIRVALID_API_KEY}"
      }
    }
  }
}

Offizielle Dokumentation: Anthropic: MCP-Konfiguration für Claude Code

Hermes Agent

Diese Anleitung gilt für NousResearch Hermes Agent. Dessen Remote-HTTP-Transport unterstützt Bearer-Header. Die CLI speichert den Schlüssel in der .env-Datei Ihres aktiven Profils als MCP_FAIRVALID_API_KEY und hinterlegt in config.yaml einen Verweis auf die Umgebungsvariable.

1. Führen Sie den unten stehenden Befehl zum Hinzufügen aus. Antworten Sie mit „yes“, wenn gefragt wird, ob eine Authentifizierung erforderlich ist, und geben Sie dann in der maskierten Eingabeaufforderung „API key / Bearer token“ einen Test-API-Schlüssel ein.
2. Prüfen Sie die erkannten Tools und aktivieren Sie die benötigten FairValid-Tools. Die Einrichtung muss erfolgreich eine Verbindung herstellen; das Speichern einer deaktivierten Verbindung nach einem Fehler gilt nicht als erfolgreiche Einrichtung.
3. Führen Sie hermes mcp test fairvalid aus und starten Sie dann eine neue Sitzung oder führen Sie /reload-mcp aus. Führen Sie die Sandbox-Prüfung unten durch. Hermes stellt den Tool-Namen möglicherweise sein Server-Namenspräfix voran.

hermes mcp add fairvalid \
  --url https://mcp.fairvalid.com/mcp \
  --auth header

hermes mcp test fairvalid

Offizielle Dokumentation: NousResearch: MCP-Konfiguration · NousResearch: MCP-Verbindungsprüfungen · NousResearch: CLI-Implementierung mit Header-Authentifizierung

Grok Bot und Grok

Grok Bot und Grok.com werden an unterschiedlichen Stellen eingerichtet. Bitten Sie in einem persönlichen Grok Bot den Bot mit der unten stehenden Anfrage, FairValid hinzuzufügen. Dieser Weg funktioniert auch, wenn der Infobereich nur „Details“, „Bibliothek“ und „Computer“ anzeigt und es keinen Abschnitt „Einrichtung“ gibt.

Bei Team Bots steht dem Besitzer oder den Managern des Bots zusätzlich Infobereich → Einrichtung → Plugins zur Verfügung. Diese Einrichtungsoberfläche erfordert Team-Bot-Zugriff in der Desktop-App. Bei Verwendung von OAuth meldet sich jedes Teammitglied mit seinem eigenen Konto an.

Grok.com verwendet grok.com/connectors → Neuer Connector → Benutzerdefiniert. Geben Sie https://mcp.fairvalid.com/mcp ein und schließen Sie die Authentifizierung ab. Bei Business- und Enterprise-Teams muss der Connector möglicherweise zuerst von der Administration bereitgestellt werden. Diese Verbindung ist von einem Grok-Bot-Plugin unabhängig.

Ein mit der xAI API erstellter Bot ist ebenfalls davon getrennt: Sein Entwickler konfiguriert Remote-MCP-Header im Servercode. Diese Anleitung behauptet nicht, dass Grok Bot ein allgemeines Feld für den Authorization-Header bietet.

1. Bitten Sie Ihren Bot, die benutzerdefinierte Remote-HTTPS-MCP-Verbindung mit der folgenden Anfrage hinzuzufügen. Bei einem Team-Bot kann auch dessen Inhaber oder Manager Setup → Plugins verwenden.
2. When the Bot shows the FairValid authorization card, select Authorize to open OAuth sign-in. Keep API keys out of the request and any server command.
3. Erteilen Sie die FairValid-Einwilligung auf fairvalid.com. Wo erforderlich, verbindet jedes Teammitglied sein eigenes Konto.
4. Bitten Sie den Bot, die Tools von FairValid aufzulisten und die unten stehende schreibgeschützte Verbindungsprüfung auszuführen. Das bloße Erkennen der Tools belegt nicht, dass eine Verifizierung abgeschlossen wurde.

Add FairValid as a custom Remote HTTPS MCP server at
https://mcp.fairvalid.com/mcp using OAuth.
Show me the sign-in flow, then list its tools.
Do not submit any email verification yet.

Offizielle Dokumentation: xAI: Grok-Bot-Plugins und Remote-HTTPS · xAI: benutzerdefinierte Connectors für Grok.com · xAI: Remote-MCP für API-Entwickler

Codex

Verwenden Sie in Codex eine direkte Verbindung per API-Schlüssel. Setzen Sie FAIRVALID_API_KEY in der Umgebung, die dem Codex-Prozess zur Verfügung steht, und verwenden Sie für Ihre erste Prüfung einen Test-Schlüssel. Eine unabhängig gestartete Desktop-App übernimmt die Umgebung Ihres Terminals möglicherweise nicht.

1. Führen Sie den unten stehenden Befehl aus, um den Remote-Server für Streamable HTTP zu registrieren. Der Befehl speichert den Namen der Umgebungsvariablen, nicht den API-Schlüssel.
2. Führen Sie codex mcp list aus und starten Sie eine neue Codex-Sitzung, damit die Verbindung geladen wird. Vergewissern Sie sich, dass FairValid unter den MCP-Tools der Sitzung erscheint.
3. Wenn Sie die Codex-App verwenden, stellen Sie die Variable ihrem Ausführungshost zur Verfügung und starten Sie die App bei Bedarf neu oder öffnen Sie eine neue Sitzung. Gehen Sie nicht davon aus, dass eine erfolgreiche CLI-Einrichtung die Umgebung einer bereits laufenden App geändert hat.
4. Bestätigen Sie sechs erkannte Tools und führen Sie unten die Sandbox-Prüfung durch.

codex mcp add fairvalid \
  --url https://mcp.fairvalid.com/mcp \
  --bearer-token-env-var FAIRVALID_API_KEY

codex mcp list

Offizielle Dokumentation: OpenAI: Codex-MCP-Konfiguration

Prüfen Sie die Verbindung, bevor Sie Aufträge einreichen

Vergewissern Sie sich, dass alle sechs unten aufgeführten Tools erkannt werden. Ein Client kann den Tool-Namen ein eigenes Präfix voranstellen. Die Erkennung bestätigt eine Verbindung, nicht eine erfolgreiche Verifizierung.

Erteilen Sie bei OAuth oder einem Live-API-Schlüssel die Berechtigung für das Guthaben und bitten Sie den Agenten zunächst, fairvalid_get_balance ohne Argumente aufzurufen. Das Abrufen des Guthabens verbraucht keine Verifizierungs-Credits. Senden Sie die Sandbox-Beispiele nicht über eine Live-Verbindung.

Folgen Sie bei einem Test-API-Schlüssel stattdessen der Sandbox-Prüfung unten. Eine Live-Verifizierung kann Credits reservieren und verbrauchen; wählen Sie eine Adresse, deren Prüfung Ihnen erlaubt ist, und fordern Sie die Übermittlung ausdrücklich an.

Wenn eine Verbindung fehlschlägt, prüfen Sie die Connector-Berechtigungen des Kontos, den Endpunkt, fehlende Umgebungsvariablen sowie einen möglichen Widerruf des Schlüssels oder der Freigabe. Überprüfen Sie bei Berechtigungs- oder Ausgabenlimit-Fehlern vor einem erneuten Versuch die erteilten Berechtigungen bzw. das Limit; ein neuer Idempotenzschlüssel behebt die Ursache nicht.

Mit einer kostenlosen Sandbox-Prüfung starten

Verwenden Sie einen fv_test_-Schlüssel und rufen Sie fairvalid_verify_email mit dem folgenden Beispiel auf. Die Einzeladressprüfung mit Test-Schlüssel liefert direkt ein simuliertes Ergebnis. Sie führt keinen Anbieteraufruf aus, erstellt keine Live-Verifizierung und verbraucht keine Credits.

Weitere reservierte Beispiele sind undeliverable@example.com, risky@example.com, unknown@example.com, pending@example.com und error@example.com. „Pending“ und „Error“ sind bewusste Simulationen, keine echten Postfachprüfungen. Für das Pending-Beispiel mit einer einzelnen Adresse gibt es keinen Auftrag, der abgefragt werden kann.

{
  "email": "deliverable@example.com",
  "idempotency_key": "agent-demo-2026-10-23"
}

Tools und Berechtigungen

fairvalid_verify_email erwartet email und idempotency_key. fairvalid_submit_job erwartet emails, idempotency_key und optional name, für 1 bis 5.000 Adressen. Live-Übermittlungen erfordern den Scope submit.

fairvalid_get_job erwartet job_id, um den Status abzurufen. fairvalid_get_results erwartet job_id sowie optional cursor, filter und search, um bis zu 50 Ergebnisse auf einmal abzurufen. Live-Abfragen erfordern den Scope read.

fairvalid_cancel_job erwartet job_id und fordert den Abbruch an; bereits laufende Prüfungen können noch abgeschlossen werden. Ein Live-Abbruch erfordert den Scope submit. fairvalid_get_balance erwartet keine Argumente und erfordert einen Live-Schlüssel mit dem Scope balance. Testschlüssel können kein Live-Credit-Guthaben abrufen.

Der Schlüssel bestimmt den Workspace. Tools akzeptieren kein Argument für API-Schlüssel oder Workspace. Berechtigungsprüfungen, Widerruf, Ausgabenlimits und die Credit-Regeln des Workspace gelten für MCP genauso wie für die Kunden-API.

Einen laufenden Job bis zu den Ergebnissen verfolgen

Bei OAuth oder einem fv_live_-Schlüssel übermitteln sowohl die Einzel- als auch die Massenverifizierung asynchrone Jobs. Eine angenommene Antwort und eine job_id bedeuten, dass die Arbeit angenommen wurde, nicht dass die Postfachprüfung abgeschlossen ist. Die Bearbeitungszeit hängt von der Warteschlange und dem Verifizierungsanbieter ab.

Um den Job-Ablauf in der Sandbox zu testen, rufen Sie fairvalid_submit_job mit reservierten Beispieladressen auf. Sandbox-Jobs unterstützen Status, Ergebnisse, Abbruch und Wiederholung – ohne Anbieteraufrufe und ohne Credit-Verbrauch.

1. Übermitteln Sie einmalig mit einem stabilen idempotency_key und speichern Sie die zurückgegebene job_id.
2. Rufen Sie fairvalid_get_job mit dieser job_id auf. Senden Sie Abfragen in Abständen und verlängern Sie die Wartezeit bei vorübergehenden Fehlern.
3. Rufen Sie fairvalid_get_results mit derselben job_id auf. Übergeben Sie jeden next_cursor als cursor, bis next_cursor null ist. Ein Cursor behält den ursprünglichen Filter und die Suche bei.
4. Prüfen Sie sowohl den Auftragsstatus als auch jedes einzelne Ergebnis. Die Ergebnisse „Unbekannt“, „Catch-all“ und „Wird noch geprüft“ belegen nicht, dass ein Postfach gültig ist.

Erneut versuchen, ohne doppelte Vorgänge zu erzeugen

Beide Übermittlungstools erfordern einen idempotency_key aus 8 bis 128 Buchstaben, Ziffern, Punkten, Doppelpunkten, Unterstrichen oder Bindestrichen. Wiederholen Sie eine unsichere Antwort mit demselben API-Schlüssel bzw. derselben OAuth-Verbindung, demselben idempotency_key und unveränderter Eingabe. Die Wiederholung ist an den zugrunde liegenden API-Schlüssel gebunden: Beim Rotieren eines OAuth-Zugriffstokens bleibt diese Identität erhalten, doch wenn Sie einen anderen API-Schlüssel wählen und erneut senden, kann ein weiterer Durchlauf entstehen. Eine geänderte Job-Nutzlast mit einem bereits verwendeten Idempotenzschlüssel wird abgelehnt. Verwenden Sie einen neuen Idempotenzschlüssel nur für einen bewusst neuen Durchlauf.

Prüfen Sie isError, bevor Sie das Ergebnis auslesen. Aufrufe, die die Kunden-API erreichen, enthalten deren Antwort und HTTP-Status in structuredContent; Fehler bei der Argumentvalidierung liefern unter Umständen nur Textinhalt. Prüfen Sie den code eines API-Fehlers und beachten Sie etwaige Hinweise zur Wiederholung. Eine Zeitüberschreitung oder ein vorübergehender Fehler beweist nicht, dass die ursprüngliche Übermittlung nicht erfolgt ist.

Live-Schlüssel können Workspace-Credits verbrauchen. Legen Sie ein Gesamtlimit fest, bevor Sie einen autonomen Agenten verbinden: Sowohl abgebuchte als auch reservierte Credits werden angerechnet. Abgeschlossene Prüfungen mit dem Ergebnis gültig oder ungültig verbrauchen einen Credit; für unbekannte, ungeklärte Catch-all-Ergebnisse und technische Fehler fällt netto keine Abbuchung für die Verifizierung an.