Zum Inhalt springen
Documentation

MCP-Server (Verbinden Sie Ihren KI-Assistenten)

CHAMPREP hostet einen Remote- Model Context Protocol (MCP)-Server. Verbinden Sie ihn mit einem beliebigen MCP-fähigen KI-Client – Claude (claude.ai und Desktop), ChatGPT, Claude Code, Codex, Cursor, VS Code, Windsurf und anderen – und Ihr Assistent kann auf Ihr CHAMPREP Konto: Kalendertermine auflisten und eintragen, E-Mails lesen und entwerfen, Arbeitsboards verwalten, Ihr Laufwerk durchsuchen, Rechnungen, Notizen, Dokumente und Tabellen erstellen sowie vieles mehr – alles über Konversationen.

:::Achtung[Endpunkt aktualisiert: Verwenden Sie /mcp/v1] Der Endpunkt ist nun versioned. Stellen Sie eine Verbindung zu https://ai-api.champrep.com/mcp/v1. Der alte, nicht versionierte https://ai-api.champrep.com/mcp ist ausgemustert — Anfragen an diesen Endpunkt werden mit einer Meldung abgelehnt, die Sie zum Wechsel auffordert. Falls Ihr Client noch immer auf /mcp, ändern Sie die URL in /mcp/v1 (Benutzer von npm-bridge npx -y @champrep/mcp den neuen Endpunkt beim nächsten Lauf automatisch übernehmen). :::

Für moderne Clients muss nichts installiert werden. Der Server wird gehostet unter:

https://ai-api.champrep.com/mcp/v1

Die Argumentation des Assistenten läuft in Ihr KI-Client mit dem Modell Ihres Kunden – CHAMPREP MCP-Aufrufe verbrauchen keine Ihrer CHAMPREP AI Gutschriften. Jeder Tool-Aufruf wird unter Ihrer eigenen Identität ausgeführt und unterliegt Ihrem Tarif, den Richtlinien Ihrer Organisation sowie (bei API Schlüsseln) den von Ihnen gewählten Gültigkeitsbereichen.

Es gibt zwei Möglichkeiten, eine Verbindung herzustellen. Beide werden vollständig unterstützt – wählen Sie je nach Situation die passende aus:

Anmeldung über den Browser (OAuth)API Schlüssel
Am besten geeignet fürPersonen, die eine KI-App interaktiv nutzenSkripte, CI, Server, Headless-Tools
EinrichtungFügen Sie die URL ein; bestätigen Sie die Anmeldung in Ihrem BrowserErstellen Sie einmalig einen Schlüssel; fügen Sie ihn in die Konfiguration ein
Zu beachtende SicherheitshinweiseKeine – kein Schlüssel gelangt jemals in die Client-KonfigurationSie speichern den cpk_… Schlüssel in der Konfiguration des Clients
ZugriffsumfangIhr vollständiges Konto (als wären Sie angemeldet)Nur die Gültigkeitsbereiche Sie erteilen dem Schlüssel (z. B. nur calendar:read)
Funktioniert inclaude.ai, Claude Desktop, ChatGPT, Claude Code, Codex, Cursor, VS Code, WindsurfAlles, einschließlich Clients ohne Browser
AblaufdatumSitzungen werden automatisch aktualisiert; jederzeit widerrufbarOptionales Ablaufdatum; jederzeit widerrufbar
Widerrufen überVerbindung im Client trennenKonto → APISchlüssel auf champrep.com

Faustregel: Wenn sich ein Mensch am Client befindet, verwenden Sie die Browser-Anmeldung. Befindet sich dort ein Computer, verwenden Sie einen API-SchlüsselAPI mit den engsten Berechtigungsumfängen, die für die Aufgabe erforderlich sind.

Option A: Melden Sie sich über Ihren Browser an (empfohlen)

Abschnitt betitelt „Option A: Melden Sie sich über Ihren Browser an (empfohlen)“

