Αναφορά MCP / Κατάλογοι

Εργαλεία καταλόγων

Επτά εργαλεία για έδρες θεραπείας, τοποθεσίες, τον κατάλογο υπηρεσιών και τις ετικέτες ασθενών: τις λίστες από τις οποίες αντλούν τιμές ραντεβού, αποδείξεις, τιμολόγια και φάκελοι.

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

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

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

Ένα εργαλείο που γράφει δείχνει ένα παράδειγμα για κάθε ενέργεια, γιατί αυτό που χρειάζεται μια ενέργεια δεν είναι ό,τι ορίζει υποχρεωτικό το σχήμα εισόδου: το σχήμα ζητά το action και τα υπόλοιπα τα αφήνει στην ενέργεια. Κάθε παράδειγμα είναι πλήρες αίτημα tools/call, και οι παράμετροί του ελέγχονται, όταν φτιάχνεται αυτή η σελίδα, με το ίδιο αντικείμενο που διαβάζει ο server. Τα σφάλματα επιστρέφονται μέσα σε απόκριση 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": { "...": "the requested records" },
    "content": [{ "type": "text", "text": "<the same JSON>" }]
  }
}

Σφάλματα

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

list_locations

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

Λίστα των τοποθεσιών του ιατρείου με όνομα και διεύθυνση, και αν ισχύουν οι τοποθεσίες.

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

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

Αποτέλεσμα

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

Σφάλματα

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

list_services

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

Λίστα του καταλόγου υπηρεσιών. Με isPublic=true μόνο όσες προσφέρονται στη δημόσια σελίδα κράτησης.

Παράμετροι

Εργαλείο	Τύπος	Υποχρεωτικό;	Τι σημαίνει
visibility	string: public \| hidden	Προαιρετικό	Omit this to list the whole catalogue, which is almost always what you want. "public" lists only the services offered on the public booking page; "hidden" lists only the ones that are not.

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

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

Αποτέλεσμα

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

list_tags

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

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

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

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

Αποτέλεσμα

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

Σφάλματα

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

write_chair

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

Δημιουργία, ενημέρωση ή διαγραφή έδρας. Τα update και delete απαιτούν chairId. Η διαγραφή δεν ακυρώνει κανένα ραντεβού: οι κρατήσεις κρατούν την ώρα και τον ασθενή τους και μένουν χωρίς έδρα.

Παράμετροι

Εργαλείο	Τύπος	Υποχρεωτικό;	Τι σημαίνει
action	string: create \| update \| delete	Υποχρεωτικό
chairId	string	Προαιρετικό	The chair to update or delete.
title	string	Προαιρετικό	The chair's display name, e.g. "Surgery 1". Required for action=create.
doctorName	string	Προαιρετικό	Optional note for the team about who works this chair. Not shown to patients. A member's usual chair is usualChairId on list_practice_members.
color	string	Προαιρετικό	Six-digit hex colour with a leading #, e.g. "#1a2b3c". Shorthand ("#abc") and colour names ("red") are rejected.
isPublic	boolean	Προαιρετικό	Whether this chair is bookable from the practice's public booking page. Defaults to false.
position	integer	Προαιρετικό	Sort order in the calendar. Lower comes first. Defaults to 0.

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

action=create

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "write_chair",
    "arguments": {
      "action": "create",
      "title": "Chair 1",
      "color": "#1f5eff",
      "isPublic": true
    }
  }
}

action=update

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "write_chair",
    "arguments": {
      "action": "update",
      "chairId": "6f708192-2d3e-4f80-9b4c-5d6e7f8091a2",
      "title": "Chair 2"
    }
  }
}

action=delete

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "write_chair",
    "arguments": {
      "action": "delete",
      "chairId": "6f708192-2d3e-4f80-9b4c-5d6e7f8091a2"
    }
  }
}

Αποτέλεσμα

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

Σφάλματα

