MCP-Schnittstelle und API für KI-Tools

Unterstützte KI-Tools

Ein Anschluss, alle gängigen KI-Tools.

MCP, das Model Context Protocol, ist der offene Standard dafür. Was ihn spricht, lässt sich mit HerzensManagement verbinden.

Claude Desktop Anthropic Als Connector in den Einstellungen
Claude Code Anthropic Ein Befehl im Terminal
ChatGPT OpenAI Als eigener Connector
Cursor Anysphere Eintrag in mcp.json
GitHub Copilot in VS Code MCP-Server im Agent-Modus
Gemini CLI Google Eintrag in settings.json
Windsurf Cognition MCP-Server in Cascade
Le Chat Mistral AI Als eigener Connector
n8n Automatisierung MCP-Client-Knoten im Workflow
und jedes weitere Tool, das MCP unterstützt

So funktioniert es

Fragen statt klicken.

Das KI-Tool entscheidet selbst, welche Werkzeuge es für Ihre Frage braucht, ruft sie bei HerzensManagement auf und antwortet mit den Daten Ihrer Agentur.

Sie fragen

In normaler Sprache, in dem Tool, das Sie ohnehin nutzen.

Das Tool ruft Werkzeuge auf

Zum Beispiel list_shifts oder list_invoices. Alle Werkzeuge lesen nur.

HerzensManagement liefert

Nur Daten Ihrer Agentur, und nur aus den Bereichen, für die der Schlüssel berechtigt ist.

Anwendungsfälle

Wofür Agenturen und Teams das nutzen können.

Wochenüberblick ohne Klicken

„Welche Turnusse wechseln nächste Woche?“

Das KI-Tool liest die Turnusse des Zeitraums und listet, bei welchen Klienten ein Wechsel ansteht und welche Betreuungskraft eingeteilt ist.

Offene Rechnungen im Blick

„Welche Rechnungen sind noch offen?“

Rechnungen mit Status, Betrag und Zeitraum abfragen und sich das Ergebnis zusammenfassen lassen.

Verfügbarkeit klären

„Welche Betreuungskräfte sind ab 1. November verfügbar?“

Das KI-Tool liest Betreuungskräfte und ihre Turnusse und nennt, wer ab dem Datum nicht eingeteilt ist.

Monatsüberblick für die Geschäftsführung

„Erstelle mir den Überblick für Oktober.“

Klienten nach Status, Turnusse und Rechnungen des Monats als Bericht, im Format, das Ihr KI-Tool am besten kann.

Eigene Abläufe in n8n

Jeden Montag die Turnuswechsel der Woche an das Team schicken.

In n8n dienen dieselben Werkzeuge als Bausteine eines Workflows. HerzensManagement liefert die Daten; was danach geschieht, bestimmt Ihr Workflow.

Für Ihre Entwickler

„Zeig mir die Turnusse eines Klienten im Dezember.“

Wer eine eigene Anwendung anbindet, hat die Daten der Agentur direkt in Claude Code oder Cursor zur Hand.

Einrichtung

Schlüssel anlegen, eintragen, verbunden.

Nach der Freischaltung legt Ihr Agentur-Admin im Panel unter „Einstellungen → API“ einen Schlüssel an: mit Namen, einer Auswahl an Berechtigungen und optionalem Ablaufdatum. Der Schlüssel wird genau einmal angezeigt und lässt sich jederzeit widerrufen.

Adresse und Schlüssel in den Beispielen sind Platzhalter. Die echte Adresse Ihrer Schnittstelle steht im Panel unter „Einstellungen → API“.

Claude Desktop

claude_desktop_config.json

{
  "mcpServers": {
    "herzensmanagement": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://IHRE-API-ADRESSE/api/mcp",
        "--header", "Authorization: Bearer ${HERZENS_API_KEY}"
      ],
      "env": { "HERZENS_API_KEY": "IHR-SCHLUESSEL" }
    }
  }
}

Einstellungen → Entwickler → Konfiguration bearbeiten. Danach Claude neu starten.

Claude Code

Terminal

claude mcp add --transport http herzensmanagement \
  https://IHRE-API-ADRESSE/api/mcp \
  --header "Authorization: Bearer IHR-SCHLUESSEL"

Ein Befehl im Projektordner. Mit /mcp prüfen Sie danach die Verbindung.

ChatGPT

Einstellungen → Connectors

Name:            HerzensManagement
MCP-Server-URL:  https://IHRE-API-ADRESSE/api/mcp
Anmeldung:       API-Schlüssel (IHR-SCHLUESSEL)

Danach im Chat den Connector „HerzensManagement“ auswählen.

Eigene Connectors brauchen den Entwicklermodus Ihres ChatGPT-Arbeitsbereichs.

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "herzensmanagement": {
      "url": "https://IHRE-API-ADRESSE/api/mcp",
      "headers": { "Authorization": "Bearer IHR-SCHLUESSEL" }
    }
  }
}