Fügen Sie die Server-URL mit Kein Schlüssel oder keine HeaderIhr Client erkennt den CHAMPREPAnmeldeablauf automatisch (OAuth 2.1 mit dynamischer Registrierung), öffnet in Ihrem Browser eine CHAMPREPEinwilligungsseite und stellt nach Ihrer Zustimmung eine Verbindung her. Wenn Sie inCHAMPREP diesem Browser bereits angemeldet sind, gelangen Sie direkt zum Genehmigungsbildschirm; wenn Sie bei mehreren KontenCHAMPREP angemeldet sind, wählen Sie aus, welches Sie verbinden möchten.

  1. Einstellungen → Konnektoren → Benutzerdefinierten Konnektor hinzufügen.
  2. Einfügen https://ai-api.champrep.com/mcp/v1 und speichern Sie die Einstellungen.
  3. Ihr Browser öffnet die CHAMPREPEinwilligungsseite – überprüfen Sie die Angaben und klicken Sie auf Zulassen.
  4. Aktivieren Sie in einem beliebigen Chat den CHAMPREPKonnektor über das Werkzeugmenü und fragen Sie einfach: „Überprüfen Sie meine CHAMPREPE-Mails auf ungelesene Nachrichten.“

Für die Konnektoren ist ein ChatGPT-Tarif mit Entwicklermodus (Einstellungen → Konnektoren → Erweitert → Entwicklermodus).

  1. Einstellungen → Konnektoren → Erstellen (oder Konnektor hinzufügen).
  2. Benennen Sie ihn CHAMPREP, stellen Sie die MCP-Server-URL auf https://ai-api.champrep.com/mcp/v1, wählen Sie OAuth Führen Sie die Authentifizierung durch und speichern Sie die Einstellungen.
  3. Bestätigen Sie die EinwilligungsseiteCHAMPREP, sobald sich der Browser öffnet.
Terminal-Fenster
claude mcp add --transport http champrep https://ai-api.champrep.com/mcp/v1

Führen Sie anschließend Folgendes aus /mcp, wählen Sie champrep, und wählen Sie Authentifizieren – Ihr Browser öffnet die Einwilligungsseite.

Einstellungen → MCP → Neuen MCP-Server hinzufügenoder fügen Sie hinzu zu ~/.cursor/mcp.json:

{
"mcpServers": {
"champrep": { "url": "https://ai-api.champrep.com/mcp/v1" }
}
}

Wenn Cursor meldet, dass der Server eine Authentifizierung erfordert, befolgen Sie die Anmeldeaufforderung.

Fügen Sie einen HTTP-MCP-Server mit URL hinzu https://ai-api.champrep.com/mcp/v1 in den MCP-Einstellungen des Kunden. Beide unterstützen den OAuth-Ablauf: Bei der ersten Verbindung wird die CHAMPREPEinwilligungsseite geöffnet.

  1. Melden Sie sich an unter champrep.com und öffnen Sie Konto → APISchlüssel.
  2. Erstellen Sie einen Schlüssel und wählen Sie dessen Gültigkeitsbereiche — diese legen fest, welche Werkzeuge der Assistent verwenden darf. calendar:read macht schreibgeschützte Kalender-Tools zugänglich; calendar:write Dadurch werden auch Werkzeuge freigeschaltet, die Ereignisse erstellen oder ändern. Gewähren Sie nur den Diensten Zugriff, die Sie als erreichbar festlegen möchten.
  3. Kopieren Sie den Schlüssel (cpk_live_…). Es wird einmal angezeigt.

Claude-Code:

Terminal-Fenster
claude mcp add --transport http champrep https://ai-api.champrep.com/mcp/v1 \
--header "Authorization: Bearer cpk_live_YOUR_KEY"

