Brave Search MCP einrichten: API-Key und erster Suchtest

Sie möchten aus einer Frage passende Webseiten finden. Beginnen Sie mit einer klaren Suchaufgabe: etwa die offizielle Installationsanleitung eines bestimmten Projekts finden. Notieren Sie vorher die erwartete Herausgeberdomain. So können Sie beim ersten Versuch unterscheiden, ob der Server verbunden ist, ob die Suche antwortet und ob die Antwort tatsächlich zu Ihrer Aufgabe passt. Diese drei Beobachtungen gehören getrennt in Ihr Testprotokoll.

Paket und Suchdienst richtig zuordnen

Das Herstellerprojekt verwendet @brave/brave-search-mcp-server, den Schlüssel BRAVE_API_KEY und das Werkzeug brave_web_search. Das folgende Beispiel wählt ausdrücklich stdio. Der lokale Prozess spricht dabei mit der Brave Search API. Kandidaten finden Sie in der Brave-Suche und im Verzeichnis für Webdaten. Prüfen Sie das Repository des jeweiligen Eintrags, bevor Sie gleichnamige Pakete austauschen.

Die Clientkonfiguration vorbereiten

Für einen Client mit der JSON-Wurzel mcpServers können Sie dieses Beispiel als Ausgangspunkt verwenden. Ersetzen Sie den Platzhalter ausschließlich in Ihrer lokalen Einrichtung. Bewahren Sie bereits vorhandene Serverdefinitionen auf. Der Programmname und seine Argumente stehen in getrennten Feldern. Bei VS Code unterscheidet sich die Wurzel; folgen Sie dafür der VS-Code-Anleitung statt den gesamten Block unverändert zu übernehmen.

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@brave/brave-search-mcp-server",
        "--transport",
        "stdio"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_BRAVE_API_KEY"
      }
    }
  }
}

Prüfen Sie, ob npx in der Umgebung des Clients erreichbar ist. Tragen Sie Clientversion, Betriebssystem und die tatsächlich gestartete Paketversion zu Ihrem Versuch ein. Das Beispiel legt keine Paketversion fest; eine später wiederholte Installation kann daher einen anderen Stand verwenden. Halten Sie nach erfolgreichem Test die verwendete Version fest, bevor Sie die Einrichtung an andere Personen weitergeben. Zugangswerte gehören weder in geteilte Konfigurationsdateien noch in Screenshots.

Einen begrenzten Suchtest durchführen

1. Verbinden Sie den Server und lesen Sie die angebotene Werkzeugliste. Prüfen Sie das Eingabeschema von brave_web_search.

2. Suchen Sie nach einer konkreten öffentlichen Herstelleranleitung. Verwenden Sie bei Wiederholungen zunächst denselben Suchtext.

3. Öffnen Sie eine zurückgegebene Adresse im Browser. Vergleichen Sie Herausgeber, Dokumenttitel und den gesuchten Abschnitt.

4. Notieren Sie Abweichungen, etwa eine veraltete Anleitung, ein fremdes Repository oder einen Treffer ohne den gewünschten Absatz.

Die Rangfolge der Ergebnisse ist keine Prüfung der fachlichen Richtigkeit. Für Ihren Vergleich zählt zunächst, ob eine passende Originalquelle erreichbar ist und die gesuchte Information enthält. Halten Sie Suchantwort und gelesene Fundstelle getrennt fest. Ein Suchauszug kann beim Finden helfen, ersetzt aber die Kontrolle des Dokuments nicht. Für das Lesen einer bereits bekannten URL führt die Fetch-Anleitung weiter.

Startfehler und abgewiesene Anfragen eingrenzen

Wenn keine Werkzeugliste erscheint, untersuchen Sie zuerst Startprogramm und Clientprotokoll. Die ENOENT-Hilfe beschreibt diesen Weg. Wenn die Liste erscheint, aber der Suchaufruf scheitert, prüfen Sie den hinterlegten Zugang im Anbieterbereich und lesen Sie die konkrete Fehlermeldung. Bei einer Begrenzung durch den Dienst sollten Sie nicht mit schnellen Wiederholungen reagieren. Dokumentieren Sie den Fehler und prüfen Sie das für Ihr Konto geltende Kontingent.

Für die Auswahl zwischen mehreren Verfahren lesen Sie den Vergleich von Websuche, Fetch und Browser. Die Tavily-Anleitung bietet einen weiteren Einrichtungsweg mit eigenem Prüfplan. Ein unterschiedliches Ergebnis begründet allein keine allgemeine Qualitätsrangliste; Suchaufgabe, Sprache und Abrufzeit müssen dabei bekannt bleiben.

Brauche ich einen API-Key?

Das gezeigte lokale Beispiel verwendet Ihren Brave-API-Schlüssel. Der Platzhalter ist kein funktionierender Zugang.

Ist das eine Google-Suche?

Das Beispiel nutzt die Brave Search API. Prüfen Sie den tatsächlichen Datenanbieter, wenn Ihre Aufgabe einen bestimmten Suchindex verlangt.

Wurde meine Einrichtung damit getestet?

Nein. Diese Anleitung beschreibt Ihren eigenen Funktionstest. Ein Registereintrag dokumentiert Quellenangaben und ersetzt ihn nicht.

Warum ist der Transport ausdrücklich angegeben?

Der Client soll im Beispiel den lokalen Prozess über stdio ansprechen. Prüfen Sie bei einem anderen Verbindungsweg dessen eigene Konfiguration.

Herstellerquellen am 1. Oktober 2026 geprüft. Die Prüfpläne sind redaktionelle Vorschläge.

1. Brave: MCP-Server und Konfiguration
   Abrufbefehl anzeigen

   curl -s https://github.com/brave/brave-search-mcp-server

Alle Beiträge