Agent-Aktionen via MCP — Einrichtungs- und Supportleitfaden

Verbinden Sie Claude, ChatGPT oder einen beliebigen MCP-Client über OAuth 2.0 und Streamable HTTP mit kontrollierten Numezis-Agent-Aktionen.

Numezis stellt kontrollierte Agent-Aktionen über einen Remote-MCP-Server bereit. Claude, ChatGPT oder jeder MCP-kompatible Client kann Geschäftsvorgänge in Buchhaltung, Vertrieb, Einkauf, Personalwesen, Lager, CRM und Dokumenten-Workflows vorbereiten oder ausführen, während Numezis Berechtigungen, Freigaben und Audit-Trail erzwingt.

Überblick

Der MCP-Endpunkt ist unter https://www.numezis.com/mcp über Streamable HTTP und JSON-RPC 2.0 verfügbar. Der Connector erlaubt einem Agent-Client kontrollierte Geschäftsvorgänge, während Numezis Berechtigungen, Freigaberichtlinien und Portal-Scope durchsetzt.

Voraussetzungen

Aktives Numezis-Abonnement mit Zugriff auf das Unternehmens- oder Partnerportal.
Ein Claude.ai-Konto mit aktiviertem Connector-Zugriff.
Ein authentifizierter Numezis-Benutzer mit Berechtigungen für die gewünschten Module.
In den Numezis-Einstellungen aktivierte Unternehmensmodule (Tools sind capability-gesteuert).

In Claude.ai verbinden

Öffnen Sie Claude.ai, gehen Sie zu Connectors und fügen Sie einen benutzerdefinierten Remote-MCP-Server hinzu.
Setzen Sie die Server-URL auf https://www.numezis.com/mcp.
Wählen Sie OAuth-2.0-Authentifizierung (Dynamic Client Registration wird unterstützt).
Melden Sie sich bei Numezis an und genehmigen Sie die angeforderten Scopes.
Führen Sie nach der Autorisierung eine tools/list-Anfrage aus, um die Modulsichtbarkeit zu bestätigen.

Codebeispiele

Nutzen Sie diese kopierfertigen Snippets, um sich von Claude, ChatGPT oder einem direkten HTTP-Client zu verbinden.

Claude / Cowork benutzerdefinierter Connector

Name: Numezis
Server URL: https://www.numezis.com/mcp
Authentication: OAuth
OAuth registration: Dynamic Client Registration (DCR)
Default scopes:
  mcp.tools.read
  mcp.tools.execute
  mcp.tools.write
Base parameters: leave empty

# Fallback only when the client cannot use DCR:
Client ID: numezis-mcp-connect
Client secret: leave empty

ChatGPT benutzerdefinierte MCP-App

Name: Numezis
Server URL: https://www.numezis.com/mcp
Authentication: OAuth
OAuth registration: Dynamic Client Registration (DCR)
Default scopes:
  mcp.tools.read
  mcp.tools.execute
  mcp.tools.write
Base parameters: leave empty

# If DCR is unavailable, use the fallback static client:
Client ID: numezis-mcp-connect
Client secret: leave empty

HTTP JSON-RPC (Dienstkonten)

const response = await fetch("https://www.numezis.com/mcp", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Accept": "application/json, text/event-stream",
    "Authorization": "Bearer " + process.env.NUMEZIS_SERVICE_ACCOUNT_KEY,
    "X-Portal": "company",
    "MCP-Protocol-Version": "2025-03-26",
  },
  body: JSON.stringify({
    jsonrpc: "2.0",
    id: "tools-list-1",
    method: "tools/list",
    params: {},
  }),
});

const payload = await response.json();

Verfügbare Modulgruppen

Die Tool-Verfügbarkeit hängt von Ihren aktivierten Modulen und Benutzerberechtigungen ab. Zu den Kerngruppen gehören:

Finanzen — Buchhaltung, Vertrieb, Einkauf, Abgleich, MwSt.-Workflows und Hauptbuchvorgänge.
Personen — Personal-Workflows wie Mitarbeitende, Verträge, Abwesenheiten und lohnbezogene Vorgänge.
Betrieb — Lager, Projektbetrieb und Aufgabenverwaltung.
Kunden — CRM, Kontakte und kollaborative Kommentare an Geschäftsdatensätzen.
Dokumente & Daten — Dokumentenerfassung, Klassifizierung und governte Datenimport-Abläufe.
Integrationen — Google-, Microsoft- und Anreicherungs-/Intelligence-Connectoren, sofern aktiviert.
Plattform — Freigaben, Modulkonfiguration und zentrale Plattformfunktionen.

Sicherheit und Datenverarbeitung

Der Transport nutzt HTTPS/TLS mit OAuth Protected Resource Metadata.
Der Zugriff wird serverseitig über AccessMode, Portalkontext und Berechtigungsprüfungen eingegrenzt.
Kritische Mutationen können vor der Ausführung eine ausdrückliche Freigabe erfordern.
Betriebsprotokolle und Audits können gemäss Plattformrichtlinie aufbewahrt werden; Details finden Sie in der Datenschutzerklärung und im AVV.

FAQ

Ist dieser Connector schreibgeschützt?

Nein. Er unterstützt Lese- und Schreibvorgänge, mit Governance- und Freigabekontrollen für sensible Aktionen.

Kann ich pro Benutzer eine eigene MCP-URL verwenden?

Nein. Numezis stellt derzeit eine universelle Remote-URL bereit: https://www.numezis.com/mcp.

Welcher Transport wird unterstützt?

Streamable HTTP wird unterstützt. Veraltete SSE-Endpunkte sind nicht mehr empfohlen.

Wie werden Berechtigungen durchgesetzt?

Berechtigungen werden bei jeder Anfrage über Benutzerrolle, aktivierte Module und portalbezogene AccessMode-Prüfungen durchgesetzt.

Erfordern kritische Aktionen eine Bestätigung?

Ja. Je nach Richtlinie und Tool-Manifest-Sicherheit können destruktive Aktionen einen Freigabeschritt auslösen.

Wo erhalte ich Support?

Kontaktieren Sie den Numezis-Support und konsultieren Sie die Datenschutzerklärung und den AVV im Bereich Sicherheit.

Support und Rechtliches

Für Onboarding-Hilfe oder Incident-Support kontaktieren Sie den Numezis-Support. Die Datenschutzerklärung und der AVV sind öffentlich im Bereich Sicherheit verfügbar.

Wo in der App

Unternehmen → Agent — /c/companies/:companyId/agent
MCP-Endpunkt — https://www.numezis.com/mcp

Schritt für Schritt

Aktivieren Sie das Agent-Modul und die Berechtigungen. Nach OAuth sind die Tools sichtbar.
Registrieren Sie https://www.numezis.com/mcp im Client (DCR- oder Client-ID-Ablauf).
Schliessen Sie OAuth ab und führen Sie tools/list aus. Nur berechtigte Tools erscheinen.
Führen Sie ein Lese-Tool aus, dann eine Mutation. Kritische Tools liefern ein Freigabe-Token zurück.
Geben Sie bei Aufforderung in der Oberfläche frei. Die Mutation wird mit Audit abgeschlossen.
Prüfen Sie den Prüfpfad auf dem Datensatz.

Berechtigungen und Module

Agent-Modul; Prüfungen auf Tool-Ebene über AccessMode.