MCP Cliniko Server

Ein Model Context Protocol (MCP) Server, der eine Integration mit der Cliniko-API für das Management von Gesundheitspraxen bietet.

Funktionen

Tools (Aktionen)

Patientenverwaltung
- list_patients - Patienten suchen und auflisten
- get_patient - Patient nach ID abrufen
- create_patient - Neuen Patienten anlegen
- update_patient - Patientendaten aktualisieren
- delete_patient - Patienten archivieren
Terminverwaltung
- list_appointments - Termine suchen und auflisten
- get_appointment - Termin nach ID abrufen
- create_appointment - Neuen Termin buchen
- update_appointment - Termin ändern
- cancel_appointment - Termin stornieren
- delete_appointment - Termin löschen
- get_available_times - Verfügbarkeit von Behandlern abrufen
Rechnungsverwaltung
- list_invoices - Rechnungen auflisten und filtern
- get_invoice - Rechnungsdetails abrufen
- create_invoice - Neue Rechnung erstellen
- update_invoice - Rechnungsstatus oder -details aktualisieren
- delete_invoice - Entwurfsrechnung löschen
Rechnungspositionen
- list_invoice_items - Positionen einer Rechnung auflisten
- add_invoice_item - Position zur Rechnung hinzufügen
- update_invoice_item - Rechnungsposition ändern
- delete_invoice_item - Position aus Rechnung entfernen
Zahlungsabwicklung
- list_payments - Zahlungen mit Filterung auflisten
- create_payment - Zahlung erfassen
- delete_payment - Zahlungsdatensatz löschen
Produkte & Dienstleistungen
- list_products - Abrechenbare Produkte/Dienstleistungen auflisten
- get_product - Produktdetails abrufen
- create_product - Neues Produkt/Dienstleistung erstellen
Steuerkonfiguration
- list_taxes - Verfügbare Steuersätze auflisten
- get_tax - Steuerdetails abrufen
Komplexe Workflows
- create_invoice_from_appointments - Rechnungen aus Terminen generieren
- bulk_invoice_generation - Massenerstellung von Rechnungen für einen Datumsbereich
- list_patient_cases - Patientenakten auflisten
- list_invoices_for_case - Rechnungen für eine Akte abrufen
Unterstützende Tools
- list_practitioners - Alle Behandler auflisten
- list_appointment_types - Terminarten auflisten
- list_businesses - Unternehmen auflisten
Testdaten
- generate_test_data - Synthetische australische Gesundheitsdaten generieren
- cleanup_test_data - Testpatienten entfernen

Ressourcen (Datenzugriff)

patient://{id} - Individuelle Patientendaten
patients://list - Alle Patienten
appointment://{id} - Individueller Termin
appointments://list - Alle Termine
appointments://today - Heutige Termine
practitioners://list - Alle Behandler
businesses://list - Alle Unternehmen
appointment-types://list - Alle Terminarten
openapi://spec - Cliniko API OpenAPI-Spezifikation (YAML-Format)

Installation

Repository klonen:

git clone https://github.com/yourusername/mcp-cliniko.git
cd mcp-cliniko

Abhängigkeiten installieren:

npm install

Cliniko API-Schlüssel einrichten:

cp .env.example .env
# Edit .env and add your Cliniko API key

Projekt bauen:

npm run build

Konfiguration

Umgebungsvariablen

CLINIKO_API_KEY - Ihr Cliniko API-Schlüssel (erforderlich)

Einen Cliniko API-Schlüssel erhalten

Melden Sie sich bei Ihrem Cliniko-Konto an
Gehen Sie zu Einstellungen → Integrationen → API-Schlüssel
Erstellen Sie einen neuen API-Schlüssel
Kopieren Sie den Schlüssel in Ihre .env-Datei

Verwendung

Entwicklungsmodus

npm run dev

Produktionsmodus

npm start

Testen mit dem MCP Inspector

npm run inspect

Integration mit Claude Desktop

Fügen Sie dies zu Ihrer Claude Desktop-Konfiguration hinzu (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "cliniko": {
      "command": "node",
      "args": ["/path/to/mcp-cliniko/dist/index.js"],
      "env": {
        "CLINIKO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Beispiele

Verwendung von Tools

Patienten auflisten:

{
  "tool": "list_patients",
  "arguments": {
    "q": "Smith",
    "per_page": 10
  }
}

Patient erstellen:

{
  "tool": "create_patient",
  "arguments": {
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com",
    "phone_number": "0412345678",
    "date_of_birth": "1980-01-15",
    "medicare_number": "1234567890"
  }
}

Termin buchen:

{
  "tool": "create_appointment",
  "arguments": {
    "starts_at": "2024-01-20T10:00:00Z",
    "patient_id": 123,
    "practitioner_id": 456,
    "appointment_type_id": 789,
    "business_id": 101
  }
}

Testdaten generieren:

{
  "tool": "generate_test_data",
  "arguments": {
    "num_patients": 5,
    "num_appointments": 10,
    "days_ahead": 7
  }
}

Verwendung von Ressourcen

Ressourcen bieten schreibgeschützten Zugriff auf Cliniko-Daten:

patient://123 - Patient mit ID 123 abrufen
patients://list - Alle Patienten auflisten
appointments://today - Heutige Termine abrufen

API-Ratenbegrenzungen

Die Cliniko-API hat eine Ratenbegrenzung von 200 Anfragen pro Minute. Der Server implementiert intern keine Ratenbegrenzung, seien Sie daher bei Massenvorgängen vorsichtig.

Fehlerbehandlung

Der Server verwendet Standard-HTTP-Fehlerkonventionen:

400 - Bad Request (Fehlerhafte Anfrage)
401 - Unauthorized (Nicht autorisiert, API-Schlüssel prüfen)
404 - Resource not found (Ressource nicht gefunden)
429 - Rate limit exceeded (Ratenbegrenzung überschritten)
500 - Internal server error (Interner Serverfehler)

Entwicklung

Projektstruktur

mcp-cliniko/
├── src/
│   ├── index.ts              # Main server
│   ├── cliniko-client.ts     # API client
│   ├── types.ts              # TypeScript types
│   ├── tools/                # MCP tools
│   │   ├── patients.ts
│   │   ├── appointments.ts
│   │   └── synthetic-data.ts
│   └── resources/            # MCP resources
│       └── index.ts
├── dist/                     # Compiled JavaScript
├── package.json
├── tsconfig.json
└── .env

Bauen

npm run build

Typüberprüfung

npx tsc --noEmit

Lizenz

MIT

Support

Für die Cliniko-API-Dokumentation besuchen Sie: https://docs.api.cliniko.com/

Für die MCP-Dokumentation besuchen Sie: https://modelcontextprotocol.io/

mcp-cliniko