Überspringen zum Inhalt
DE
API-Schlüssel
Dokumentation durchsuchen

Erste Schritte

FlashData MCP

Geben Sie Ihrem Agenten Google Search und YouTube Tools. Verbinden Sie Ihren Gastgeber und fragen Sie nach Ihrem ersten Ergebnis.

Auf dieser Seite

1. Verbinden und anmelden

Wählen Sie Codex oder OpenClaw für browserbasiertes OAuth. Wählen Sie für einen anderen Host den Remote / API-Schlüssel, wenn er Streamable HTTP und benutzerdefinierte Header unterstützt, oder Local / stdio, wenn er MCP-Prozesse startet. Der Hosted Server benötigt keine lokale Installation.

Fügen Sie die Konfiguration unten in ~/.codex/config.toml zusammen und führen Sie dann den Login-Befehl aus. Komplette FlashData-Anmeldung oder -Anmeldung und Zustimmung im Browser. Starten Sie eine neue Codex-Sitzung nach dem Login.

config.toml
[mcp_servers.flashdata]
url = "https://data.flashdata.dev/mcp"

[mcp_servers.flashdata.oauth]
client_id = "flashdata-codex"
callback_url = "http://127.0.0.1/callback"
Anmelden
codex mcp login flashdata --scopes mcp:research

2. Überprüfen Sie die Verbindung

Senden Sie dies in einer frischen Agentensitzung. Erwarten Sie erfolgreiche get_pricing und get_balance Anrufe, einen verfügbaren Preis für google_search und Ihr verfügbares Guthaben. Ein Nullsaldo bedeutet, dass Sie Credits für die Suche benötigen; es bedeutet nicht, dass die Authentifizierung fehlgeschlagen ist.

Anschlussprüfung
Verwenden Sie die vorhandene Flashdata MCP-Verbindung.
Rufen Sie get_pricing mit {"source":"google_search","request_count":1} an.
Rufen Sie get_balance mit {} an.
Geben Sie an, ob beide Anrufe erfolgreich waren, ob die Quelle einen verfügbaren Preis hat;
und den verfügbaren Kreditsaldo. Ein Nullsaldo ist kein Authentifizierungsfehler.
Führen Sie keine Suche aus oder laden Sie sie herunter, erstellen Sie eine Testversion oder ändern Sie Ihre Anmeldeinformationen.

3. Fragen Sie nach Ihrer ersten Aufgabe

Fügen Sie dies in Ihren Connected Agent ein. Die Saldo- und Preisprüfungen sind kostenlos; Die Suche verwendet Kontogutschriften.

Erste Aufgabe prompt
Verwenden Sie FlashData, um mein Guthaben und den Preis einer Google-Suche zu überprüfen. Wenn genügend Credits vorhanden sind, rufen Sie google_search einmal mit der Abfrage "battery recycling research", num 5 und Modus "realtime" auf. Rückgabetitel, Quelle URLs, kurze Auszüge und tatsächliche Credits verwendet. Stoppen Sie nach dieser Aufgabe.

Ergebnis prüfen

Ihr Agent sollte Quellenlinks und Auszüge sowie die tatsächlich verwendeten Credits zurückgeben. Das zugrunde liegende Suchergebnis hat status: done und results[].organic. Ein leeres Ergebnis ist gültig; der Agent sollte es melden. Das folgende Beispiel ist illustrativ.

Beispielantwort
Eine Google Suche abgeschlossen.
1. Batterierecyclingforschung — https://example.org/recycling
   Ein Beispiel-Suchauszug.
Verwendete Credits: 0.02

Verfügbare Werkzeuge

API-Schlüsselaufrufe verwenden die Berechtigungen, die diesem Schlüssel gewährt wurden. Entdecken Sie die Tools und Eingabeschemata des Servers für den vollständigen aktuellen Katalog.

AufgabeWerkzeugZugang
Suche nach Googlegoogle_searchmcp:research / API key
Finden Sie YouTube Videosyoutube_searchmcp:research / API key
Video-Metadaten lesenyoutube_metadatamcp:research / API key
Bestehende Bildunterschriften abrufenyoutube_transcriptmcp:research / API key
Herunterladen von Video oder Audioyoutube_downloadBesitzer API Schlüssel + Zielspeicherung
Konto prüfen und Preisgestaltungget_balance, get_pricing, get_limits, get_usageKostenloses Konto liest

Über OAuth, Berechtigungen und Testversionen

OAuth verbindet Ihr verifiziertes Besitzerkonto und lässt den Host Token speichern und aktualisieren. Der mcp:research-Zuschuss deckt die vier oben genannten Forschungsquellen ab. API-Schlüsselverbindungen verwenden einen geschützten X-API-Key-Header und können andere autorisierte Quellen enthalten.

Um FlashData auszuprobieren, bevor Sie ein Konto erstellen, verwenden Sie den Testablauf von CLI. MCP OAuth verbindet ein Besitzerkonto; es registriert oder beansprucht keine Testversion. Ein CLI-Profil wird nicht automatisch mit Ihrem MCP-Host geteilt.

Fehlerbehebung

ProblemProbieren Sie dies aus
Keine FlashData-ToolsBeenden Sie die Zustimmung, verbinden Sie sich wieder und starten Sie eine neue Sitzung. Überprüfen Sie den URL und den Streamable HTTP Transport.
invalid_client / callback errorVerwenden Sie für Codex oder OpenClaw die genaue Clientkonfiguration und einen Browser, der den lokalen Rückruf erreichen kann. Verwenden Sie für einen anderen Host die oben genannte API-Taste oder Stdio-Einrichtung.
401Der OAuth-Zugriff wurde erneut verbunden oder widerrufen, oder überprüfen Sie den API-Schlüssel, der dem Host zugeführt wurde. Wiederholen Sie den kostenlosen Check.
403Überprüfen Sie die angeforderten Quell- und Schlüsselberechtigungen. YouTube Download erfordert einen Besitzer-API-Schlüssel mit youtube_download und Zielspeicherung; mcp:research enthält ihn nicht.
402Überprüfen Sie Billing und den aktuellen Preis. Das Wiederverbinden eines gültigen Anmelders fügt keine Credits hinzu.
429Folgen Sie Retry-After. Behalten Sie einen vorhandenen Job oder ein Ergebnis ID, bevor Sie entscheiden, ob Sie die Aufgabe erneut versuchen möchten.
Timeout oder unvollständige AntwortBehalten Sie die Anforderung ID und überprüfen Sie History. Lesen Sie Fortsetzungen mit großem Ergebnis mit get_result, anstatt die Suche zu wiederholen.

Weiter gehen