Sourcegraph MCP Server

Der Sourcegraph MCP Server macht die Code-Suche Ihrer Sourcegraph-Instanz für KI-Assistenten nutzbar. Sourcegraph ist eine Plattform, mit der Teams große Codebasen über viele Repositories hinweg durchsuchen und verstehen. MCP, das Model Context Protocol, ist ein offener Standard, über den ein Assistent wie Claude Code oder Cursor externe Werkzeuge aufruft. Der Server ist kein separates Programm zum Installieren: Laut Dokumentation stellt die Instanz selbst unter dem Pfad /.api/mcp einen MCP-Endpunkt bereit, etwa unter https://sourcegraph.example.com/.api/mcp. Statt einzelne Dateien in den Chat zu kopieren, lässt der Assistent die Suche über alle angebundenen Repositories laufen und liest nur, was er braucht.

Was kann der Sourcegraph MCP Server?

Die Dokumentation beschreibt mehrere Werkzeuggruppen. Für Dateien und Repositories gibt es read_file, list_files, list_repos und list_refs. Für die Suche stehen keyword_search, nls_search für Fragen in natürlicher Sprache und ein Werkzeug namens evaluator bereit. Zur Code-Navigation gehören go_to_definition und find_references, also der Sprung zur Definition eines Symbols und die Liste seiner Verwendungen. Für die Versionsgeschichte gibt es commit_search, diff_search, compare_revisions und get_contributor_repos. Hinzu kommen code_finder sowie die Deep-Search-Werkzeuge deepsearch und deepsearch_read. Welche davon verfügbar sind, hängt vom gewählten Endpunkt ab.

Drei Endpunkte für unterschiedliche Zwecke

Der Endpunkt /.api/mcp liefert die Kernwerkzeuge für Suche, Repositories und Verlauf und kann bestehende Deep-Search-Gespräche lesen, aber keine neuen anlegen. /.api/mcp/all enthält das vollständige Werkzeugset. /.api/mcp/deepsearch beschränkt sich auf die Deep-Search-Werkzeuge. Wer einem Assistenten nur die Recherche geben will, kann also gezielt den schmalsten Endpunkt eintragen.

Anmeldung und Berechtigungen

Die Anmeldung läuft laut Dokumentation über OAuth 2.0 mit dynamischer Client-Registrierung oder mit vorab registrierten Clients; alternativ lassen sich Sourcegraph-Zugriffstokens verwenden. Nutzer benötigen die Berechtigung MCP#ACCESS, die die eingebaute Rolle User standardmäßig mitbringt. Der MCP-Zugriff hebt Repository-Berechtigungen nicht auf: Jede Person sieht über den Assistenten nur die Repositories, die sie auch in Sourcegraph sehen darf. Administratoren können einzelne Werkzeuge über die Einstellung mcp.tools.disabled abschalten, und mit mcp.enabled lässt sich der Endpunkt insgesamt steuern; ist er ausgeschaltet, antwortet /.api/mcp mit 404.

Einrichtung in Claude Code und anderen Clients

Claude Code und die Amp-CLI nutzen laut Dokumentation die dynamische Registrierung und werden automatisch mit dem Scope mcp angelegt; bei Claude Code wählen Sie dazu den HTTP-Transport. Bei OpenAI Codex kann es zu einem Fehler invalid_scope kommen, dann hilft der Eintrag scopes = ["mcp"] in der Datei config.toml. Für Cursor, VS Code und weitere Clients verweist die Seite auf eine eigene Seite zu Client-Integrationen.

Grenzen im Alltag

Dateien über 128 KB liefern nur die ersten 200 Zeilen, und list_files gibt höchstens 1000 Einträge zurück. Das Werkzeug code_finder wird gegen das Kontingent Ihres Vertrags gezählt und liefert einen Fehler, wenn es aufgebraucht ist; auf /.api/mcp dient dann nls_search als Ausweichmöglichkeit.

Kosten

Laut Dokumentation und Preisseite wird der Server mit dem Enterprise-Plan unterstützt. Die Preisseite führt nur diesen einen Plan mit Mindestlaufzeit und nennt Preise über den Vertrieb; einen kostenlosen Plan führt sie nicht auf. Aktuelle Konditionen erfahren Sie direkt bei Sourcegraph.

