AJEMS MCP Connector

Ermöglicht Claude und ChatGPT, Fragen zu einem AJEMS-Arbeitsbereich zu beantworten – und optional Apps, Formulare und Datensätze zu erstellen – ohne dass sich jemand bei AJEMS anmeldet.

Eine Bereitstellung bedient alle Mandanten. Benutzer melden sich mit ihrem Organisationsnamen und ihrem AJEMS-Geheimschlüssel an.

Dateien

Related MCP server: BackCrew ServiceM8 MCP Server

Schnellstart

npm install
cp .env.example .env      # set PUBLIC_URL and AJEMS_HOST_TEMPLATE
npm start

Gegen einen echten Arbeitsbereich verifizieren:

node diagnose.js https://mcp.ajems.com <organisation> <secret-key>

Oder ganz ohne AJEMS ausprobieren:

npm run mock              # terminal 1
# set AJEMS_HOST_TEMPLATE=http://localhost:9090/{org}/json_builder
npm start                 # terminal 2
node diagnose.js http://localhost:8080 testco test-secret-key

Siehe DEPLOY.md für nginx, TLS, pm2 und Tuning.

Tools

Standardmäßig schreibgeschützt. Setzen Sie ALLOW_WRITES=true für die vier Schreib-Tools.

aggregate_responses berechnet auf dem Server. Ohne dieses Tool würde „Summe nach Stadt“ Tausende von Zeilen in den Kontext des Modells ziehen und von Hand zählen – langsam, teuer und ab einer bestimmten Größe falsch.

search und fetch existieren, weil ChatGPT außerhalb des Entwicklermodus nur Tools mit diesen beiden Namen aufruft und alles andere ignoriert.

Wie eine Frage beantwortet wird

Claude fragt: „Wie viele Einträge im Juli, nach Stadt?“

1. list_apps_and_forms → findet das Formular

2. describe_form → erfährt, dass date_1750943312417 das Datumsfeld ist und dropdown_1750943301432 Städte enthält

3. aggregate_responses mit einem Datumsbereich und group_by → erhält drei Zahlen zurück

4. Schreibt die Antwort in einfachem Englisch

Feld-Schlüssel werden automatisch generiert (date_1750943312417), weshalb Schritt 2 nicht optional ist. Die Tool-Beschreibungen sagen dem Modell das, und es verknüpft die Aufrufe selbst.

Mandantenisolation

• Mandant stammt aus der Sitzung, serverseitig aus dem Bearer-Token aufgelöst

• Kein Tool-Schema hat einen tenant-, org- oder url-Parameter – es gibt nichts, wovon ein Modell überredet werden könnte, es zu ändern

• ajems.js ist das einzige Modul, das ausgehende Anfragen stellt, und nur an die Basis-URL dieses Mandanten

• Cache-Schlüssel sind nach Mandant und einem Hash des Geheimschlüssels benannt, sodass Mandanten keine zwischengespeicherten Einträge des anderen lesen können und ein rotierter Schlüssel von selbst abläuft

• Organisationsnamen werden auf subdomain-sichere Zeichen reduziert, sodass ein Eintrag wie evil.com/x den Server nicht woandershin umleiten kann

• Jeder Tool-Aufruf wird als JSON mit Mandant und Benutzer protokolliert

Wenn Sie ein Tool hinzufügen, überprüfen Sie den zweiten Punkt erneut.

Tests

46 Prüfungen bestehen gegen den Mock: Authentifizierung, alle 10 Tools, Filter, Datumsbereiche, der created_at-Fallback, gruppierte Aggregation, Masseneinfügung, Cache-Invalidierung nach Schreibvorgängen, Fehlermeldungen, Mandantenisolation, 20 gleichzeitige Benutzer und Ratenbegrenzung.