---
title: "Εργαλεία MCP για αναφορές — HyperCRM"
description: "Τα έξι εργαλεία MCP για δείκτες πίνακα, τις τρεις αναφορές ανά διάστημα, το ιστορικό ελέγχου και την αναζήτηση, με παραμέτρους και ρόλο για το καθένα."
canonical: "https://hypercrm.app/el/docs/mcp/analytics"
lang: "el"
updated: "2026-07-26"
---

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

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

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

[Ξεκινήστε δωρεάν δοκιμή](/dashboard) · [Και τα 60 εργαλεία](/el/docs/mcp/tools)

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

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

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

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

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

### get_dashboard_kpis

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

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

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

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

**Αποτέλεσμα**

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

**Σφάλματα**

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

### get_appointments_report

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

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

**Παράμετροι**

| Εργαλείο | Τύπος | Υποχρεωτικό; |
| --- | --- | --- |
| `from` | `string` | Υποχρεωτικό |
| `to` | `string` | Υποχρεωτικό |
| `groupBy` | `day` \\| `week` \\| `month` | Προαιρετικό |

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

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_appointments_report",
    "arguments": {
      "from": "2026-07-08T09:00:00.000Z",
      "to": "2026-07-08T17:00:00.000Z"
    }
  }
}
```

**Αποτέλεσμα**

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

**Σφάλματα**

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

### get_revenue_report

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

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

**Παράμετροι**

| Εργαλείο | Τύπος | Υποχρεωτικό; |
| --- | --- | --- |
| `from` | `string` | Υποχρεωτικό |
| `to` | `string` | Υποχρεωτικό |
| `groupBy` | `day` \\| `week` \\| `month` | Προαιρετικό |

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

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_revenue_report",
    "arguments": {
      "from": "2026-07-08T09:00:00.000Z",
      "to": "2026-07-08T17:00:00.000Z"
    }
  }
}
```

**Αποτέλεσμα**

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

**Σφάλματα**

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

### get_patient_acquisition_report

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

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

**Παράμετροι**

| Εργαλείο | Τύπος | Υποχρεωτικό; |
| --- | --- | --- |
| `from` | `string` | Υποχρεωτικό |
| `to` | `string` | Υποχρεωτικό |
| `groupBy` | `day` \\| `week` \\| `month` | Προαιρετικό |

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

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_patient_acquisition_report",
    "arguments": {
      "from": "2026-07-08T09:00:00.000Z",
      "to": "2026-07-08T17:00:00.000Z"
    }
  }
}
```

**Αποτέλεσμα**

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

**Σφάλματα**

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

### list_audit_log

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

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

**Παράμετροι**

| Εργαλείο | Τύπος | Υποχρεωτικό; |
| --- | --- | --- |
| `type` | `string` | Προαιρετικό |
| `from` | `string` | Προαιρετικό |
| `to` | `string` | Προαιρετικό |
| `limit` | `integer` | Προαιρετικό |
| `offset` | `integer` | Προαιρετικό |

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

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

**Αποτέλεσμα**

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

**Σφάλματα**

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

### search

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

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

**Παράμετροι**

| Εργαλείο | Τύπος | Υποχρεωτικό; |
| --- | --- | --- |
| `q` | `string` | Υποχρεωτικό |
| `limit` | `integer` | Προαιρετικό |

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

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

**Αποτέλεσμα**

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

**Σφάλματα**

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

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

### Πώς προστατεύονται τα δεδομένα των ασθενών;

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

### Μπορώ να εξάγω τα δεδομένα μου;

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

### Πόσο κοστίζει το HyperCRM;

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