Cursor / VS Code / Windsurf (mcp.json(Konfiguration im -Stil):

{
"mcpServers": {
"champrep": {
"url": "https://ai-api.champrep.com/mcp/v1",
"headers": { "Authorization": "Bearer cpk_live_YOUR_KEY" }
}
}
}

Codex CLI (~/.codex/config.toml) – Codex kommuniziert mit stdio-Servern, verwenden Sie daher das „bridge“-Paket:

[mcp_servers.champrep]
command = "npx"
args = ["-y", "@champrep/mcp"]
env = { CHAMPREP_API_KEY = "cpk_live_YOUR_KEY" }

Claude Desktop (stdio-Konfiguration) und andere ausschließlich stdio-basierte Clients — die @champrep/mcp „bridge“ leitet einen lokalen stdio-Server an den gehosteten Endpunkt weiter:

{
"mcpServers": {
"champrep": {
"command": "npx",
"args": ["-y", "@champrep/mcp"],
"env": { "CHAMPREP_API_KEY": "cpk_live_YOUR_KEY" }
}
}
}

Wenn CHAMPREP_API_KEY Fehlt dies, öffnet die Bridge Ihren Browser auf der SeiteAPI „Schlüssel“ und zeigt Anweisungen an, anstatt stillschweigend zu scheitern.

Raw HTTP (für Ihre eigenen Integrationen – reines JSON-RPC 2.0). Übergeben Sie den Schlüssel über eine Umgebungsvariable statt inline, damit er nicht in Ihrem Shell-Verlauf erfasst wird:

Terminal-Fenster
export CHAMPREP_API_KEY="cpk_live_..." # from Account -> API Keys
curl https://ai-api.champrep.com/mcp/v1 \
-H "Authorization: Bearer $CHAMPREP_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Ihr MCP-Client steuert, ob, wann und wie er Sie zur Bestätigung eines Tool-Aufrufs auffordert. Der Leitfaden zur Benutzerinteraktion gemäß der MCP-Spezifikation empfiehlt eine menschliche Überwachung und Bestätigungsaufforderungen, schreibt jedoch kein bestimmtes Interaktionsmodell vor. Die Anzeige von Bestätigungsaufforderungen hängt vom Client und dessen Einstellungen ab, einschließlich aller gespeicherten Berechtigungen oder Regeln zur automatischen Genehmigung.

CHAMPREP stellt Tool-Anmerkungen bereit, um Clients bei der Bewertung jedes Vorgangs zu unterstützen:

  • Schreibgeschützte Tools (Ereignisse auflisten, E-Mails durchsuchen, Notizen lesen …) haben readOnlyHint: true.
  • Tools, die Änderungen vornehmen (E-Mails versenden, Ereignisse erstellen, Dateien hochladen …) haben readOnlyHint: false.
  • Destruktive Tools haben destructiveHint: true und bleiben verborgen, es sei denn, der destruktive Zugriff ist aktiviert (nächster Abschnitt).

Tool-Anmerkungen beschreiben das Verhalten. Sie erzwingen keinen Bestätigungsdialog und garantieren keine Abfrage vor jedem Aufruf, auch nicht bei destruktiven Tools. Überprüfen Sie die Genehmigungseinstellungen Ihres Kunden, bevor Sie Änderungen zulassen.

Bei gewöhnlichen MCP-Aktionen CHAMPREPstützt sich auf die Einwilligungsabwicklung des Clients , anstatt eine zweite CHAMPREPGenehmigungsabfrage zu erfordern. Der Server überprüft nicht unabhängig, ob der Client eine Abfrage angezeigt hat.

CHAMPREP Es werden weiterhin Verbindungsbeschränkungen, anwendbare APISchlüsselbereiche, Dienstautorisierung, Organisationsrichtlinien und Ratenbegrenzungen durchgesetzt. Aktionen, die über den Aktionsausführer CHAMPREPvon geleitet werden, durchlaufen ebenfalls Sicherheitsprüfungen und werden in Ihrem Konto Aktivitätsprotokoll, mit Rückgängig sofern unterstützt. Die Zustimmung des Clients kann eine serverseitige Ablehnung oder eine von der Organisation geforderte Genehmigung nicht außer Kraft setzen; Aktionen, die eine CHAMPREP-spezifische Genehmigung erfordern, können über MCP abgelehnt werden.

Standardmäßig blendet der Server Tools aus, die Daten dauerhaft löschen oder bereinigen – wie das Löschen von Laufwerksordnern, das Bereinigen von Notizen, das Entfernen von Datensätzen und Ähnliches. Wenn Sie tatsächliche Bereinigungsarbeiten durchführen müssen und die Hilfe Ihres Assistenten in Anspruch nehmen möchten, muss die Verbindung destruktive Aktionen zulassen und der Client muss diese anfordern, indem er ?destructive=true zur Server-URL:

https://ai-api.champrep.com/mcp/v1?destructive=true

Verwenden Sie diese URL überall dort, wo eine URL akzeptiert wird (Claude.ai-Connector, Claude Code, Cursor, ChatGPT). Für die stdio-Brücke legen Sie stattdessen eine Umgebungsvariable fest:

"env": {
"CHAMPREP_API_KEY": "cpk_live_YOUR_KEY",
"CHAMPREP_ENABLE_DESTRUCTIVE": "true"
}

Das URL-Flag oder die Bridge-Einstellung allein hebt die Berechtigungen der Verbindung nicht auf. Eine schreibgeschützte Verbindung, ein unzulässiger Dienst oder ein deaktivierter destruktiver Zugriff verhindern weiterhin, dass das Tool verfügbar ist.

Sie sind dafür verantwortlich, was Ihr Assistent mit diesen Tools tut. Gelöschte Daten lassen sich möglicherweise nicht wiederherstellen. Destruktive Tools erfordern weiterhin die APIentsprechenden Schlüsselbereiche, wie beispielsweise die eines Dienstes :write Gültigkeitsbereich oder dessen separaten Löschbereich, sofern zutreffend. Sie behalten weiterhin destructiveHint, doch ob Ihnen eine Bestätigungsabfrage angezeigt wird, hängt von Ihrem Client und dessen Konfiguration ab. Die oben beschriebenen serverseitigen Prüfungen und die Aktionsprotokollierung gelten weiterhin. Einige destruktive Aktionen unterstützen Rückgängig auf der Seite „Aktivität“ Ihres Kontos – jedoch behandeln Sie jede Löschung als endgültig.

Unabhängig von diesem Flag gelten für einige Dinge niemals Über MCP verfügbar: Verwaltungsvorgänge, Tools zur Codeausführung und die Löschung von Konten. Die einzigen Ausnahmen von der Regel zur Codeausführung sind das Starten eines QA-Vorschau-Builds oder einer QA-Cloud-IDE-Sitzung: Beide werden nach Ihrer Genehmigung in der isolierten Sandbox von QA ausgeführt (siehe MCP für Code, CI, Runner Farm und QA).

Die Tools decken die gesamte Plattform ab, stets als Sie: Calendar (Ereignisse, Buchungen, Verfügbarkeit), Mail (Lesen, Suchen, Entwürfe, Senden, Labels, Regeln), Drive (Suchen, Dateien, Ordner, Freigabe), Notes, Meetings (Zeitplan, Zusammenfassungen, Aufzeichnungen), Work (Pinnwände, Tickets), Docs (Dokumente, Kommentare, Bearbeitungsvorschläge, Versionen, Export), Tabellen (Arbeitsmappen, Bereiche, Formeln, Formatierung, Validierung, bedingte Formatierung, Schutz, Kommentare, Versionen, Export), Rechnungen, Forms, Contacts, Diagramme, CHAMPREP Code, Runner-Farm, QA und Learn. Welche Tools genau angezeigt werden, hängt von Ihrem Tarif, den Richtlinien Ihrer Organisation, Ihren KI-Berechtigungen pro Dienst und (bei API Schlüsseln) den Gültigkeitsbereichen des Schlüssels ab.

Für CHAMPREP„Code“ (Projekte, Klonpläne, Pipelines, Jobprotokolle, Runner), „Runner Farm“ und „QA“ siehe MCP für Code, CI, Runner Farm und QA: Was der Assistent leisten kann, Beispielaufforderungen, was Ihrer Zustimmung bedarf und was in den Webanwendungen verbleibt.

Versuchen Sie zunächst Folgendes:

  • „Was steht diese Woche in meinem CHAMPREPKalender?“
  • „Habe ich ungelesene E-Mails? Fassen Sie alles Wichtige zusammen.“
  • „Finden Sie die PDF-Verträge dieses Monats in meinem Laufwerk.“
  • „Erstellen Sie ein Arbeitsticket mit dem Titel ‚SSL-Zertifikate erneuern‘ in meinem Ops-Dashboard.“
  • „Erstellen Sie ein Docs-Dokument mit dem Titel ‚Q4-Plan‘ mit Abschnitten für Ziele, Risiken und Verantwortliche.“
  • „Markieren Sie in meiner Arbeitsmappe ‚Monatliches Budget‘ alle Ausgaben über 500.“

Browser Relay Bridge (Chrome-Erweiterung) und Eve AI

Abschnitt betitelt „Browser Relay Bridge (Chrome-Erweiterung) und Eve AI“

Zusätzlich zu den Cloud-Service-Tools bietet das CHAMPREP für die Chrome-Erweiterung können Sie Ihren eigenen Browser mit „Eve“ verbinden:

  • Aktivieren Lassen Sie Eve diesen Browser verwenden in den Erweiterungs-Einstellungen.
  • Eve-Chats im Web, in der Desktop-App, in Eve AI für VS Codesowie im Terminal-Agenten (eve / champrep ai) kann dann die aktive Registerkarte auslesen, Registerkarten auflisten und Screenshots erstellen sowie – nachdem Sie jede Aktion genehmigt haben – navigieren, klicken oder ein Feld ausfüllen.
  • Eve führt niemals Aktionen auf E-Mail-, Bank-, Zahlungs- oder Anmeldeseiten durch und gibt niemals Daten in Felder für Passwörter, Einmalcodes oder Kartendaten ein.

  • API Schlüssel – Anzeigen, Geltungsbereich, Ablauf und Widerruf unter Konto → APISchlüssel. Die Sperrung tritt sofort in Kraft.
  • Anmeldungen über den Browser – Trennen Sie die Verbindung zum Konnektor innerhalb des KI-Clients. Sie können sich auch inCHAMPREP diesem Browser abmelden; neue Token können dann nicht mehr dafür ausgestellt werden.
  • Jede agentische Aktion erscheint in Ihrem Konto Aktivitätsprotokoll mit Angaben dazu, was ausgeführt wurde, wann und von wo aus – sowie der Option „Rückgängig“, sofern unterstützt.
  • 120 MCP-Anfragen pro Minute und Identität. Für umfangreichere Automatisierungsvorgänge sollten Sie die Entwickler API mit Schlüsseln im Dienstbereich.
  • Toolaufrufe unterliegen denselben planbezogenen Kontingenten wie der Rest Ihres Kontos – ein Assistent kann die Grenzen dessen, was Sie selbst tun können, nicht überschreiten.

SymptomMögliche Ursache und Behebung
Der Client meldet, dass eine Authentifizierung erforderlich ist, und es öffnet sich nichtsIhr Client unterstützt möglicherweise MCP OAuth nicht – verwenden Sie einen API-SchlüsselAPI (Option B).
Invalid API keyDer Schlüssel wurde widerrufen, ist abgelaufen oder wurde falsch eingegeben. Erstellen Sie unter Konto → APISchlüssel.
Unknown or unavailable toolDas Tool liegt außerhalb des Geltungsbereichs Ihres Schlüssels, ist durch Ihre KI- oder Verbindungsberechtigungen deaktiviert oder hat zerstörerische Auswirkungen, wenn sowohl die Verbindungsberechtigung als auch die ?destructive=true Opt-in.
Ein Tool wird ohne Bestätigungsaufforderung ausgeführtDie Abfrage wird von Ihrem MCP-Client und dessen Genehmigungs-Einstellungen gesteuert. Tool-Anmerkungen, einschließlich destructiveHint, garantieren keine Abfrage. Überprüfen Sie die gespeicherten Berechtigungen und Regeln für die automatische Genehmigung in diesem Client.
Ein Schreibvorgang wird mit einer Limit-Meldung abgelehntCHAMPREPDie serverseitigen Zugriffskontrollen (tägliche Obergrenzen, Missbrauchssicherung) haben den Vorgang abgelehnt – die Meldung gibt den Grund an. Versuchen Sie es später erneut oder reduzieren Sie das Volumen.
Auf der Einwilligungsseite wird „Sitzung abgelaufen“ angezeigtDie Genehmigung ist abgelaufen. Führen Sie den Verbindungsablauf vom Client aus erneut durch.
Funktioniert im Browsertest, jedoch nicht von einem Server/CI aus Funktioniert im Browsertest, jedoch nicht von einem Server/CI ausVerwenden Sie einen API-SchlüsselAPI – bei der Browser-Anmeldung werden Tokens nur interaktiv generiert.
429 AntwortenSie haben die Obergrenze pro Minute erreicht; warten Sie etwas ab und versuchen Sie es erneut.

Endpunkt: https://ai-api.champrep.com/mcp/v1.