Αναφορά MCP / Κατάλογοι
Εργαλεία καταλόγων
Έξι εργαλεία για έδρες θεραπείας, τον κατάλογο υπηρεσιών και τις ετικέτες ασθενών — τις λίστες από τις οποίες αντλούν τιμές ραντεβού, αποδείξεις, τιμολόγια και φάκελοι.
Πώς διαβάζεται
Κάθε εργαλείο παρακάτω παραθέτει τις παραμέτρους του ακριβώς όπως τις δηλώνει το σχήμα εισόδου — τον τύπο, αν είναι υποχρεωτική, και τις επιτρεπτές τιμές όπου τις ορίζει το σχήμα. Δεν υπάρχουν περιγραφές παραμέτρων: τα σχήματα φέρουν τύπους, όχι κείμενο.
Το practiceId δεν είναι ποτέ παράμετρος. Προέρχεται από το token σας, και οι διαδρομές εγγραφής το αφαιρούν αν το στείλει ο client.
Κάθε παράδειγμα είναι πλήρες αίτημα tools/call με συμπληρωμένες τις υποχρεωτικές παραμέτρους. Τα σφάλματα επιστρέφονται μέσα σε απόκριση 200 με isError — δείτε την επισκόπηση MCP και τον πλήρη κατάλογο.
Κατάλογοι
Έδρες, υπηρεσίες και ετικέτες — οι λίστες από τις οποίες επιλέγει το υπόλοιπο προϊόν.
list_chairs
Λίστα των εδρών θεραπείας (κρατήσιμοι πόροι).
Παράδειγμα κλήσης
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_chairs",
"arguments": {}
}
}Αποτέλεσμα
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"structuredContent": {
"status": 200,
"ok": true,
"data": { "...": "the requested records" }
}
}
}Σφάλματα
| Κωδικός | Κατάσταση | Πότε |
|---|---|---|
| unauthorized | 401 | Το bearer token λείπει, είναι άκυρο ή έχει λήξει. |
list_services
Λίστα του καταλόγου υπηρεσιών. Με isPublic=true μόνο όσες προσφέρονται στη δημόσια σελίδα κράτησης.
Παράμετροι
| Εργαλείο | Τύπος | Υποχρεωτικό; |
|---|---|---|
| isPublic | boolean | Προαιρετικό |
Παράδειγμα κλήσης
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_services",
"arguments": {}
}
}Αποτέλεσμα
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"structuredContent": {
"status": 200,
"ok": true,
"data": { "...": "the requested records" }
}
}
}Σφάλματα
| Κωδικός | Κατάσταση | Πότε |
|---|---|---|
| validation_failed | 400 | Λείπει παράμετρος, έχει λάθος τύπο, ή είναι εκτός των επιτρεπτών τιμών. |
| unauthorized | 401 | Το bearer token λείπει, είναι άκυρο ή έχει λήξει. |
list_tags
Λίστα όλων των ετικετών του ιατρείου.
Παράδειγμα κλήσης
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_tags",
"arguments": {}
}
}Αποτέλεσμα
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"structuredContent": {
"status": 200,
"ok": true,
"data": { "...": "the requested records" }
}
}
}Σφάλματα
| Κωδικός | Κατάσταση | Πότε |
|---|---|---|
| unauthorized | 401 | Το bearer token λείπει, είναι άκυρο ή έχει λήξει. |
write_chair
Δημιουργία, ενημέρωση ή διαγραφή έδρας. Τα update και delete απαιτούν chairId.
Παράμετροι
| Εργαλείο | Τύπος | Υποχρεωτικό; |
|---|---|---|
| action | create | update | delete | Υποχρεωτικό |
| chairId | string | Προαιρετικό |
| title | string | Προαιρετικό |
| doctorName | string | Προαιρετικό |
| color | string | Προαιρετικό |
| isPublic | boolean | Προαιρετικό |
| position | integer | Προαιρετικό |
Παράδειγμα κλήσης
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "write_chair",
"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 φαίνεται ίδιο. |
| forbidden | 403 | Ο καλών δεν είναι ιδιοκτήτης του ιατρείου. |
| unauthorized | 401 | Το bearer token λείπει, είναι άκυρο ή έχει λήξει. |
write_service
Δημιουργία, ενημέρωση ή διαγραφή υπηρεσίας, ή εγκατάσταση του προεπιλεγμένου καταλόγου του pack με action=seed_defaults. Τα update και delete απαιτούν serviceId.
Παράμετροι
| Εργαλείο | Τύπος | Υποχρεωτικό; |
|---|---|---|
| action | create | update | delete | seed_defaults | Υποχρεωτικό |
| serviceId | string | Προαιρετικό |
| name | string | Προαιρετικό |
| priceMinor | integer | Προαιρετικό |
| durationMinutes | integer | Προαιρετικό |
| isPublic | boolean | Προαιρετικό |
Παράδειγμα κλήσης
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "write_service",
"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 φαίνεται ίδιο. |
| forbidden | 403 | Ο καλών δεν είναι ιδιοκτήτης του ιατρείου. |
| unauthorized | 401 | Το bearer token λείπει, είναι άκυρο ή έχει λήξει. |
write_tag
Δημιουργία, ενημέρωση ή διαγραφή ετικέτας ασθενή. Τα update και delete απαιτούν tagId. Η διαγραφή την αφαιρεί από κάθε ασθενή που τη φέρει.
Παράμετροι
| Εργαλείο | Τύπος | Υποχρεωτικό; |
|---|---|---|
| action | create | update | delete | Υποχρεωτικό |
| tagId | string | Προαιρετικό |
| title | string | Προαιρετικό |
| color | string | Προαιρετικό |
Παράδειγμα κλήσης
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "write_tag",
"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 € τον μήνα χωρίς ΦΠΑ, σε κλιμάκια ανάλογα με το πόσους επαγγελματίες υγείας απασχολείτε. Κάθε τιμή δημοσιεύεται στη σελίδα τιμών, ποτέ σε τηλεφωνική πώληση.