Αναφορά MCP / Ραντεβού

Εργαλεία ραντεβού

Τέσσερα εργαλεία για κρατήσεις, δεσμεύσεις έδρας και υπολογισμένη διαθεσιμότητα. Οι επικαλυπτόμενες κρατήσεις στην ίδια έδρα απορρίπτονται.

Πώς διαβάζεται

Κάθε εργαλείο παρακάτω παραθέτει τις παραμέτρους του ακριβώς όπως τις δηλώνει το σχήμα εισόδου — τον τύπο, αν είναι υποχρεωτική, και τις επιτρεπτές τιμές όπου τις ορίζει το σχήμα. Δεν υπάρχουν περιγραφές παραμέτρων: τα σχήματα φέρουν τύπους, όχι κείμενο.

Το practiceId δεν είναι ποτέ παράμετρος. Προέρχεται από το token σας, και οι διαδρομές εγγραφής το αφαιρούν αν το στείλει ο client.

Κάθε παράδειγμα είναι πλήρες αίτημα tools/call με συμπληρωμένες τις υποχρεωτικές παραμέτρους. Τα σφάλματα επιστρέφονται μέσα σε απόκριση 200 με isError — δείτε την επισκόπηση MCP και τον πλήρη κατάλογο.

Ραντεβού

Κρατήσεις, δεσμεύσεις έδρας και υπολογισμένη διαθεσιμότητα.

list_appointments

Μόνο ανάγνωσηΚάθε μέλος

Λίστα ραντεβού σε χρονικό παράθυρο. Δώστε chairId για περιορισμό σε μία έδρα.

Παράμετροι

Εργαλείο	Τύπος	Υποχρεωτικό;
from	string	Υποχρεωτικό
to	string	Υποχρεωτικό
chairId	string	Προαιρετικό

Παράδειγμα κλήσης

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_appointments",
    "arguments": {
      "from": "2026-07-08T09:00:00.000Z",
      "to": "2026-07-08T17:00:00.000Z"
    }
  }
}

Αποτέλεσμα

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "status": 200,
      "ok": true,
      "data": { "...": "the requested records" }
    }
  }
}

Σφάλματα

Κωδικός	Κατάσταση	Πότε
validation_failed	400	Λείπει παράμετρος, έχει λάθος τύπο, ή είναι εκτός των επιτρεπτών τιμών.
not_found	404	Το id δεν υπάρχει στο ιατρείο σας. Ένα κακοσχηματισμένο id φαίνεται ίδιο.
unauthorized	401	Το bearer token λείπει, είναι άκυρο ή έχει λήξει.

get_appointment

Μόνο ανάγνωσηΚάθε μέλος

Ανάγνωση ενός ραντεβού με βάση το id.

Παράμετροι

Εργαλείο	Τύπος	Υποχρεωτικό;
appointmentId	string	Υποχρεωτικό

Παράδειγμα κλήσης

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_appointment",
    "arguments": {
      "appointmentId": "0f1c7a2e-...."
    }
  }
}

Αποτέλεσμα

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "status": 200,
      "ok": true,
      "data": { "...": "the requested records" }
    }
  }
}

Σφάλματα

Κωδικός	Κατάσταση	Πότε
validation_failed	400	Λείπει παράμετρος, έχει λάθος τύπο, ή είναι εκτός των επιτρεπτών τιμών.
not_found	404	Το id δεν υπάρχει στο ιατρείο σας. Ένα κακοσχηματισμένο id φαίνεται ίδιο.
unauthorized	401	Το bearer token λείπει, είναι άκυρο ή έχει λήξει.

get_appointment_availability

Μόνο ανάγνωσηΚάθε μέλος

Υπολογισμός ελεύθερων διαστημάτων μιας έδρας για μία ημέρα, με βάση το ωράριο, τη ζώνη ώρας και τις υπάρχουσες κρατήσεις.

Παράμετροι

Εργαλείο	Τύπος	Υποχρεωτικό;
chairId	string	Υποχρεωτικό
date	string	Υποχρεωτικό
durationMinutes	integer	Προαιρετικό

