Parallel Search MCP in einen Agent integrieren: Suche ohne Key, Webabruf und Kostengrenzen

Parallel Search MCP lässt sich in einen vorhandenen Coding- oder Research-Agent integrieren, ohne einen eigenen Suchdienst zu betreiben oder einen separaten Such-API-Key zu beantragen. Der gehostete Streamable-HTTP-Endpunkt https://search.parallel.ai/mcp stellt dem Agent zwei Tools bereit: web_search und web_fetch.

Eine gespeicherte Konfiguration ist noch kein Funktionsnachweis. Prüfe den Verbindungsstatus, die sichtbaren Tools, die tatsächlichen Tool-Call-Ereignisse und die zurückgegebenen, erreichbaren Quell-URLs. Die folgenden Angaben wurden am 11. Oktober 2026 auf geöffneten offiziellen Seiten geprüft; maßgeblich bleiben deine eigenen Client-Logs und Abrechnungsseiten.

Zuerst Endpunkt und Authentifizierung wählen

Ziel	Endpoint	Authentifizierung	Geeignet für
Suche und Abruf zunächst testen	https://search.parallel.ai/mcp	Keine	Leichte anonyme Nutzung mit niedrigeren Rate Limits
Kontoguthaben und höhere Limits verwenden	https://search.parallel.ai/mcp	Bearer API Key	Regelmäßige oder produktive Last
Browser-Login durch den Client verwalten lassen	https://search.parallel.ai/mcp-oauth	OAuth oder Bearer API Key	Kein fester Key in geteilter Konfiguration

Der Standard-Endpunkt /mcp bewirbt OAuth nicht. Ein OAuth-fähiger Client kann sich deshalb anonym verbinden, ohne ein Browserfenster zu öffnen. /mcp-oauth verlangt dagegen Authentifizierung und antwortet auf anonyme Anfragen mit 401. Kein Login-Fenster bei /mcp ist also kein Fehler; ein 401 bei /mcp-oauth deutet meist auf eine noch nicht abgeschlossene Autorisierung hin.

Client, Web-Tool und Modell-Provider getrennt betrachten

Eine Antwort kann drei unabhängige Verbindungen nutzen:

1. Der Agent-Client verwaltet Gespräch, Berechtigungen und Tool-Auswahl.
2. Parallel Search MCP führt web_search und web_fetch aus.
3. Der Modell-Provider übernimmt das Reasoning und berechnet Eingabe-, Ausgabe- und Tool-Result-Kontexttokens.

MCP ersetzt nicht die Base URL des Modells. Ein anderer Modell-Provider fügt auch nicht automatisch Websuche hinzu. Bei Fehlern sind deshalb drei Fragen getrennt zu beantworten: Ist der Client mit MCP verbunden? Wurde das richtige Tool tatsächlich aufgerufen? Welcher Provider hat den Modellaufruf berechnet?

Claude Code: mit dem anonymen Endpunkt starten

Führe im Projektverzeichnis von Claude Code aus:

claude mcp add --transport http "Parallel-Search-MCP" https://search.parallel.ai/mcp
claude mcp get "Parallel-Search-MCP"
claude mcp list

Standardmäßig wird der Server im local scope gespeichert. Ergänze --scope user nur dann, wenn er absichtlich in allen Projekten verfügbar sein soll. Prüfe eine gemeinsam genutzte .mcp.json vor dem Commit und speichere dort keinen festen Bearer token.

Öffne in Claude Code den MCP-Bereich:

/mcp

Added bedeutet nur, dass die Konfiguration geschrieben wurde. Der nützliche Nachweis ist Connected, also eine erreichbare Verbindung im aktuellen Client. Für OAuth verwende stattdessen:

https://search.parallel.ai/mcp-oauth

Schließe die Autorisierung über /mcp ab. Vermische bei der Fehlersuche /mcp und /mcp-oauth nicht.

Codex CLI: anonym, Bearer aus einer Umgebungsvariable oder OAuth

Anonyme Einrichtung:

codex mcp add parallel-search --url https://search.parallel.ai/mcp
codex mcp list

Für kontobasierte Limits speicherst du PARALLEL_API_KEY sicher im Betriebssystem oder Secret Manager. Übergib Codex nur den Variablennamen, nicht den echten Wert in der Shell-History oder einer gemeinsam genutzten Datei:

codex mcp add parallel-search --url https://search.parallel.ai/mcp \
  --bearer-token-env-var PARALLEL_API_KEY
