Zum Inhalt springen
Documentation

MCP-Server im KI-Agenten

MCP-Server (Model Context Protocol) stellen dem Agenten zusätzliche Werkzeuge zur Verfügung. Der Agent unterstützt zwei Arten:

ArtWo es ausgeführt wirdWo die Konfiguration erfolgt
GehostetAußerhalb Ihres Computers; CHAMPREPstellt über HTTPS eine Verbindung zu ihm herIhr CHAMPREP AIKonto, das mit den Web-, Desktop- und Mobil-Apps geteilt wird
LokalEin auf Ihrem Rechner gestartetes Programm, das über Standard-Ein- und -Ausgabe MCP-Befehle übermitteltEin mcp.json Datei für Sie oder für das Projekt

Auf dieser Seite geht es um die Verbindung von Servern mit dem Agenten. Um CHAMPREP selbstCHAMPREP von einem anderen MCP-Client aus zu nutzen, lesen Sie bitte den Abschnitt CHAMPREP MCP-Server.

/mcp

Das Fenster listet alle gehosteten und lokalen Server mit ihrem Status und ihren Tools auf. Wählen Sie einen Server mit den Pfeiltasten aus und drücken Sie:

SchlüsselAktion
EnterZeigen Sie die Aktionen für den Server an.
eSchalten Sie den Server ein oder aus.
rAktualisieren: Stellen Sie die Verbindung wieder her und laden Sie die Werkzeuge neu.
aErneut authentifizieren: Ersetzen Sie die Anmeldedaten.
tListen Sie die darin enthaltenen Werkzeuge auf.
xEntfernen Sie den Server.
nFügen Sie einen Server hinzu.

Tastenkombinationen funktionieren auch ohne das Fenster, zum Beispiel /mcp list, /mcp enable NAME, /mcp disable NAME, /mcp refresh NAMEsowie, bei lokalen Servern, /mcp restart NAME und /mcp remove NAME.

Gehostete Server gehören zu Ihrem CHAMPREP AIKonto, sodass ein Server, den Sie im Terminal hinzufügen, auch im Web verfügbar ist und umgekehrt. Deren Tools laufen auf CHAMPREP, nicht auf Ihrem Rechner.

Um einen hinzuzufügen, drücken Sie n in /mcp, wählen Sie einen gehosteten Server aus und geben Sie dessen URL sowie die Anmeldedaten ein, beispielsweise ein Bearer-Token. Die Anmeldedaten werden in ein maskiertes Feld eingegeben, einmalig an Ihr CHAMPREP AIKonto gesendet und niemals angezeigt, lokal gespeichert, protokolliert oder an das Modell weitergegeben. Verwenden Sie a um einen abgelaufenen Zugangsnachweis zu ersetzen.

Das Entfernen eines gehosteten Servers löscht diesen vollständig aus Ihrem Konto. Falls eine Aktion für einen gehosteten Server inCLI Ihrer Umgebung nicht über den verfügbar ist, weist der Agent Sie darauf hin; nutzen Sie stattdessen Ihre EinstellungenCHAMPREP AI im Web.

Lokale Server sind Programme, die der Agent auf Ihrem Rechner startet. Fügen Sie einen hinzu mit n in /mcp und wählen Sie:

  • den Servernamen und den Befehl mit seinen Argumenten;
  • nur für Sie (Ihr Benutzer mcp.json) oder für dieses Projekt (.champrep/mcp.json, die Sie festschreiben können);
  • Optional eine Umgebungsvariable, die Anmeldedaten enthält. Ihr Wert wird maskiert und ausschließlich in Ihrem Benutzerkonto gespeichert mcp.json, und werden niemals in eine Projektdatei, den Verlauf, die Protokolle oder den Kontext des Modells geschrieben.

Sie können die Dateien auch direkt bearbeiten. Sie verwenden das gängige MCP-Client-Format. Bewahren Sie Anmeldedaten in Ihrer Benutzerdatei auf, niemals in einer Projektdatei, die Sie committen:

{
"mcpServers": {
"github": {
"command": "github-mcp-server",
"args": ["stdio"],
"env": { "GITHUB_TOKEN": "YOUR_TOKEN" }
}
}
}

Optionale Felder pro Server: disabled, include_tools, exclude_tools, startup_timeout_sec (Standard 30), tool_timeout_sec (Standard 120, maximal 600) und priority. In diesen Dateien dürfen nur lokale (stdio-)Server aufgeführt werden; fügen Sie HTTP-Server als gehostete Server hinzu.

Lokale Server erhalten niemals Ihre CHAMPREPAnmeldedaten oder sonstige CHAMPREP_* Umgebungsvariable.

Ausführen champrep ai paths So finden Sie Ihren Benutzer mcp.json. Lokale MCP-Server sind eine Funktion Ihres Tarifs; siehe Tarife und Limits.

Ein Projekt .champrep/mcp.json führt Befehle auf Ihrem Rechner aus, daher starten die Server erst, nachdem Sie dem Projekt Ihr Vertrauen geschenkt haben. .champrep/ Konfiguration. Wenn sich die Datei ändert, werden Sie erneut gefragt. Siehe Repository-Vertrauen.

  • Lokale Server-Tools werden wie Befehle behandelt: Bei jedem Aufruf werden Sie um Ihre Zustimmung gebeten, wobei der Server und die Argumente angezeigt werden, es sei denn, eine Zulassungsregel deckt dies ab. Zum Beispiel: local_mcp__github__* ermöglicht die Nutzung aller Werkzeuge der github Server. Ablehnungsregeln funktionieren auf die gleiche Weise.
  • Tools für gehostete Server Befolgen Sie die Genehmigungs-Einstellung des Servers in Ihrem CHAMPREP AI Konto. Wenn ein Anruf genehmigt werden muss, zeigt der Agenten eine Genehmigungs- Karte an; es wird nichts automatisch genehmigt.

Der Agent kann pro Runde maximal 64 lokale Tools anbieten. Wenn lokale Server mehr bereitstellen, werden die mit niedrigerer Prioritätpriority Server werden zuerst aussortiert, und der Agent informiert Sie darüber. Verwenden Sie include_tools oder exclude_tools , um die von Ihnen benötigten Tools beizubehalten.