Παράδειγμα κλήσης

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_appointment_availability",
    "arguments": {
      "chairId": "0f1c7a2e-....",
      "date": "2026-07-08"
    }
  }
}

Αποτέλεσμα

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "status": 200,
      "ok": true,
      "data": { "...": "the requested records" }
    }
  }
}

Σφάλματα

Κωδικός	Κατάσταση	Πότε
validation_failed	400	Λείπει παράμετρος, έχει λάθος τύπο, ή είναι εκτός των επιτρεπτών τιμών.
not_found	404	Το id δεν υπάρχει στο ιατρείο σας. Ένα κακοσχηματισμένο id φαίνεται ίδιο.
unauthorized	401	Το bearer token λείπει, είναι άκυρο ή έχει λήξει.

write_appointment

ΓράφειΜπορεί να διαγράψειΚάθε μέλος

Δημιουργία, ενημέρωση ή ακύρωση ραντεβού. action=create απαιτεί chairId, startAt και endAt· update και cancel απαιτούν appointmentId. Το type είναι appointment, reminder ή unavailable. Οι επικαλύψεις στην ίδια έδρα απορρίπτονται.

Παράμετροι

Εργαλείο	Τύπος	Υποχρεωτικό;
action	create \| update \| confirm \| decline \| cancel	Υποχρεωτικό
appointmentId	string	Προαιρετικό
type	appointment \| reminder \| unavailable	Προαιρετικό
startAt	string	Προαιρετικό
endAt	string	Προαιρετικό
chairId	string	Προαιρετικό
patientId	string	Προαιρετικό
practitionerId	string	Προαιρετικό
title	string	Προαιρετικό
color	string	Προαιρετικό
serviceRef	string	Προαιρετικό
notes	string	Προαιρετικό

Παράδειγμα κλήσης

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "write_appointment",
    "arguments": {
      "action": "create"
    }
  }
}

Αποτέλεσμα

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "status": 200,
      "ok": true,
      "data": { "...": "the written record" }
    }
  }
}

Σφάλματα

Κωδικός	Κατάσταση	Πότε
validation_failed	400	Λείπει παράμετρος, έχει λάθος τύπο, ή είναι εκτός των επιτρεπτών τιμών.
not_found	404	Το id δεν υπάρχει στο ιατρείο σας. Ένα κακοσχηματισμένο id φαίνεται ίδιο.
unauthorized	401	Το bearer token λείπει, είναι άκυρο ή έχει λήξει.

Συχνές ερωτήσεις

Τα αρχεία ασθενών κρυπτογραφούνται κατά τη μεταφορά και την αποθήκευση, τα αρχεία φυλάσσονται ιδιωτικά και σερβίρονται μέσω συνδέσμων περιορισμένης διάρκειας, ενώ κάθε αλλαγή καταγράφεται. Το προσωπικό συνδέεται με passkeys αντί για κοινούς κωδικούς.

Ναι. Κάθε λίστα στο HyperCRM εξάγεται σε CSV μέσα από την εφαρμογή και τα αρχεία σας μπορούν να κατέβουν οποιαδήποτε στιγμή. Τα δεδομένα του ιατρείου σας ανήκουν σε εσάς, χωρίς χρέωση ή καθυστέρηση εξαγωγής — και στα δύο πακέτα, στη δοκιμή, αλλά και μετά την ακύρωση.

Το HyperCRM είναι λογισμικό επί πληρωμή. Κάθε ιατρείο ξεκινά με δωρεάν δοκιμή 30 ημερών στο πλήρες πακέτο Complete, χωρίς κάρτα. Στη συνέχεια τα πακέτα ξεκινούν από 19 € και 29 € τον μήνα χωρίς ΦΠΑ, σε κλιμάκια ανάλογα με το πόσους επαγγελματίες υγείας απασχολείτε. Κάθε τιμή δημοσιεύεται στη σελίδα τιμών, ποτέ σε τηλεφωνική πώληση.