yourept-mcp

MCP-Server für das CRM YOUREPT. Verbindet sich mit Claude, Cursor, Codex und anderen MCP-Clients und gibt dem Agenten Zugriff auf die Daten des Admin-Bereichs — Anfragen, Schüler, Lehrkräfte, Unterrichtsstunden, Zahlungen, Auszahlungen und Finanzberichte.

Die Fragen, für die er existiert:

„Wie viel haben wir in diesem Monat verdient und wie viel ist in Auszahlungen geflossen?“ „Welche Anfragen sind überfällig und bei welchen Managern?“ „Zeig mir Schüler, die zwei Wochen keinen Unterricht hatten“ „Welche Lehrkräfte haben den Vertrag bei Рокет Ворк nicht unterschrieben“

Also genau das, wofür man in der Oberfläche drei Bereiche öffnen und die Zahlen von Hand zusammenführen müsste.

Installation

1. Schlüssel besorgen

Im Admin-Bereich: Einstellungen → API-Schlüssel → Schlüssel erstellen. Der Schlüssel wird einmal angezeigt — kopieren Sie ihn sofort. Verloren? Dann einen neuen ausstellen und den alten widerrufen.

Der Schlüssel arbeitet im Namen des Mitarbeiters, der ihn ausgestellt hat, und mit dessen Rechten: Bereiche, die für die Person gesperrt sind, sind auch für den Agenten gesperrt. Ein Schlüssel „nur lesen“ (Standard) kann physisch nichts im CRM ändern.

2. Server in Ihrer Anwendung eintragen

Separat installieren muss man nichts — npx lädt das Paket selbst herunter.

Das Paket wird direkt von GitHub installiert. Nach der Veröffentlichung auf npm kann man statt github:Skamatoz/yourept-mcp einfach yourept-mcp schreiben.

Claude Desktop — Einstellungen → Developer → Edit Config:

{
  "mcpServers": {
    "yourept": {
      "command": "npx",
      "args": ["-y", "github:Skamatoz/yourept-mcp"],
      "env": {
        "YOUREPT_API_URL": "https://api-admin.yourept.ru",
        "YOUREPT_API_KEY": "yrp_live_ваш_ключ"
      }
    }
  }
}

Claude Code:

claude mcp add yourept \
  --env YOUREPT_API_URL=https://api-admin.yourept.ru \
  --env YOUREPT_API_KEY=yrp_live_ваш_ключ \
  -- npx -y github:Skamatoz/yourept-mcp

Cursor — Datei ~/.cursor/mcp.json, Format wie bei Claude Desktop.

Codex — Datei ~/.codex/config.toml:

[mcp_servers.yourept]
command = "npx"
args = ["-y", "github:Skamatoz/yourept-mcp"]

[mcp_servers.yourept.env]
YOUREPT_API_URL = "https://api-admin.yourept.ru"
YOUREPT_API_KEY = "yrp_live_ваш_ключ"

Nach der Änderung der Konfiguration muss die Anwendung neu gestartet werden.

Related MCP server: mcp-server-salesforce

Was er kann

Beträge werden in Rubel ausgegeben, die Zeit ist Moskauer Zeit.

Wenn etwas nicht funktioniert

„Schlüssel ungültig“ — der Schlüssel wurde widerrufen, ist abgelaufen oder mit Zeichenverlust kopiert worden. Prüfen Sie ihn im Admin-Bereich und stellen Sie bei Bedarf einen neuen aus.

„Nicht genügend Rechte“ — der Mitarbeiter, auf den der Schlüssel ausgestellt ist, hat keinen Zugriff auf diesen Bereich. Fragen Sie den Agenten nach whoami: Er zeigt, welche Bereiche geöffnet sind.

„Schlüssel ist nur zum Lesen ausgestellt“ — erwartungsgemäß: Der Schlüssel ändert standardmäßig nichts.

„Der Admin-Bereich hat nicht geantwortet“ — prüfen Sie YOUREPT_API_URL. Es wird die Adresse benötigt, über die die API läuft (beginnt normalerweise mit api-), nicht die Adresse der Website des Admin-Bereichs.

Der Server erscheint nicht in der Liste — fast immer eine nicht geschlossene Klammer oder ein überflüssiges Komma in der Konfiguration. Im Admin-Bereich gibt es auf dem Bildschirm zur Schlüsselausstellung ein fertiges Snippet zum vollständigen Kopieren.

Sicherheit

• In der Datenbank wird nur der Hash des Schlüssels gespeichert — den Schlüssel selbst kann man daraus nicht wiederherstellen.

• Der Schlüssel erbt die Rechte seines Mitarbeiters und kann diese nicht überschreiten.

• Mit einem Schlüssel kann man keine Schlüssel verwalten: Einen neuen Zugang über die API kann man sich nicht ausstellen.

• Der Widerruf wirkt sofort.

• Personenbezogene Daten, die nicht in der Oberfläche vorhanden sind (Transkripte von Probestunden), sind über diesen Server nicht verfügbar.

Beim Ausscheiden eines Mitarbeiters widerrufen Sie dessen Schlüssel zusammen mit dem Benutzerkonto.

Entwicklung

pnpm install
pnpm build     # tsc → dist/

Server prüfen, ohne ihn an einen Client anzuschließen:

printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"t","version":"1"}}}' \
  '{"jsonrpc":"2.0","method":"notifications/initialized"}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \
  | YOUREPT_API_URL=http://localhost:4001 YOUREPT_API_KEY=ключ node dist/index.js

Die Diagnose läuft über stderr — auf stdout kommt nur das Protokoll, dorthin darf nichts geschrieben werden.