Searchcraft MCP Server einrichten
Searchcraft MCP Server einrichten mit geprüften Links, minimalen Rechten und sicherem ersten Test starten.
- Skill Road
- Searchcraft MCP Server einrichten
Veröffentlicht am 19.09.2026
Der Searchcraft MCP Server verbindet KI-Clients wie Claude Code oder Claude Desktop mit einer eigenen Searchcraft-Suchinstanz und macht Indexverwaltung, Dokumentenimport und Suchanfragen per Sprachbefehl steuerbar. Dieser Ratgeber zeigt Einrichtung, Voraussetzungen und einen ersten sicheren Testlauf.
Voraussetzungen schaffen
Bevor der MCP-Server nutzbar ist, wird eine laufende Searchcraft-Instanz benötigt – entweder ein Cluster in der verwalteten Searchcraft Cloud (Vektron Dashboard) oder eine selbst gehostete Searchcraft-Core-Installation. Von dort werden die Endpunkt-Adresse und ein API-Schlüssel benötigt. Zusätzlich ist Node.js 22 oder neuer erforderlich.
Server bauen und verbinden
Nach dem Klonen des Repositorys searchcraft-inc/searchcraft-mcp-server installiert yarn die Abhängigkeiten, yarn build erzeugt die stdio- und HTTP-Variante des Servers. Die Zugangsdaten (ENDPOINT_URL, CORE_API_KEY) werden in einer .env-Datei hinterlegt. Für Claude Code genügt danach: claude mcp add searchcraft -- node /pfad/zu/dist/stdio-server.js. Claude Desktop bindet den Server stattdessen über einen Eintrag in claude_desktop_config.json ein.
Rechte des API-Schlüssels eng fassen
Weil ein Agent mit den Rechten des hinterlegten Schlüssels arbeitet, lohnt es sich, über das Tool create_key einen eigenen Schlüssel mit möglichst engen, auf den jeweiligen Anwendungsfall zugeschnittenen Rechten zu erzeugen, statt einen bereits bestehenden Vollzugriffsschlüssel wiederzuverwenden.
Ersten Index anlegen und testen
Ein sicherer erster Test ist das Anlegen eines Index aus einer öffentlichen JSON-Testdatei mit create_index_from_json, gefolgt von einer einfachen Suchanfrage über get_search_results. Wer zusätzlich eine Oberfläche sehen möchte, lässt sich mit create_vite_app eine eigenständige React-Suchanwendung generieren.
Häufige Fragen
Brauche ich zwingend einen Searchcraft-Account?
Ja. Der MCP-Server steuert eine bereits existierende Searchcraft-Instanz; ohne Endpunkt-URL und API-Schlüssel einer Cloud- oder Self-Hosted-Core-Instanz funktioniert er nicht.
Ist die Nutzung kostenlos?
Der MCP-Connector ist Apache-2.0-lizenziert und kostenlos. Der produktive Betrieb der zugrunde liegenden Searchcraft-Engine ist laut Anbieter jedoch kostenpflichtig, entweder als Cloud-Abrechnung oder als Self-Host-Lizenzvertrag.
Welche Rechte sollte der API-Schlüssel haben?
So wenige wie für den Anwendungsfall nötig. Über das Tool `create_key` lassen sich Schlüssel mit granularen, eng gefassten Rechten erzeugen, statt einen Vollzugriffsschlüssel zu verwenden.
Was liefert `create_vite_app`?
Das Tool generiert aus vorhandenen Indexdaten eine eigenständige, sofort lauffähige React-Suchanwendung auf Basis von Vite, inklusive eines Lesezugriffsschlüssels.