RAKUS MCP-Server

Dies ist ein MCP-Server, der es ermöglicht, die folgenden APIs über die „Custom Connectors" von Claude aufzurufen, basierend auf dem API-Integrationshandbuch von RAKUS (2025/02, 15. Auflage).

• Datei-Upload / CSV-Dateiimport / CSV-Datenimport / CSV-Importstatusabfrage / CSV-Export

• Datensatzregistrierung / Aktualisierung / Löschung / Abfrage

Vorbereitung (auf RAKUS-Seite)

1. API-Integrationsoptionsvertrag + Einrichtung der IP-Zugriffsbeschränkung sind erforderlich (Handbuch Kapitel 1 und 5). Erlauben Sie die Quell-IP des Bereitstellungsservers unter Administratoreinstellungen > Registerkarte Sicherheitseinstellungen > Einstellungen zur IP-Zugriffsbeschränkung. (Bei PaaS-Anbietern ohne feste IP wie Render kann die Nutzung eines Static Outbound IP Add-ons erforderlich sein.)

2. Generieren und bestätigen Sie das API-Token im Benutzereinstellungsbildschirm (Handbuch Kapitel 3).

3. Die „dbSchemaId", „importId", „Feld-ID" usw. der einzelnen DBs finden Sie unter Administratoreinstellungen > Registerkarte Wartungsfunktionen > API-Parameterinformationen.

Bereitstellungsanleitung (Render, ausführliche Version)

Für alle, die zum ersten Mal PaaS verwenden, haben wir eine durchgängige Anleitung vom Push zu GitHub bis zur Verbindung mit Claude in RENDER_DEPLOY.md zusammengefasst. Bitte schauen Sie sich zuerst diese Datei an. Die Blueprint-Bereitstellung mit render.yaml wird unterstützt.

Kurz zusammengefasst:

1. Diesen Ordner in ein GitHub-Repository pushen

2. In Render einen Web Service aus dem Blueprint (render.yaml) erstellen (Plan starter oder höher)

3. RAKURAKU_DOMAIN / RAKURAKU_ACCOUNT / RAKURAKU_API_TOKEN / MCP_SHARED_SECRET als Umgebungsvariablen festlegen

4. „Static Outbound IP Addresses" im Einstellungsbildschirm aktivieren und die angezeigte feste IP in der IP-Zugriffsbeschränkung von RAKUS registrieren

5. https://<Bereitstellungsziel>.onrender.com/mcp als Connector-URL in Claude registrieren

Auch außerhalb von Render (Railway / Fly.io / eigener VPS + PM2 usw.) kann die Bereitstellung mit demselben Verfahren erfolgen, solange die Umgebung Node.js 18 oder höher unterstützt.

Connector-Einstellungen auf Claude-Seite

1. Öffnen Sie im Einstellungsbildschirm von Claude.ai „Custom Connector hinzufügen".

2. Geben Sie die einzelnen Elemente ein.

   • Name: Beliebig (z. B. RAKUS)

   • Remote-MCP-Server-URL: https://<Bereitstellungsziel>/mcp

   • OAuth Client ID / Secret: Leer lassen ist OK (da dieser Server ein einfaches Shared-Secret-Verfahren verwendet)

3. Wenn MCP_SHARED_SECRET festgelegt wurde, konfigurieren Sie den Connector so, dass er den Header Authorization: Bearer <MCP_SHARED_SECRET> sendet. (In der aktuellen Custom-Connector-UI von Claude.ai können zusätzliche Header möglicherweise nicht direkt angegeben werden. In diesem Fall lassen Sie MCP_SHARED_SECRET leer oder schützen Sie den Server über IP-Zugriffsbeschränkungen oder eine eigene Authentifizierungs-Middleware.)

4. Klicken Sie auf „Hinzufügen", um die Verbindung herzustellen.

Lokale Funktionsprüfung

npm install
cp .env.example .env
# .env を編集して RAKURAKU_DOMAIN / RAKURAKU_ACCOUNT / RAKURAKU_API_TOKEN を設定
npm start

Konnektivitätsprüfung von einem anderen Terminal aus:

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

Liste der bereitgestellten Tools

Hinweise

• Die in values bei APIs wie Datensatzregistrierung/-aktualisierung anzugebenden Feld-IDs (z. B. „105110") unterscheiden sich je nach DB. Prüfen Sie diese vorab im Bildschirm „API-Parameterinformationen" und teilen Sie Claude mit: „Die Feld-ID dieser DB ist XX", bevor Sie die Ausführung anfordern.

• Die RAKUS-API hat ein Limit von 20 Anfragen pro Minute (Handbuch Kapitel 5). Bitte beachten Sie dies bei der Verarbeitung großer Datenmengen.

• Geben Sie RAKURAKU_API_TOKEN nicht an Dritte weiter. Es wird empfohlen, die Secret-Funktion der Umgebungsvariablen des Bereitstellungsziels zu verwenden und das Token nicht direkt in Code oder Git-Repositories zu schreiben.