Gilt für das Projekt; unter ~/.cursor/mcp.json für alle Projekte.

Direkt (JSON-RPC)

Terminal

curl -X POST https://IHRE-API-ADRESSE/api/mcp \
  -H "Authorization: Bearer IHR-SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

MCP ist ein offener Standard. So fragen Sie ohne KI-Tool ab, welche Werkzeuge Ihr Schlüssel nutzen darf.

Übertragung: MCP über HTTP (Streamable HTTP), Anmeldung mit Authorization: Bearer <Schlüssel>.

Dieselben Daten gibt es auch als gewöhnliche REST-API (/api/v1/..., Bearer-Schlüssel). Die Entwicklerdokumentation mit Schnellstart und Beispielen steht im Panel neben den Schlüssel-Einstellungen.

Werkzeuge

Was Ihr KI-Tool in HerzensManagement lesen kann.

Sieben Werkzeuge, alle ausschließlich lesend. Schreibende Werkzeuge gibt es nicht. Welche Bereiche ein Schlüssel lesen darf, legen Sie über seine Berechtigungen fest:

clients:read caregivers:read shifts:read invoices:read

Werkzeug	Was es liefert	Zugriff
`get_agency`	Stammdaten Ihrer Agentur	Lesen
`list_clients`	Klienten mit Status, Ort und Pflegestufe; Filter nach Status, Suche	Lesen
`get_client`	Ein einzelner Klient	Lesen
`list_caregivers`	Betreuungskräfte; Filter nach Status, Suche	Lesen
`get_caregiver`	Eine einzelne Betreuungskraft	Lesen
`list_shifts`	Turnusse in einem Zeitraum, je Klient oder Betreuungskraft	Lesen
`list_invoices`	Rechnungen mit Status, Betrag und Zeitraum	Lesen

Sie bestimmen, was ein KI-Tool sieht.

Jeder Schlüssel gilt nur für Ihre eine Agentur, liest ausschließlich und lässt sich jederzeit widerrufen. Was ein Werkzeug zurückgibt, verarbeitet der Anbieter Ihres KI-Tools. Für personenbezogene Daten von Klienten und Betreuungskräften, darunter gesundheitsbezogene Angaben, brauchen Sie mit diesem Anbieter einen Auftragsverarbeitungsvertrag. Über die Berechtigungen beschränken Sie einen Schlüssel auf weniger sensible Bereiche.

Demo vereinbaren

Häufige Fragen

Was ist MCP?

Das Model Context Protocol ist ein offener Standard, über den KI-Tools wie Claude oder ChatGPT auf fremde Systeme zugreifen. Ein Dienst beschreibt dort seine Werkzeuge, das KI-Tool ruft sie bei Bedarf auf. Sie brauchen dafür keine eigene Programmierung.

Welches KI-Tool brauche ich?

Jedes, das MCP unterstützt. Dazu gehören Claude Desktop, Claude Code, ChatGPT, Cursor, GitHub Copilot in VS Code, Gemini CLI, Windsurf, Le Chat und n8n. Auch jedes andere MCP-fähige Tool lässt sich verbinden.

Kann das KI-Tool etwas verändern?

Nein. Alle Werkzeuge lesen nur. Schreibende Werkzeuge gibt es nicht.

Auf welche Daten kann das KI-Tool zugreifen?

Auf Stammdaten der Agentur, Klienten, Betreuungskräfte, Turnusse und Rechnungen, und nur auf die der Agentur, zu der der Schlüssel gehört. Mit den Berechtigungen clients:read, caregivers:read, shifts:read und invoices:read legen Sie je Schlüssel fest, welche Bereiche er lesen darf.

Was bedeutet das für den Datenschutz?

Was ein Werkzeug zurückgibt, verarbeitet der Anbieter Ihres KI-Tools. Für personenbezogene Daten von Klienten und Betreuungskräften, darunter gesundheitsbezogene Angaben, brauchen Sie mit diesem Anbieter deshalb einen Auftragsverarbeitungsvertrag. Über die Berechtigungen können Sie einen Schlüssel auf weniger sensible Bereiche beschränken.

Wie bekomme ich den Zugang?

Die Schnittstelle ist standardmäßig ausgeschaltet. Auf Anfrage schaltet das HerzensManagement-Team sie für Ihre Agentur frei. Danach legt Ihr Agentur-Admin im Panel unter „Einstellungen → API“ einen Schlüssel an: mit Namen, Berechtigungen und optionalem Ablaufdatum. Der Schlüssel wird genau einmal angezeigt und lässt sich jederzeit widerrufen.

Gibt es auch eine gewöhnliche API?

Ja. Dieselben Daten gibt es als REST-API unter /api/v1/..., angemeldet mit einem Bearer-Schlüssel. Die Entwicklerdokumentation mit Schnellstart und Beispielen steht im Panel neben den Schlüssel-Einstellungen.

Connect HerzensManagement to any AI tool