Κωδικός	Κατάσταση	Πότε
validation_failed	400	Λείπει παράμετρος, έχει λάθος τύπο, ή είναι εκτός των επιτρεπτών τιμών.
not_found	404	Το id δεν υπάρχει στο ιατρείο σας. Ένα κακοσχηματισμένο id φαίνεται ίδιο.
plan_limit_reached	403	action=create πάνω από τις έδρες που περιλαμβάνει το πακέτο. Η απάντηση λέει το όριο και τη χρήση.
forbidden	403	Ο καλών δεν είναι ιδιοκτήτης του ιατρείου.
plan_feature_required	403	Το πακέτο του ιατρείου δεν το περιλαμβάνει. Το MCP χρειάζεται Complete.
subscription_read_only	403	Η συνδρομή έχει λήξει, οπότε το ιατρείο είναι μόνο για ανάγνωση και δεν γράφεται τίποτα.

write_service

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

Δημιουργία, ενημέρωση ή διαγραφή υπηρεσίας, ή εγκατάσταση του προεπιλεγμένου καταλόγου του pack με action=seed_defaults. Τα update και delete απαιτούν serviceId.

Παράμετροι

Εργαλείο	Τύπος	Υποχρεωτικό;	Τι σημαίνει
action	string: create \| update \| delete \| seed_defaults	Υποχρεωτικό
serviceId	string	Προαιρετικό	The service to update or delete.
name	string	Προαιρετικό	The service's name. Required for action=create.
priceMinor	integer	Προαιρετικό	The service's price. Required for action=create. In MINOR currency units (cents): 4500 means 45.00, not 4500.00.
durationMinutes	integer	Προαιρετικό	How long the service takes, used to pre-fill appointment length. Optional.
isPublic	boolean	Προαιρετικό	Whether the service is offered on the public booking page. Defaults to false.

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

action=create

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "write_service",
    "arguments": {
      "action": "create",
      "name": "Check-up",
      "priceMinor": 4500,
      "durationMinutes": 30,
      "isPublic": true
    }
  }
}

action=update

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "write_service",
    "arguments": {
      "action": "update",
      "serviceId": "5e6f7081-1c2d-4e9f-8a3b-4c5d6e7f8091",
      "priceMinor": 5000
    }
  }
}

action=delete

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "write_service",
    "arguments": {
      "action": "delete",
      "serviceId": "5e6f7081-1c2d-4e9f-8a3b-4c5d6e7f8091"
    }
  }
}

action=seed_defaults

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

Αποτέλεσμα

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

Σφάλματα

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

write_tag

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

Δημιουργία, ενημέρωση ή διαγραφή ετικέτας ασθενή. Τα update και delete απαιτούν tagId. Η διαγραφή την αφαιρεί από κάθε ασθενή που τη φέρει.

Παράμετροι

Εργαλείο	Τύπος	Υποχρεωτικό;	Τι σημαίνει
action	string: create \| update \| delete	Υποχρεωτικό
tagId	string	Προαιρετικό	The tag to update or delete.
title	string	Προαιρετικό	The tag's label. Required for action=create. Unique per practice, case-insensitively.
color	string	Προαιρετικό	The tag's colour. Required for action=create. Six-digit hex with a leading #, e.g. "#1a2b3c".

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

action=create

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "write_tag",
    "arguments": {
      "action": "create",
      "title": "Recall due",
      "color": "#1f5eff"
    }
  }
}

action=update

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "write_tag",
    "arguments": {
      "action": "update",
      "tagId": "70819203-3e4f-4091-8c5d-6e7f8091a2b3",
      "title": "Recall sent"
    }
  }
}

action=delete

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "write_tag",
    "arguments": {
      "action": "delete",
      "tagId": "70819203-3e4f-4091-8c5d-6e7f8091a2b3"
    }
  }
}

Αποτέλεσμα

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

Σφάλματα

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

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

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

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

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