Αναφορά MCP / Ιατρείο

Εργαλεία ιατρείου και προσωπικού

Εννέα εργαλεία για το προφίλ, τις ρυθμίσεις, τα μέλη, τις προσκλήσεις και τις αναφορές σφαλμάτων. Η δημιουργία πρόσκλησης στέλνει πραγματικό email, γι' αυτό σημειώνεται ως έξοδος προς τα έξω.

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

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

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

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

Ιατρείο και προσωπικό

Το προφίλ του ιατρείου, τα μέλη του και οι προσκλήσεις προσωπικού.

get_practice

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

Ανάγνωση του προφίλ και των ρυθμίσεων του ιατρείου.

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

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

Αποτέλεσμα

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

Σφάλματα

Κωδικός	Κατάσταση	Πότε
unauthorized	401	Το bearer token λείπει, είναι άκυρο ή έχει λήξει.

get_me

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

Ανάγνωση του χρήστη, του ιατρείου του, του ρόλου του και του vertical pack του ιατρείου.

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

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

Αποτέλεσμα

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

Σφάλματα

Κωδικός	Κατάσταση	Πότε
unauthorized	401	Το bearer token λείπει, είναι άκυρο ή έχει λήξει.

list_practice_members

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

Λίστα μελών προσωπικού και ρόλων.

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

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

Αποτέλεσμα

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

Σφάλματα

Κωδικός	Κατάσταση	Πότε
unauthorized	401	Το bearer token λείπει, είναι άκυρο ή έχει λήξει.

list_invitations

Μόνο ανάγνωσηΜόνο ιδιοκτήτης

Λίστα εκκρεμών προσκλήσεων προσωπικού.

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

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

Αποτέλεσμα

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

Σφάλματα

Κωδικός	Κατάσταση	Πότε
forbidden	403	Ο καλών δεν είναι ιδιοκτήτης του ιατρείου.
unauthorized	401	Το bearer token λείπει, είναι άκυρο ή έχει λήξει.

update_practice

ΓράφειΜόνο ιδιοκτήτης

Ενημέρωση του ιατρείου. Πεδία προφίλ και ρυθμίσεων μπορούν να συνδυαστούν σε μία κλήση· κάθε άγνωστο πεδίο απορρίπτεται.

Παράμετροι

Εργαλείο	Τύπος	Υποχρεωτικό;
name	string	Προαιρετικό
address	string	Προαιρετικό
phone	string	Προαιρετικό
addressStreet	string	Προαιρετικό
addressCity	string	Προαιρετικό
addressRegion	string	Προαιρετικό
addressPostcode	string	Προαιρετικό
email	string	Προαιρετικό
website	string	Προαιρετικό
country	string	Προαιρετικό
currency	string	Προαιρετικό
legalName	string	Προαιρετικό
taxId	string	Προαιρετικό
taxOffice	string	Προαιρετικό
packId	string	Προαιρετικό
workTimeStart	string	Προαιρετικό
workTimeEnd	string	Προαιρετικό
openingHours	array	Προαιρετικό
calendarSlotMinutes	integer	Προαιρετικό
reminderLeadMinutes	integer	Προαιρετικό
bookingRequestExpiryWorkingHours	number	Προαιρετικό
reminderChannels	object	Προαιρετικό
taxPercentage	number	Προαιρετικό
includeTaxInInvoices	boolean	Προαιρετικό
taxExemptionNote	string	Προαιρετικό
timezone	string	Προαιρετικό
mfaRequired	boolean	Προαιρετικό

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

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

Αποτέλεσμα

{
  "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 λείπει, είναι άκυρο ή έχει λήξει.

update_me

ΓράφειΚάθε μέλος

Ενημέρωση των δικών σας προτιμήσεων. Ρυθμίζεται μόνο η γλώσσα διεπαφής.

Παράμετροι

Εργαλείο	Τύπος	Υποχρεωτικό;
locale	en \| el	Υποχρεωτικό

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_me",
    "arguments": {
      "locale": "en"
    }
  }
}

Αποτέλεσμα

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

Σφάλματα

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

report_bug

ΓράφειΚάθε μέλος

Αναφορά σφάλματος στο ίδιο το HyperCRM. Η αναφορά αποθηκεύεται και στέλνεται με email στην ομάδα του HyperCRM, μαζί με το ποιος τη στέλνει. Έως 5 ανά χρήστη την ώρα. Μη γράφετε στοιχεία ασθενών.

Παράμετροι

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

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "report_bug",
    "arguments": {
      "description": "..."
    }
  }
}

Αποτέλεσμα

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

Σφάλματα

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

write_practice_member

ΓράφειΜόνο ιδιοκτήτης

action=update_role θέτει ρόλο owner ή assistant· action=remove αφαιρεί το μέλος. Και τα δύο απορρίπτονται αν θα άφηναν το ιατρείο χωρίς ιδιοκτήτη.

Παράμετροι

Εργαλείο	Τύπος	Υποχρεωτικό;
action	update_role \| remove	Υποχρεωτικό
membershipId	string	Υποχρεωτικό
role	owner \| assistant	Προαιρετικό

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "write_practice_member",
    "arguments": {
      "action": "update_role",
      "membershipId": "0f1c7a2e-...."
    }
  }
}

Αποτέλεσμα

{
  "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_invitation

ΓράφειΜπορεί να διαγράψειΒγαίνει προς τα έξωΜόνο ιδιοκτήτης

action=create ΣΤΕΛΝΕΙ ΠΡΑΓΜΑΤΙΚΟ EMAIL με σύνδεσμο μίας χρήσης που λήγει σε 3 ημέρες· action=revoke διαγράφει εκκρεμή πρόσκληση.

Παράμετροι

Εργαλείο	Τύπος	Υποχρεωτικό;
action	create \| revoke	Υποχρεωτικό
invitationId	string	Προαιρετικό
email	string	Προαιρετικό
role	owner \| assistant	Προαιρετικό

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "write_invitation",
    "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 λείπει, είναι άκυρο ή έχει λήξει.

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

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

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

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