SimpliServDocs

Claude

SimpliServ als Connector in Claude einrichten – Custom Connector anlegen, per OAuth anmelden und Tool-Berechtigungen setzen

→ Connectoren in Claude öffnen · MCP-Connector öffnen

SimpliServ als Connector in Claude einrichten: danach liest Claude deine Kunden, Aufträge, Rechnungen und Lagerdaten und führt – nach deiner Freigabe – auch Aktionen aus.

Du brauchst ein Claude-Konto mit Pro, Max, Team oder Enterprise und einen SimpliServ-Benutzer mit der Berechtigung MCP-Schnittstelle → Zugriff. Einen API-Schlüssel brauchst du nicht – die Anmeldung läuft über OAuth. Für ChatGPT gibt es eine eigene Anleitung.

Einrichtung (Claude im Browser)

Connectoren öffnen

→ Connectoren in Claude öffnen

Alternativ in Claude auf Customize → Connectors. Oben rechts auf Add klicken und Add custom connector wählen.

Connector-Übersicht in Claude mit geöffnetem Add-Menü

Findest du den Punkt nicht: Connectoren sind aus den allgemeinen Einstellungen in den Bereich Customize umgezogen.

Felder ausfüllen

Im Dialog Add custom connector trägst du ein – jeder Block hat rechts einen Kopier-Button:

Name

SimpliServ

Remote MCP server URL

https://api.simpliserv.app/api/v1/mcp
Dialog Add custom connector mit ausgefülltem Namen und Server-URL

Die Felder unter Advanced settings (OAuth Client ID und Secret) bleiben leer: Claude ermittelt sie automatisch über /.well-known/oauth-authorization-server und registriert sich per Dynamic Client Registration selbst. Danach auf Add klicken.

Anmelden und zustimmen

Claude öffnet den SimpliServ-Login. Melde dich mit deinem Workspace-Benutzer an und bestätige den Consent-Screen. Danach steht der Connector in der Liste mit einem Haken bei Status.

Werkzeuge freigeben

Klicke den Connector in der Liste an. Unter Tool permissions siehst du alle Werkzeuge, getrennt nach Read-only tools und Write/delete tools. Pro Werkzeug wählst du zwischen drei Modi:

SymbolBedeutung
HakenImmer erlauben – Claude nutzt das Werkzeug ohne Rückfrage
HandNachfragen – Claude fragt vor jeder Verwendung
VerbotszeichenBlockiert – Claude darf das Werkzeug nicht nutzen
Tool-Berechtigungen des SimpliServ-Connectors in Claude

Über den Schalter rechts neben der Gruppenüberschrift setzt du alle Werkzeuge einer Gruppe auf einmal.

Gruppe Write/delete tools mit Sammelschalter

Für den Anfang empfiehlt sich: Read-only tools erlauben, Write/delete tools auf Nachfragen stellen. So kann Claude frei recherchieren, aber nichts ohne deine Zustimmung anlegen, ändern oder löschen.

Einrichtung (Claude Desktop)

Claude Desktop liest MCP-Server aus claude_desktop_config.json (macOS: ~/Library/Application Support/Claude, Windows: %APPDATA%\Claude). Für den OAuth-Flow nutzt du die mcp-remote-Bridge.

Konfiguration öffnen

Claude → Einstellungen → Developer → Edit Config (oder die Datei manuell bearbeiten).

Server-Eintrag hinzufügen

Unter mcpServers einen Eintrag ergänzen:

"simpliserv": {
  "command": "npx",
  "args": ["-y", "mcp-remote", "https://api.simpliserv.app/api/v1/mcp"]
}

Neu starten und zustimmen

Claude Desktop beenden und neu starten. Beim ersten Start öffnet sich ein Browserfenster für die OAuth-Zustimmung. Nach der Bestätigung erscheinen die Werkzeuge im Werkzeug-Menü.

Nutzung im Chat

Der Connector lässt sich pro Unterhaltung ein- und ausschalten: im Eingabefeld auf +, dann Connectors und den Schalter neben SimpliServ aktivieren.

Connector-Menü im Claude-Eingabefeld mit Schalter für SimpliServ

Danach sprichst du Claude einfach an, z. B. „Zeig mir die offenen Rechnungen von Kunde Müller".

Ein verbundener Connector erbt die Rollen und Rechte deines Benutzers – er sieht und darf nur, was du auch siehst und darfst. Siehe Benutzer & Rollen.

Mehrere Arbeitsbereiche

Gehörst du zu mehreren Arbeitsbereichen, arbeitet der Connector immer mit deinem Standard-Arbeitsbereich. Umschalten wie in der Weboberfläche ist nicht möglich, weil Claude keine Arbeitsbereich-Kennung mitsendet. Zugriff auf andere Arbeitsbereiche ist ausgeschlossen – deine Mitgliedschaft wird bei jeder Anfrage geprüft.

Zugriff wieder entziehen

Zwei Wege, beide wirken sofort:

  • In Claude: Connector öffnen und auf Disconnect klicken.
  • In SimpliServ: im MCP-Connector unter Autorisierte OAuth-Clients auf Widerrufen klicken. Damit werden aktive Sitzungen beendet und alle Access-Tokens entwertet.

Wenn es nicht klappt

SymptomUrsache und Lösung
Kein Add custom connector im MenüDer Tarif erlaubt keine eigenen Connectoren, oder in Team/Enterprise hat der Administrator sie gesperrt.
Connector zeigt „Connection issue"URL exakt prüfen: https://api.simpliserv.app/api/v1/mcp, ohne Schrägstrich am Ende. Danach neu verbinden.
Login klappt, aber keine WerkzeugeDeinem Benutzer fehlt die Berechtigung MCP-Schnittstelle → Zugriff – siehe Benutzer & Rollen.
Claude nutzt ein Werkzeug nichtEs steht unter Tool permissions auf blockiert.
Daten aus dem falschen ArbeitsbereichDer Connector nutzt immer deinen Standard-Arbeitsbereich, siehe Mehrere Arbeitsbereiche.

Verwandte Themen

How is this guide?

On this page