Verwendung mit OpenCode

Über OpenCode

OpenCode ist ein Terminal-AI-Coding-Agent (vergleichbar mit Claude Code oder Aider) mit nativer Unterstützung für das Model Context Protocol - sowohl lokale stdio-Server als auch Remote-HTTP-Server, mit OAuth- und Bearer-Auth-Helfern für die Remote-Variante. Der Crawlbase MCP-Server ist ein lokaler stdio-Server, daher ist der Local-Config-Block unten das, was Sie brauchen.

OpenCode installieren

Überspringen Sie diesen Abschnitt, wenn Sie OpenCode bereits laufen haben. Andernfalls ist dies der kanonische Installationsweg:

# macOS / Linux / WSL - one-liner installer
curl -fsSL https://opencode.ai/install | bash

# Or via npm / Homebrew / paru - see opencode.ai for details

Konfigurationsdatei

OpenCode liest MCP-Server aus einer JSON-Konfigurationsdatei zusammen mit seinen übrigen Einstellungen. Wählen Sie den passenden Scope: global bedeutet, dass jedes Projekt, das Sie mit OpenCode öffnen, die Crawlbase-Tools sieht; per-project bedeutet, dass nur das Repo, das die Datei enthält, sie sieht.

Konfiguration

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "crawlbase": {
      "type": "local",
      "command": ["npx", "-y", "@crawlbase/mcp@latest"],
      "enabled": true,
      "environment": {
        "CRAWLBASE_TOKEN": "YOUR_TOKEN",
        "CRAWLBASE_JS_TOKEN": "YOUR_JS_TOKEN"
      }
    }
  }
}

Beachten Sie die OpenCode-spezifischen Keys: mcp (nicht mcpServers), type: "local" (nicht "stdio"), command als Array von Strings und environment (nicht env). Das Crawlbase MCP-Paket auf npm ist dasselbe, das jeder andere Client verwendet - nur das umgebende Config-Schema unterscheidet sich.

Speichern Sie die Datei und starten Sie OpenCode neu. Die Crawlbase-Tools erscheinen als standardmäßige MCP-Tools, die der Agent mitten im Gespräch nutzen kann; Sie müssen sie im Prompt nicht namentlich erwähnen.

Nutzung im Chat

Starten Sie eine OpenCode-Session und fragen Sie nach etwas, das von Live-Web-Kontext profitieren würde. Der Agent entscheidet selbst, wann er auf die Crawlbase-Tools zugreift - Sie müssen sie nicht explizit aufrufen.

Pull the latest TanStack Query docs from
https://tanstack.com/query/latest and refactor our hooks
in src/hooks/useUser.ts to match the v5 API.

Muster, die gut funktionieren

• Live-Docs-Lookup: «Lies die aktuellsten library-Docs und aktualisiere unsere Nutzung» - schlägt alles, was im Trainings-Cut-off des Modells steht.
• Wettbewerbsanalyse: „Schau dir an, wie competitor feature auf seiner öffentlichen Site implementiert, und schlage dann ein Äquivalent in unserer Codebase vor."
• Build-Time-Scraping: einmalige Datenabrufe innerhalb einer Agent-Aufgabe - nützlich, wenn die Daten zu kurzlebig oder zu zielspezifisch sind, um in Ihrer Codebase zu liegen.