Αναφορά MCP / Αναφορές

Εργαλεία αναφορών και αναζήτησης

Έξι εργαλεία για βασικούς δείκτες, τρεις αναφορές ανά διάστημα, το ιστορικό ελέγχου και την αναζήτηση. Οι αναφορές και το ιστορικό απαιτούν ιδιοκτήτη.

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

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

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

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

Αναφορές και αναζήτηση

Συγκεντρωτικά και αναζήτηση σε πολλές οντότητες. Οι τρεις αναφορές και το ιστορικό ελέγχου απαιτούν ιδιοκτήτη.

get_dashboard_kpis

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

Βασικοί δείκτες — σημερινά ραντεβού, ανεξόφλητα υπόλοιπα, πρόσφατη δραστηριότητα.

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

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

Αποτέλεσμα

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": { "...": "the requested records" },
    "content": [{ "type": "text", "text": "<the same JSON>" }]
  }
}

Σφάλματα

Κωδικός	Κατάσταση	Πότε
plan_feature_required	403	Το πακέτο του ιατρείου δεν το περιλαμβάνει. Το MCP χρειάζεται Complete.

get_appointments_report

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

Πλήθος ραντεβού ανά διάστημα. Το groupBy είναι day, week ή month.

Παράμετροι

Εργαλείο	Τύπος	Υποχρεωτικό;	Τι σημαίνει
from	string	Υποχρεωτικό	Start of the range, inclusive. YYYY-MM-DD.
to	string	Υποχρεωτικό	End of the range, inclusive. YYYY-MM-DD. Must be after from.
groupBy	string: day \| week \| month	Προαιρετικό	Bucket size for the series. Defaults to day.

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_appointments_report",
    "arguments": {
      "from": "2026-11-02",
      "to": "2026-11-02"
    }
  }
}

Αποτέλεσμα

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": { "...": "the requested records" },
    "content": [{ "type": "text", "text": "<the same JSON>" }]
  }
}

Σφάλματα

Κωδικός	Κατάσταση	Πότε
validation_failed	400	Λείπει παράμετρος, έχει λάθος τύπο, ή είναι εκτός των επιτρεπτών τιμών.
forbidden	403	Ο καλών δεν είναι ιδιοκτήτης του ιατρείου.
plan_feature_required	403	Το πακέτο του ιατρείου δεν το περιλαμβάνει. Το MCP χρειάζεται Complete.

get_revenue_report

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

Σύνολα εσόδων ανά διάστημα. Το groupBy είναι day, week ή month.

Παράμετροι

Εργαλείο	Τύπος	Υποχρεωτικό;	Τι σημαίνει
from	string	Υποχρεωτικό	Start of the range, inclusive. YYYY-MM-DD.
to	string	Υποχρεωτικό	End of the range, inclusive. YYYY-MM-DD. Must be after from.
groupBy	string: day \| week \| month	Προαιρετικό	Bucket size for the series. Defaults to day.

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_revenue_report",
    "arguments": {
      "from": "2026-11-02",
      "to": "2026-11-02"
    }
  }
}

Αποτέλεσμα

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": { "...": "the requested records" },
    "content": [{ "type": "text", "text": "<the same JSON>" }]
  }
}

Σφάλματα

Κωδικός	Κατάσταση	Πότε
validation_failed	400	Λείπει παράμετρος, έχει λάθος τύπο, ή είναι εκτός των επιτρεπτών τιμών.
forbidden	403	Ο καλών δεν είναι ιδιοκτήτης του ιατρείου.
plan_feature_required	403	Το πακέτο του ιατρείου δεν το περιλαμβάνει. Το MCP χρειάζεται Complete.

get_patient_acquisition_report

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

Πλήθος νέων ασθενών ανά διάστημα. Το groupBy είναι day, week ή month.

Παράμετροι

Εργαλείο	Τύπος	Υποχρεωτικό;	Τι σημαίνει
from	string	Υποχρεωτικό	Start of the range, inclusive. YYYY-MM-DD.
to	string	Υποχρεωτικό	End of the range, inclusive. YYYY-MM-DD. Must be after from.
groupBy	string: day \| week \| month	Προαιρετικό	Bucket size for the series. Defaults to day.

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_patient_acquisition_report",
    "arguments": {
      "from": "2026-11-02",
      "to": "2026-11-02"
    }
  }
}

Αποτέλεσμα

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": { "...": "the requested records" },
    "content": [{ "type": "text", "text": "<the same JSON>" }]
  }
}

Σφάλματα

Κωδικός	Κατάσταση	Πότε
validation_failed	400	Λείπει παράμετρος, έχει λάθος τύπο, ή είναι εκτός των επιτρεπτών τιμών.
forbidden	403	Ο καλών δεν είναι ιδιοκτήτης του ιατρείου.
plan_feature_required	403	Το πακέτο του ιατρείου δεν το περιλαμβάνει. Το MCP χρειάζεται Complete.

list_audit_log

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

Ανάγνωση του ιστορικού ελέγχου, νεότερα πρώτα. Φίλτρα τύπου οντότητας και εύρους ημερομηνιών.

Παράμετροι

Εργαλείο	Τύπος	Υποχρεωτικό;	Τι σημαίνει
type	string	Προαιρετικό	Action type to filter by, e.g. "INSERT_BILLING_ENTRY". Omit for all types.
from	string	Προαιρετικό	Only entries on or after this date. YYYY-MM-DD.
to	string	Προαιρετικό	Only entries on or before this date. YYYY-MM-DD.
limit	integer	Προαιρετικό	How many entries to return. Asked what happened in a period, use the maximum: a day of a busy practice runs to dozens of entries, and there is no reason to summarise from the newest twenty. Defaults to 50; at most 200 (a larger value is lowered to it, not rejected).
offset	integer	Προαιρετικό	How many entries to skip, for paging back through the trail. At most 100000.

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

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

Αποτέλεσμα

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": { "...": "the requested records" },
    "content": [{ "type": "text", "text": "<the same JSON>" }]
  }
}

Σφάλματα

Κωδικός	Κατάσταση	Πότε
validation_failed	400	Λείπει παράμετρος, έχει λάθος τύπο, ή είναι εκτός των επιτρεπτών τιμών.
forbidden	403	Ο καλών δεν είναι ιδιοκτήτης του ιατρείου.
plan_feature_required	403	Το πακέτο του ιατρείου δεν το περιλαμβάνει. Το MCP χρειάζεται Complete.

search

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

Αναζήτηση σε πολλές οντότητες του ιατρείου — ασθενείς, ραντεβού και άλλα.

Παράμετροι

Εργαλείο	Τύπος	Υποχρεωτικό;	Τι σημαίνει
q	string	Υποχρεωτικό	The text to search for.
limit	integer	Προαιρετικό	Maximum results per group. Defaults to 10; at most 50 (a larger value is lowered to it, not rejected).

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

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

Αποτέλεσμα

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": { "...": "the requested records" },
    "content": [{ "type": "text", "text": "<the same JSON>" }]
  }
}

Σφάλματα

Κωδικός	Κατάσταση	Πότε
validation_failed	400	Λείπει παράμετρος, έχει λάθος τύπο, ή είναι εκτός των επιτρεπτών τιμών.
plan_feature_required	403	Το πακέτο του ιατρείου δεν το περιλαμβάνει. Το MCP χρειάζεται Complete.

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

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

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

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