codex mcp list

OAuth-Einrichtung:

codex mcp add parallel-search --url https://search.parallel.ai/mcp-oauth
codex mcp list

Starte nach dem Hinzufügen eine neue Codex-Sitzung. Andere MCP-Clients können denselben Endpoint nutzen, aber ihre Schemas unterscheiden sich. VS Code verwendet oben servers, Cursor häufig mcpServers, und manche Clients benötigen type: "streamable-http". Kopiere die JSON-Konfiguration eines Clients nicht ungeprüft in einen anderen.

Nachweisen, welches Tool tatsächlich aufgerufen wurde

Ein verbundener Server beweist nur Erreichbarkeit. Nutze für einen konkreten Antwortlauf einen Prompt, der beobachtbare Spuren erzeugt:

Verwende für diese Prüfung zwingend Parallel-Search-MCP und antworte nicht aus dem Gedächtnis.
1. Rufe web_search auf, um die offizielle Parallel-Search-MCP-Dokumentation und die aktuelle Preisseite zu finden.
2. Zeige die von web_search gelieferten Quell-URLs.
3. Wähle zwei offizielle URLs und rufe web_fetch auf, um den Originaltext zu lesen.
4. Nenne für jede Quelle Tool-Name, URL und einen kurzen Beleg.
Wenn ein Tool-Aufruf fehlschlägt, stoppe und melde Tool-Name, Endpoint und HTTP-Status.

Prüfe anschließend vier Ebenen:

• Im Tool-Trace erscheint web_search.
• Danach folgt ein eigener web_fetch-Aufruf, nicht nur eine Zusammenfassung von Such-Snippets.
• Das Tool-Ergebnis enthält echte, erreichbare URLs.
• Die abschließende Aussage steht im abgerufenen Seitentext.

„Ich habe im Web gesucht“ ist kein Nachweis. Falls der Client seine integrierte Websuche vorübergehend deaktivieren kann, schalte sie nur für diesen isolierten Test aus, damit zwei ähnliche Tools nicht verwechselt werden.

Erst suchen, dann die Originalseiten abrufen

Die offizielle Rollenverteilung ist eindeutig:

• web_search findet aktuelle Informationen und unterschiedliche Quellen. Erforderlich sind objective und search_queries.
• web_fetch liest bekannte URLs oder prüft ausgewählte Treffer. Pro Anfrage sind bis zu 20 URLs möglich.

Wenn der Client Tool-Argumente beeinflussen lässt:

1. Formuliere in objective genau eine Entscheidung, etwa „offizielle Regeln für anonymen Zugriff und Kostengrenzen prüfen“.
2. Verwende zwei oder drei kurze, ergänzende search_queries; kopiere nicht den vollständigen Prompt hinein.
3. Nutze innerhalb einer Unterhaltung dieselbe session_id und für eine neue Unterhaltung einen neuen Wert.
4. Beginne mit full_content: false. Vollständige Seiten können Zehntausende Modell-Tokens beanspruchen und das Ausgabelimit des Clients überschreiten.
5. Bevorzuge offizielle Dokumentation, Spezifikationen und Primärmeldungen. Community-Beiträge sind Nutzerberichte, keine allgemeingültige Plattformzusage.

Der Ablauf Suche → URL-Auswahl → Originalabruf → Quellenprüfung ist besser auditierbar als die allgemeine Anweisung „such das im Internet“.

Kostengrenzen: mindestens vier getrennte Konten führen

Die folgenden Preise wurden am 11. Oktober 2026 auf der offiziellen Parallel-Preisseite geprüft. Sie erklären Abrechnungsgrenzen und sind keine Aussage, dass eine Option immer günstiger ist.

Kostenebene	Abo oder Mitgliedschaft	Mindestaufladung	Guthaben im ersten Monat	Nutzungsbasis
Anonymer Search MCP	Die dokumentierte anonyme Einrichtung verlangt kein Konto-Abo	Keine Aufladung zum anonymen Start	Keine feste Zahl an Aufrufen veröffentlicht	Als kostenlos für Exploration und leichte Nutzung beschrieben, jedoch mit niedrigeren Limits
Authentifiziertes Parallel Search/Extract	Auf der öffentlichen Preisseite ist keine separate Mitgliedsgebühr angegeben	Nicht angegeben	Kein festes Startguthaben angegeben	Search-Grundpreis (10 Ergebnisse je Request enthalten): fast/turbo US$1 je 1.000 Requests; basic/advanced US$5; zusätzliche Seitenergebnisse und Auszüge: US$1 je 1.000 Ergebnisse; Extract: US$1 je 1.000 URLs
Agent-Client	Hängt von Claude Code, Codex oder anderem Client ab	Client-spezifisch	Client-spezifisch	Client-Planleistungen sind keine Parallel-Credits
Modell-API	Provider-spezifisch	Provider-spezifisch	Provider-spezifisch	Eingabe, Ausgabe, Cache und Tool-Result-Kontext werden getrennt vom Search MCP berechnet

