Τεκμηρίωση / MCP
Και τα 75 εργαλεία
Ομαδοποιημένα ανά τομέα. Οι παράμετροι με έντονη γραφή είναι υποχρεωτικές. Κάθε εργαλείο σημειώνεται με το τι μπορεί να κάνει — ανάγνωση, εγγραφή, διαγραφή ή έξοδο προς τα έξω — και με τον ρόλο που απαιτείται.
Μία ανάγνωση, ένα εργαλείο· οι εγγραφές ομαδοποιούνται
Κάθε ανάγνωση είναι δικό της εργαλείο, ώστε η επιλογή να είναι προφανής για ένα μοντέλο. Η δημιουργία, ενημέρωση και διαγραφή ενός πόρου συμπτύσσονται σε ένα εργαλείο write_* με υποχρεωτική παράμετρο action — έτσι η λίστα εργαλείων μένει διαχειρίσιμη και κάθε εγγραφή αρκετά ευρεία για να φέρει ουσιαστική προειδοποίηση διαγραφής.
Πώς διαβάζεται
47 από τα 75 εργαλεία είναι μόνο ανάγνωσης και μπορούν να κληθούν ελεύθερα. 20 μπορούν να διαγράψουν ή να ακυρώσουν δεδομένα. Πέντε βγαίνουν έξω από το HyperCRM και αξίζουν επιβεβαίωση σε κάθε client: η αποστολή πρόσκλησης με email, η δημοσίευση της ιστοσελίδας στο διαδίκτυο, και η δημιουργία δημόσιου συνδέσμου φόρμας.
Το practiceId δεν είναι ποτέ παράμετρος — προέρχεται από το token. Όπου ένα εργαλείο δέχεται action, η ενέργεια καθορίζει ποιες άλλες παράμετροι είναι υποχρεωτικές· η περιγραφή το λέει.
Ασθενείς
Ο φάκελος του ασθενή, οι σημειώσεις του, οι θεραπείες του και οι υποπόροι που κρέμονται από αυτόν.
| Εργαλείο | Παράμετροι | Πρόσβαση | Τι κάνει |
|---|---|---|---|
| list_patients | searchqstatustagIdincludeInactivelimitoffset | Μόνο ανάγνωσηΚάθε μέλος | Λίστα ασθενών του ιατρείου, με προαιρετική αναζήτηση και φίλτρα κατάστασης και ετικέτας. |
| get_patient | patientId | Μόνο ανάγνωσηΚάθε μέλος | Ανάγνωση ενός ασθενή με βάση το id. |
| list_patient_notes | patientId | Μόνο ανάγνωσηΚάθε μέλος | Λίστα όλων των κλινικών σημειώσεων ενός ασθενή. |
| list_patient_files | patientId | Μόνο ανάγνωσηΚάθε μέλος | Λίστα αρχείων ασθενή. Χρησιμοποιήστε το get_file για σύνδεσμο λήψης. |
| list_patient_billing_entries | patientIdincludeVoidedlimit | Μόνο ανάγνωσηΚάθε μέλος | Λίστα των χρεώσεων που έχουν καταγραφεί για έναν ασθενή, μαζί με το υπόλοιπο: τι οφείλει τώρα, το ίδιο ποσό με το καθολικό στη σελίδα του ασθενή. Χρησιμοποιήστε αυτό αντί να αθροίζετε εγγραφές. Μια εγγραφή receipt είναι είσπραξη, όχι παραστατικό. |
| list_patient_invoices | patientIdincludeVoided | Μόνο ανάγνωσηΚάθε μέλος | Λίστα των αποδείξεων και τιμολογίων που έχουν εκδοθεί για έναν ασθενή. |
| get_patient_invoice_preview | patientId | Μόνο ανάγνωσηΚάθε μέλος | Υπολογισμός προσχεδίου απόδειξης ή τιμολογίου για τις μη χρεωμένες εγγραφές, χωρίς έκδοση. Για έκδοση χρησιμοποιήστε write_invoice με action=issue. |
| write_patient | actionpatientIdfirstNamelastNamedobgenderemailphoneMobileaddresspostcodecountrysocialSecurityNumbertaxIdtaxOfficestatusnotifyByEmailnotifyBySmsfileUseConsentdifferentPerson | ΓράφειΜπορεί να διαγράψειΚάθε μέλος | Δημιουργία, ενημέρωση ή διαγραφή ασθενή. action=create απαιτεί firstName και lastName· update και delete απαιτούν patientId. Η διαγραφή είναι μόνιμη. Μια δημιουργία με όνομα που υπάρχει ήδη στο ιατρείο απορρίπτεται με patient_exists. Με differentPerson: true η καταχώριση γίνεται, αφού το ιατρείο πει ότι είναι άλλο πρόσωπο. Ο server δεν μπορεί να ελέγξει ότι το είπε, και το ιστορικό ενεργειών το καταγράφει. |
| write_patient_note | actionpatientIdnoteIdtitlebody | ΓράφειΜπορεί να διαγράψειΚάθε μέλος | Δημιουργία, ενημέρωση ή διαγραφή σημείωσης ασθενή. action=create απαιτεί body· update και delete απαιτούν noteId. |
| toggle_patient_tag | patientIdtagId | ΓράφειΚάθε μέλος | Προσθέτει την ετικέτα αν λείπει, την αφαιρεί αν υπάρχει ήδη. |
| list_treatment_courses | patientId | Μόνο ανάγνωσηΚάθε μέλος | Οι θεραπείες ενός ασθενή, πρώτα όσες είναι ανοιχτές: κατάσταση, ημερομηνίες και διάρκεια, διάγνωση και σχέδιο, οι τύποι διάγνωσης και θεραπείας τους, το επόμενο βήμα και οι επισκέψεις. |
| list_treatment_picklists | kindincludeArchived | Μόνο ανάγνωσηΚάθε μέλος | Οι τύποι διάγνωσης και οι τύποι θεραπείας του ιατρείου, οι λέξεις με τις οποίες χαρακτηρίζεται μια θεραπεία. Τα αρχειοθετημένα μόνο αν ζητηθούν. |
| write_treatment_course | actionpatientIdcourseIdtitlestatusdiagnosisplandiagnosisTypeIdstreatmentTypeIdsstartDateplannedEndDatenextStepDatenextStepNoteexpectedUpdatedAtreason | ΓράφειΜπορεί να διαγράψειΚάθε μέλος | Έναρξη, αλλαγή ή αφαίρεση μιας θεραπείας. Το action=create απαιτεί title· τα update και void απαιτούν courseId και expectedUpdatedAt. Μια θεραπεία που αφαιρείται κρατά τη γραμμή και τις επισκέψεις της, εκτός λίστας. |
| write_treatment_visit | actionpatientIdcourseIdvisitIdvisitDatebodyappointmentIdexpectedUpdatedAtreason | ΓράφειΜπορεί να διαγράψειΚάθε μέλος | Καταγραφή, αλλαγή ή αφαίρεση μιας επίσκεψης σε θεραπεία. Το action=create απαιτεί body και μπορεί να συνδέσει το ραντεβού του ασθενή από το οποίο καταγράφηκε· τα update και void απαιτούν visitId και expectedUpdatedAt. |
Ραντεβού
Κρατήσεις, δεσμεύσεις έδρας και υπολογισμένη διαθεσιμότητα.
| Εργαλείο | Παράμετροι | Πρόσβαση | Τι κάνει |
|---|---|---|---|
| get_day_agenda | datetopractitionerchairpatientservicetimelocationId | Μόνο ανάγνωσηΚάθε μέλος | Το πρόγραμμα μιας ημέρας ή έως 7 ημερών, με ονόματα: τα ενεργά ραντεβού με ασθενή, υπηρεσία, έδρα και θεραπευτή, τα κλειστά διαστήματα χωριστά, μετρήσεις, και αν το ιατρείο είναι κλειστό. |
| find_booking_slots | datetimepartOfDaydayspatientservicepractitionerchairlocationId | Μόνο ανάγνωσηΚάθε μέλος | Πότε χωράει ένα ραντεβού, με ονόματα: απάντηση για την ώρα που ζητήθηκε, ελεύθερες ώρες σε όλη τη μέρα με τις έδρες τους και έτοιμο σχέδιο κράτησης, και τα ραντεβού του ασθενή εκείνη τη μέρα. Ένα όνομα που ταιριάζει σε πολλούς επιστρέφει τους υποψηφίους, ποτέ μια εικασία. |
| list_appointments | fromtochairIdpractitionerIdpatientId | Μόνο ανάγνωσηΚάθε μέλος | Λίστα ραντεβού σε χρονικό παράθυρο. Δώστε chairId για περιορισμό σε μία έδρα. |
| get_appointment | appointmentId | Μόνο ανάγνωσηΚάθε μέλος | Ανάγνωση ενός ραντεβού με βάση το id. |
| get_appointment_availability | datetimepartOfDaychairIdpractitionerIdserviceIddurationMinutes | Μόνο ανάγνωσηΚάθε μέλος | Ελεύθερες ώρες μίας ημέρας σε όλες τις έδρες, ή σε μία έδρα ή για ένα άτομο, με βάση το ωράριο, τη ζώνη ώρας και τις υπάρχουσες κρατήσεις. Οι ώρες που πέρασαν δεν εμφανίζονται, και για μία ζητούμενη ώρα η απάντηση λέει αν είναι ελεύθερη. |
| write_appointment | actionappointmentIdexpectedDatetypedatestartTimeendTimestartAtendAtchairIdpatientIdpractitionerIdtitlecolorserviceRefnoteslocationId | ΓράφειΜπορεί να διαγράψειΚάθε μέλος | Δημιουργία, ενημέρωση ή ακύρωση ραντεβού. action=create απαιτεί chairId, startAt και endAt· update και cancel απαιτούν appointmentId. Το type είναι appointment, reminder ή unavailable· ο κλειστός χρόνος χωρίς έδρα και χωρίς επαγγελματία μπορεί να ορίσει locationId, ώστε να κλείνει μόνο εκείνη την τοποθεσία. Οι επικαλύψεις στην ίδια έδρα απορρίπτονται. |
Χρεώσεις, αποδείξεις και τιμολόγια
Το καθολικό των χρεώσεων και τα παραστατικά (αποδείξεις και τιμολόγια) που εκδίδονται από αυτό.
| Εργαλείο | Παράμετροι | Πρόσβαση | Τι κάνει |
|---|---|---|---|
| get_outstanding_balances | olderThanDays | Μόνο ανάγνωσηΚάθε μέλος | Κάθε ασθενής που χρωστά στο ιατρείο, με την ημερομηνία της παλαιότερης ανεξόφλητης χρέωσης και πόσων ημερών είναι. Δώστε olderThanDays για να απαντήσετε «ποιοι χρωστούν πάνω από 30 ημέρες». Οι εισπράξεις πιστώνονται πρώτα στις παλαιότερες χρεώσεις, οπότε η ηλικία είναι το ποσό που πράγματι οφείλεται ακόμη. |
| list_billing_entries | fromtoincludeVoidedlimit | Μόνο ανάγνωσηΜόνο ιδιοκτήτης | Λίστα χρεώσεων για όλο το ιατρείο, προαιρετικά σε εύρος ημερομηνιών (ημέρες του ιατρείου, μαζί με την πρώτη και την τελευταία). Για έναν ασθενή, και για το τι οφείλει, χρησιμοποιήστε list_patient_billing_entries. |
| get_billing_entry | entryId | Μόνο ανάγνωσηΚάθε μέλος | Ανάγνωση μιας χρέωσης με βάση το id. |
| get_invoice | invoiceId | Μόνο ανάγνωσηΚάθε μέλος | Ανάγνωση εκδοθέντος παραστατικού (απόδειξης ή τιμολογίου) και των παγιωμένων γραμμών του. Για το προσχέδιο, get_patient_invoice_preview. |
| get_appointment_charge | appointmentId | Μόνο ανάγνωσηΚάθε μέλος | Τι χρειάζεται για να χρεωθεί ένα ραντεβού: αν μπορεί να χρεωθεί, και η υπηρεσία του καταλόγου που του αντιστοιχεί, με το id και την τιμή της. Χρησιμοποιήστε το πριν χρεώσετε ραντεβού με write_billing_entry. |
| write_billing_entry | actionentryIdpatientIdtypeamountMinorserviceIdappointmentIdserviceDatenotespaymentMethodreason | ΓράφειΜπορεί να διαγράψειΚάθε μέλος | Δημιουργία, ενημέρωση ή ακύρωση χρέωσης. action=create απαιτεί patientId· update και void απαιτούν entryId. Η ακύρωση είναι αντιστροφή, όχι διαγραφή — η εγγραφή μένει στο καθολικό σημειωμένη ως άκυρη. Μια εγγραφή receipt καταγράφει είσπραξη και παίρνει αριθμό είσπραξης (HCRM-0001)· δεν είναι παραστατικό. Αποδείξεις και τιμολόγια εκδίδονται με write_invoice. |
| write_invoice | actionpatientIdkindentryIdsinvoiceIdreason | ΓράφειΜπορεί να διαγράψειΚάθε μέλος | Έκδοση παραστατικού για τις μη χρεωμένες εγγραφές ασθενή (action=issue, απαιτεί patientId) ή ακύρωση εκδοθέντος (action=void, απαιτεί invoiceId). Εκδίδει απόδειξη, εκτός αν δοθεί kind=invoice, που απαιτεί ΑΦΜ στον φάκελο του ασθενή. Η έκδοση παγιώνει τις τρέχουσες γραμμές. |
| send_invoice | invoiceIdlocale | ΓράφειΒγαίνει προς τα έξωΚάθε μέλος | Στέλνει ΠΡΑΓΜΑΤΙΚΟ EMAIL: ένα εκδοθέν παραστατικό, συνημμένο ως PDF, στο email του ασθενή που υπάρχει στο αρχείο και πουθενά αλλού. Προαιρετικά locale en ή el. Απορρίπτεται για ακυρωμένο παραστατικό, για ασθενή χωρίς email, και μετά από 3 αποστολές του ίδιου παραστατικού μέσα σε μία ώρα. |
Φόρμες
Φόρμες εισαγωγής και συγκατάθεσης. Η ανάγνωση μιας φόρμας, η ανάγνωση των απαντήσεων και η αποστολή μιας φόρμας σε ασθενή είναι ανοιχτές σε κάθε μέλος του ιατρείου. Η δημιουργία φόρμας θέλει ρόλο ιδιοκτήτη.
| Εργαλείο | Παράμετροι | Πρόσβαση | Τι κάνει |
|---|---|---|---|
| list_forms | Καμία | Μόνο ανάγνωσηΚάθε μέλος | Λίστα των φορμών εισαγωγής και συγκατάθεσης του ιατρείου. |
| get_form | formId | Μόνο ανάγνωσηΚάθε μέλος | Ανάγνωση μιας φόρμας με τα πεδία της. |
| list_form_submissions | formIdstatuspagepageSize | Μόνο ανάγνωσηΚάθε μέλος | Μία σελίδα υποβολών μιας φόρμας, νεότερες πρώτα, με το σύνολο όλων των σελίδων. |
| get_form_submission | formIdsubmissionId | Μόνο ανάγνωσηΚάθε μέλος | Ανάγνωση μιας υποβολής και των απαντήσεών της. |
| write_form | actionformIdpatientIdsendnamedescriptionisActivefields | ΓράφειΜπορεί να διαγράψειΒγαίνει προς τα έξωΚάθε μέλος | Το action=create_link είναι ανοιχτό σε κάθε μέλος· κάθε άλλο action θέλει ρόλο ιδιοκτήτη. Το create_link εκδίδει ΔΗΜΟΣΙΟ σύνδεσμο μίας χρήσης που λήγει σε 3 ημέρες (προαιρετικά δεσμευμένο σε ασθενή, του οποίου τον φάκελο οι απαντήσεις τότε ενημερώνουν: ποτέ το όνομα, και email ή κινητό μόνο όπου το ιατρείο δεν έχει καταχωρημένο) και με send=email|sms τον στέλνει στον ασθενή· create φτιάχνει φόρμα· update επεξεργάζεται μεταδεδομένα· delete τη διαγράφει· replace_fields αντικαθιστά όλη τη λίστα πεδίων· seed_defaults εγκαθιστά τα πρότυπα του pack. |
Αρχεία
Το ανέβασμα γίνεται από τον browser στην αποθήκευση και δεν έχει εργαλείο· αυτά διαβάζουν και αφαιρούν ό,τι έχει αποθηκευτεί.
| Εργαλείο | Παράμετροι | Πρόσβαση | Τι κάνει |
|---|---|---|---|
| get_file | fileId | Μόνο ανάγνωσηΚάθε μέλος | Ανάγνωση μεταδεδομένων αρχείου με υπογεγραμμένο σύνδεσμο λήψης που ισχύει πέντε λεπτά. Για ids, list_patient_files. Η χρήση αρχείων ασθενή για οτιδήποτε άλλο εκτός από τη δική του φροντίδα απαιτεί τη συγκατάθεσή του. |
| delete_file | fileId | ΓράφειΜπορεί να διαγράψειΚάθε μέλος | Μόνιμη διαγραφή αρχείου. Μια εικόνα του ιστότοπου είναι επίσης αρχείο, και η διαγραφή της τη βγάζει από τον δημοσιευμένο ιστότοπο· αυτές και τα κανονιστικά έγγραφα τα διαγράφει μόνο ο ιδιοκτήτης. |
Αναφορές και αναζήτηση
Συγκεντρωτικά και αναζήτηση σε πολλές οντότητες. Οι τρεις αναφορές και το ιστορικό ελέγχου απαιτούν ιδιοκτήτη.
| Εργαλείο | Παράμετροι | Πρόσβαση | Τι κάνει |
|---|---|---|---|
| get_dashboard_kpis | Καμία | Μόνο ανάγνωσηΚάθε μέλος | Βασικοί δείκτες — σημερινά ραντεβού, ανεξόφλητα υπόλοιπα, πρόσφατη δραστηριότητα. |
| get_appointments_report | fromtogroupBy | Μόνο ανάγνωσηΜόνο ιδιοκτήτης | Πλήθος ραντεβού ανά διάστημα. Το groupBy είναι day, week ή month. |
| get_revenue_report | fromtogroupBy | Μόνο ανάγνωσηΜόνο ιδιοκτήτης | Σύνολα εσόδων ανά διάστημα. Το groupBy είναι day, week ή month. |
| get_patient_acquisition_report | fromtogroupBy | Μόνο ανάγνωσηΜόνο ιδιοκτήτης | Πλήθος νέων ασθενών ανά διάστημα. Το groupBy είναι day, week ή month. |
| list_audit_log | typefromtolimitoffset | Μόνο ανάγνωσηΜόνο ιδιοκτήτης | Ανάγνωση του ιστορικού ελέγχου, νεότερα πρώτα. Φίλτρα τύπου οντότητας και εύρους ημερομηνιών. |
| search | qlimit | Μόνο ανάγνωσηΚάθε μέλος | Αναζήτηση σε πολλές οντότητες του ιατρείου — ασθενείς, ραντεβού και άλλα. |
Ειδοποιήσεις
Τα εισερχόμενα του ίδιου του χρήστη. Όχι για όλο το ιατρείο.
| Εργαλείο | Παράμετροι | Πρόσβαση | Τι κάνει |
|---|---|---|---|
| list_notifications | unreadOnlylimitoffset | Μόνο ανάγνωσηΚάθε μέλος | Λίστα των ειδοποιήσεών σας, νεότερες πρώτα, με το πλήθος μη διαβασμένων. Με unreadOnly=true παραλείπονται οι διαβασμένες. |
| mark_notifications_read | actionnotificationId | ΓράφειΚάθε μέλος | Σήμανση μιας ειδοποίησης ως διαβασμένης (action=one, απαιτεί notificationId) ή όλων (action=all). |
Ιατρείο και προσωπικό
Το προφίλ του ιατρείου, τα μέλη του και οι προσκλήσεις προσωπικού.
| Εργαλείο | Παράμετροι | Πρόσβαση | Τι κάνει |
|---|---|---|---|
| get_practice | Καμία | Μόνο ανάγνωσηΚάθε μέλος | Ανάγνωση του προφίλ και των ρυθμίσεων του ιατρείου. |
| get_me | Καμία | Μόνο ανάγνωσηΚάθε μέλος | Ανάγνωση του χρήστη, του ιατρείου του, του ρόλου του και του vertical pack του ιατρείου. |
| list_practice_members | Καμία | Μόνο ανάγνωσηΚάθε μέλος | Λίστα μελών προσωπικού και ρόλων. |
| list_invitations | Καμία | Μόνο ανάγνωσηΜόνο ιδιοκτήτης | Λίστα εκκρεμών προσκλήσεων προσωπικού. |
| update_practice | nameaddressphoneaddressStreetaddressCityaddressRegionaddressPostcodeemailwebsitecountrycurrencylegalNametaxIdtaxOfficepackIdworkTimeStartworkTimeEndopeningHourscalendarSlotMinutesreminderLeadMinutesbookingRequestExpiryWorkingHoursreminderChannelstaxPercentageincludeTaxInInvoicestaxExemptionNotetimezonemfaRequired | ΓράφειΜόνο ιδιοκτήτης | Ενημέρωση του ιατρείου. Πεδία προφίλ και ρυθμίσεων μπορούν να συνδυαστούν σε μία κλήση· κάθε άγνωστο πεδίο απορρίπτεται. |
| update_me | locale | ΓράφειΚάθε μέλος | Ενημέρωση των δικών σας προτιμήσεων. Ρυθμίζεται μόνο η γλώσσα διεπαφής. |
| report_bug | descriptionexpectedpagePath | ΓράφειΚάθε μέλος | Αναφορά σφάλματος στο ίδιο το HyperCRM. Η αναφορά αποθηκεύεται και στέλνεται με email στην ομάδα του HyperCRM, μαζί με το ποιος τη στέλνει. Έως 5 ανά χρήστη την ώρα. Μη γράφετε στοιχεία ασθενών. |
| write_practice_member | actionmembershipIdrolepublicDisplayNamepublicTitlecredentialsbiospecialtiespublicProfileEnabled | ΓράφειΜόνο ιδιοκτήτης | action=update_role θέτει ρόλο ιδιοκτήτη (`owner`) ή προσωπικού (`assistant`)· action=remove αφαιρεί το μέλος. Και τα δύο απορρίπτονται αν θα άφηναν το ιατρείο χωρίς ιδιοκτήτη. |
| write_invitation | actioninvitationIdemailrole | ΓράφειΜπορεί να διαγράψειΒγαίνει προς τα έξωΜόνο ιδιοκτήτης | action=create ΣΤΕΛΝΕΙ ΠΡΑΓΜΑΤΙΚΟ EMAIL με σύνδεσμο μίας χρήσης που λήγει σε 3 ημέρες· action=revoke διαγράφει εκκρεμή πρόσκληση. |
Κατασκευαστής ιστοσελίδας
Η δημόσια ιστοσελίδα του ιατρείου. Οι εγγραφές αφορούν προσχέδιο μέχρι τη δημοσίευση· η δημοσίευση είναι το μόνο εργαλείο εδώ που αλλάζει ό,τι βλέπει το κοινό.
| Εργαλείο | Παράμετροι | Πρόσβαση | Τι κάνει |
|---|---|---|---|
| get_site | Καμία | Μόνο ανάγνωσηΚάθε μέλος | Ανάγνωση της ιστοσελίδας με σελίδες, modules και FAQ. Επιστρέφει null αν δεν έχει δημιουργηθεί. |
| list_site_page_modules | pageIdpage | Μόνο ανάγνωσηΚάθε μέλος | Ανάγνωση των modules και FAQ μιας σελίδας. |
| check_site_slug_available | slug | Μόνο ανάγνωσηΜόνο ιδιοκτήτης | Έλεγχος αν ένα slug είναι έγκυρο και ελεύθερο. Επιστρέφει διαθεσιμότητα και αιτία όταν δεν είναι. |
| write_site | actionsluglocaletemplateIdbrandColorfontPairinglogoFileIdheroFileIdmetaTitlemetaDescriptionshowServicePrices | ΓράφειΜπορεί να διαγράψειΒγαίνει προς τα έξωΜόνο ιδιοκτήτης | action=create δημιουργεί την ιστοσελίδα· update αλλάζει ρυθμίσεις· publish ΔΗΜΟΣΙΕΥΕΙ ΤΟ ΤΡΕΧΟΝ ΠΡΟΣΧΕΔΙΟ στο διαδίκτυο, ορατό αμέσως σε οποιονδήποτε. |
| update_site_page | pageIdenablednavLabelnavOrdermetaTitlemetaDescription | ΓράφειΜόνο ιδιοκτήτης | Επεξεργασία μεταδεδομένων μιας σελίδας — τίτλος, slug, SEO. |
| write_site_module | actionpageIdmoduleIdtypepositionenabledcontent | ΓράφειΜπορεί να διαγράψειΜόνο ιδιοκτήτης | action=create προσθέτει module σε σελίδα (απαιτεί pageId)· update και delete απαιτούν moduleId. Οι αλλαγές αφορούν το προσχέδιο μέχρι τη δημοσίευση. Στο update, το `content` αντικαθιστά ολόκληρο το περιεχόμενο του module και δεν το συγχωνεύει: διαβάστε το πρώτα και στείλτε το πλήρες. |
| write_site_faq | actionpageIdfaqIdquestionanswerposition | ΓράφειΜπορεί να διαγράψειΜόνο ιδιοκτήτης | action=create προσθέτει FAQ σε σελίδα (απαιτεί pageId)· update και delete απαιτούν faqId. |
| list_blog_posts | Καμία | Μόνο ανάγνωσηΚάθε μέλος | Εμφανίζει τα άρθρα του ιστολογίου — πρόχειρα και δημοσιευμένα — με τη διεύθυνση, την κατάστασή τους και το κείμενό τους. |
| list_blog_categories | Καμία | Μόνο ανάγνωσηΚάθε μέλος | Εμφανίζει τις κατηγορίες στις οποίες μπορεί να καταχωρηθεί ένα άρθρο. Καλέστε το πριν γράψετε άρθρο αν θέλετε να ορίσετε κατηγορία: το id πρέπει να ανήκει σε αυτόν τον ιστότοπο. |
| write_blog_post | actionpostIdtitleslugexcerptbodycategoryIdauthorMembershipIdstatusmetaTitlemetaDescription | ΓράφειΜπορεί να διαγράψειΜόνο ιδιοκτήτης | Δημιουργεί, επεξεργάζεται ή διαγράφει άρθρο. Το create χρειάζεται τίτλο, διεύθυνση και κείμενο· τα update και delete χρειάζονται postId. Το άρθρο δημιουργείται ως ΠΡΟΧΕΙΡΟ. Το blog είναι η μία εξαίρεση στη δημοσίευση: σε ιστότοπο που έχει ήδη δημοσιευτεί, μόλις ένα άρθρο γίνει δημοσιευμένο βγαίνει αμέσως μπροστά στους ασθενείς, και η διαγραφή ενός δημοσιευμένου άρθρου το κατεβάζει αμέσως. Ένα ιατρείο μπορεί επίσης να έχει εβδομαδιαίο πρόγραμμα που γράφει άρθρα μόνο του, οπότε μπορεί να εμφανιστούν άρθρα που δεν δημιουργήσατε εσείς. |
Κατάλογοι
Έδρες, τοποθεσίες, υπηρεσίες και ετικέτες — οι λίστες από τις οποίες επιλέγει το υπόλοιπο προϊόν.
| Εργαλείο | Παράμετροι | Πρόσβαση | Τι κάνει |
|---|---|---|---|
| list_chairs | Καμία | Μόνο ανάγνωσηΚάθε μέλος | Λίστα των εδρών θεραπείας (κρατήσιμοι πόροι). |
| list_locations | Καμία | Μόνο ανάγνωσηΚάθε μέλος | Λίστα των τοποθεσιών του ιατρείου με όνομα και διεύθυνση, και αν ισχύουν οι τοποθεσίες. |
| list_services | visibility | Μόνο ανάγνωσηΚάθε μέλος | Λίστα του καταλόγου υπηρεσιών. Με isPublic=true μόνο όσες προσφέρονται στη δημόσια σελίδα κράτησης. |
| list_tags | Καμία | Μόνο ανάγνωσηΚάθε μέλος | Λίστα όλων των ετικετών του ιατρείου. |
| write_chair | actionchairIdtitledoctorNamecolorisPublicposition | ΓράφειΜπορεί να διαγράψειΜόνο ιδιοκτήτης | Δημιουργία, ενημέρωση ή διαγραφή έδρας. Τα update και delete απαιτούν chairId. Η διαγραφή δεν ακυρώνει κανένα ραντεβού: οι κρατήσεις κρατούν την ώρα και τον ασθενή τους και μένουν χωρίς έδρα. |
| write_service | actionserviceIdnamepriceMinordurationMinutesisPublic | ΓράφειΜπορεί να διαγράψειΜόνο ιδιοκτήτης | Δημιουργία, ενημέρωση ή διαγραφή υπηρεσίας, ή εγκατάσταση του προεπιλεγμένου καταλόγου του pack με action=seed_defaults. Τα update και delete απαιτούν serviceId. |
| write_tag | actiontagIdtitlecolor | ΓράφειΜπορεί να διαγράψειΚάθε μέλος | Δημιουργία, ενημέρωση ή διαγραφή ετικέτας ασθενή. Τα update και delete απαιτούν tagId. Η διαγραφή την αφαιρεί από κάθε ασθενή που τη φέρει. |
Οδοντόγραμμα
Το οδοντόγραμμα και οι περιοδοντικές εξετάσεις. Τα εργαλεία αυτά υπάρχουν μόνο για ιατρείο που έχει ρυθμιστεί ως οδοντιατρείο: κανένα άλλο ιατρείο δεν τα βλέπει, και μια κλήση με το όνομά τους απορρίπτεται.
| Εργαλείο | Παράμετροι | Πρόσβαση | Τι κάνει |
|---|---|---|---|
| get_dental_chart | patientIdincludeVoided | Μόνο ανάγνωσηΚάθε μέλος | Ανάγνωση του οδοντογράμματος ενός ασθενή: ποια δόντια λείπουν, έχουν εμφύτευμα ή θεραπεία, οι καταχωρίσεις που ισχύουν (και οι αφαιρεμένες, αν ζητηθούν), η σημείωση του οδοντογράμματος και οι σημειώσεις δοντιών. |
| write_dental_chart_entry | actionpatientIdentryIdteethkindbridgestatussurfacesmaterialrecordedOnexpectedUpdatedAtreasongroup | ΓράφειΜπορεί να διαγράψειΚάθε μέλος | Καταχώριση ευρήματος ή θεραπείας σε ένα ή περισσότερα δόντια, σήμανση μιας προγραμματισμένης ως ολοκληρωμένης, ή αφαίρεση. Μια αφαιρεμένη καταχώριση μένει στο ιστορικό του δοντιού. Μια καταχώριση δεν επεξεργάζεται: για διόρθωση, την αφαιρείτε και την καταχωρίζετε ξανά. |
| write_dental_chart_note | actionpatientIddentitionprimaryTeethchartNotetoothbodyexpectedUpdatedAt | ΓράφειΜπορεί να διαγράψειΚάθε μέλος | Ορισμός οδοντοφυΐας και σημείωσης του οδοντογράμματος, ή εγγραφή και διαγραφή της σημείωσης ενός δοντιού. |
| list_perio_exams | patientId | Μόνο ανάγνωσηΚάθε μέλος | Λίστα των περιοδοντικών εξετάσεων ενός ασθενή, με τη νεότερη πρώτη, χωρίς τις μετρήσεις. |
| get_perio_exam | patientIdexamId | Μόνο ανάγνωσηΚάθε μέλος | Ανάγνωση μιας περιοδοντικής εξέτασης: έξι σημεία μέτρησης ανά δόντι, αιμορραγία, κινητικότητα και διχασμός ριζών. |
| write_perio_exam | actionpatientIdexamIdexamDatecopyFromExamIdmeasurementsexpectedUpdatedAtreason | ΓράφειΜπορεί να διαγράψειΚάθε μέλος | Έναρξη περιοδοντικής εξέτασης, αλλαγή των μετρήσεών της (αλλάζει μόνο ό,τι στέλνετε), ή αφαίρεση. |
Συχνές ερωτήσεις
Οι καρτέλες ασθενών κρυπτογραφούνται, και εκεί που φυλάσσονται και καθώς έρχονται στην οθόνη σας. Τα αρχεία είναι ιδιωτικά, και ο σύνδεσμος προς ένα αρχείο σταματά να δουλεύει μετά από λίγο. Οι αλλαγές στις καρτέλες των ασθενών καταγράφονται, με το ποιος τις έκανε και πότε. Δεν υπάρχει κοινός κωδικός ιατρείου: ο καθένας έχει τον δικό του λογαριασμό. Στο πακέτο Complete, ο ιδιοκτήτης του ιατρείου μπορεί επίσης να απαιτεί σύνδεση σε δύο βήματα για όλη την ομάδα.
Υπάρχουν μόνο για ιατρείο που έχει ρυθμιστεί ως οδοντιατρείο. Κανένα άλλο ιατρείο δεν τα βλέπει, ούτε στον δικό του βοηθό ούτε μέσω MCP, και μια κλήση με το όνομά τους απορρίπτεται. Τα πλήθη εργαλείων σε αυτές τις σελίδες τα περιλαμβάνουν.
Ώστε η λίστα εργαλείων να μένει αρκετά μικρή για να τη διαχειριστεί ένα μοντέλο, και κάθε εργαλείο εγγραφής αρκετά ευρύ για να φέρει ουσιαστική προειδοποίηση. Ένας client βλέπει ότι το write_patient μπορεί να διαγράψει και ρωτά· δώδεκα στενά εργαλεία θα απαιτούσαν το καθένα τη δική του σήμανση και θα έπνιγαν τις αναγνώσεις.
Τα τρία που σημειώνονται ως έξοδος προς τα έξω — η πρόσκληση στέλνει πραγματικό email, η δημοσίευση κάνει την ιστοσελίδα αμέσως δημόσια, και ο σύνδεσμος φόρμας εκδίδει URL που ανοίγει όποιος τον έχει. Αξίζει επιβεβαίωση και για τα δεκαπέντε που μπορούν να διαγράψουν, ιδίως τη διαγραφή ασθενή που είναι μόνιμη.
Ναι. Οι υποβολές φορμών περιέχουν κλινικές απαντήσεις, οπότε όλος ο τομέας βρίσκεται πίσω από τον ρόλο ιδιοκτήτη και όχι μόνο οι εγγραφές του. Αυτό αντικατοπτρίζει ακριβώς το REST API — το MCP δεν είναι παρακαμπτήριος μιας άδειας που επιβάλλει η επιφάνεια HTTP.