Für wen lohnt sich der Sourcegraph MCP Server?

Er lohnt sich für Teams, die bereits eine Sourcegraph-Enterprise-Instanz betreiben und viele Repositories pflegen: Ein Assistent kann dann fragen, wo eine Funktion verwendet wird, wann eine Änderung eingeführt wurde oder wie ein Dienst aufgebaut ist, ohne dass jemand Code von Hand zusammensucht. Wer nur ein einzelnes Repository bearbeitet, kommt mit den Bordmitteln seines Editors meist aus. Beginnen Sie mit dem schmalen Endpunkt und erweitern Sie nur bei Bedarf.

Eine Sourcegraph-Instanz mit Enterprise-Plan, aktivierte MCP-Funktion (mcp.enabled), die Berechtigung MCP#ACCESS sowie ein MCP-Client mit HTTP-Transport, zum Beispiel Claude Code.

Mit dem Sourcegraph MCP Server nutzt ein KI-Assistent die Code-Suche Ihrer Sourcegraph-Instanz. Dieser Ratgeber führt von der Prüfung der Voraussetzungen bis zur ersten Suche.

Schritt 1: Voraussetzungen

Der Server wird laut Dokumentation mit dem Enterprise-Plan unterstützt. Der MCP-Zugriff ist standardmäßig eingeschaltet (mcp.enabled); antwortet /.api/mcp mit 404, hat ein Administrator ihn abgeschaltet. Ihr Konto braucht die Berechtigung MCP#ACCESS, die die Rolle User mitbringt. Für OAuth muss die dynamische Client-Registrierung aktiv sein oder ein Administrator Clients vorab registrieren.

Den passenden Endpunkt wählen

/.api/mcp bietet Suche, Repositories und Verlauf. /.api/mcp/all enthält zusätzlich alle weiteren Werkzeuge, auch das Anlegen neuer Deep-Search-Gespräche. /.api/mcp/deepsearch liefert nur Deep Search. Beginnen Sie mit /.api/mcp.

Schritt 2: In Claude Code einbinden

Der Befehl lautet claude mcp add --transport http sourcegraph https://sourcegraph.example.com/.api/mcp, wobei Sie die Adresse durch die Ihrer Instanz ersetzen. Beim ersten Aufruf öffnet sich die OAuth-Anmeldung. Prüfen Sie danach mit /mcp, ob die Werkzeuge erscheinen. Bei OpenAI Codex hilft bei dem Fehler invalid_scope der Eintrag scopes = ["mcp"] in der config.toml.

claude mcp add --transport http sourcegraph https://sourcegraph.example.com/.api/mcp

Erste Suche und Grenzen

Fragen Sie den Assistenten etwa, wo eine Funktion verwendet wird oder wann eine Konfiguration geändert wurde. Beachten Sie: Dateien über 128 KB liefern nur die ersten 200 Zeilen, list_files höchstens 1000 Einträge, und code_finder zählt gegen das Kontingent Ihres Vertrags.

Zugriff eingrenzen

Der Assistent sieht nur Repositories, die Ihr Konto in Sourcegraph sehen darf. Administratoren können einzelne Werkzeuge mit mcp.tools.disabled abschalten. Denken Sie daran, dass gelesener Quellcode in den Kontext des Modellanbieters gelangt.

OAuth 2.0 mit dynamischer Client-Registrierung oder vorab registrierten Clients; alternativ Sourcegraph-Zugriffstokens.

Lesender Zugriff auf Code, Verlauf und Suche mit den Rechten des angemeldeten Nutzers; sichtbar sind nur Repositories, die dieser Nutzer in Sourcegraph sehen darf. Erforderlich ist die Berechtigung MCP#ACCESS.

Gelesene Dateien und Suchtreffer gelangen in den Kontext des KI-Clients und damit zum Modellanbieter. Die Anfragen gehen an Ihre eigene Sourcegraph-Instanz.

Vertraulicher Quellcode im Kontext eines externen Modells, zu weit gefasste Nutzerrechte, Zugriffstokens in Konfigurationsdateien und Prompt Injection über Kommentare oder Dateiinhalte im durchsuchten Code.