Die Search-MCP-Seite veröffentlicht keine feste numerische anonyme Quote. Aus „lower rate limits“ darf keine erfundene Zusage wie „N kostenlose Suchen pro Tag“ werden. Auch die allgemeine Search-API-Rate-Limit-Tabelle ist keine Garantie für anonymes MCP.

Liefert eine authentifizierte Verbindung 402, ordnet die Parallel-Dokumentation das unzureichenden Credits zu. Prüfe Guthaben und aktiven Verbindungsmodus, bevor du erneut versuchst.

BetterToken als Modell-Provider bleibt eine separate Konfiguration

Claude Code oder Codex können den Modellaufruf bereits über BetterToken senden und Parallel zusätzlich nur als Web-Tool-Schicht nutzen:

• Bei Claude Code über BetterToken lautet die Modell-Base-URL https://bettertoken.ai; der Client ergänzt /v1/messages, daher kein manuelles /v1.
• Bei Codex über BetterToken lautet sie https://www.bettertoken.ai/v1 mit wire_api = "responses".
• Der Parallel-Tool-Endpunkt bleibt https://search.parallel.ai/mcp oder https://search.parallel.ai/mcp-oauth.

Diese URLs sind nicht austauschbar. BetterToken verarbeitet Modellaufrufe und Token-Nutzung; Parallel stellt Web-Tools bereit. Anonyme Verfügbarkeit, Credits, Datenschutz und Limits richten sich weiterhin nach dem externen Dienst. Prüfe getrennt den Claude-Code-Leitfaden, den Codex-Leitfaden und die Parallel-Search-MCP-Dokumentation.

Häufige Fehler und der kleinste sinnvolle Retest

Symptom	Zuerst prüfen	Retest nach der Korrektur
Server hinzugefügt, Tools fehlen	Client vollständig neu starten; Syntax und exakte URL prüfen; MCP-Logs öffnen	web_search und web_fetch erscheinen
401	/mcp-oauth, abgeschlossener OAuth-Flow, gültiger Bearer	Erneut verbinden und keine Auth-Anforderung mehr sehen
402	Credits des authentifizierten Kontos	Guthaben ergänzen oder zu anonymem /mcp wechseln und gezielt suchen
Connected, aber keine Tool-Calls	Agent nutzt integrierte Suche oder antwortet aus dem Gedächtnis	Zwangstest ausführen und Trace prüfen
Abruf ist riesig oder abgeschnitten	full_content, zu viele URLs, zu breites objective	Volltext ausschalten und nur relevante Seiten abrufen
Unterschiedliches Verhalten je Projekt	Claude-Code-Scope, Projektfreigabe oder alte Codex-Sitzung	Server im Zielprojekt erneut auflisten und Call wiederholen

Wann sich die dauerhafte Nutzung lohnt

Die Integration passt, wenn du gehostete Suche und Seitenabruf ohne eigenen SearXNG-Stack brauchst, der Client Tool-Calls und Quellen zeigt und entweder die anonyme Grenze für leichte Aufgaben genügt oder authentifizierte Nutzung budgetiert werden kann.

Gehe nicht direkt in Produktion, wenn eine öffentlich garantierte feste Gratisquote nötig ist, anonyme Nutzung zugleich Organisationszuordnung oder Zero Data Retention liefern muss, tatsächliche Tool-Calls nicht sichtbar sind oder Index, Crawler und Datenresidenz vollständig kontrolliert werden müssen.

Die sicherste Reihenfolge lautet: repräsentative Aufgaben über anonymes /mcp ausführen, Tool-Traces und Quellen speichern, Rate-Limit-Verhalten und Modell-Token-Wachstum messen und erst bei einem echten anonymen Engpass auf Bearer oder /mcp-oauth wechseln. So bleiben Verbindung, Retrieval-Qualität, externe Kosten und Modellkosten getrennt prüfbar.