---
title: "Εργαλεία MCP για φόρμες — HyperCRM"
description: "Τα πέντε εργαλεία MCP για φόρμες εισαγωγής και συναίνεσης: παράμετροι, παραδείγματα κλήσης, αποτελέσματα και σφάλματα. Όλα απαιτούν ρόλο ιδιοκτήτη."
canonical: "https://hypercrm.app/el/docs/mcp/forms"
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).

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

### list_forms

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

Λίστα των φορμών εισαγωγής και συναίνεσης του ιατρείου.

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

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

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

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

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

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

### get_form

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

Ανάγνωση μιας φόρμας με τα πεδία της.

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

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

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

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_form",
    "arguments": {
      "formId": "0f1c7a2e-...."
    }
  }
}
```

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

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

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

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

### list_form_submissions

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

Λίστα όλων των υποβολών μιας φόρμας, νεότερες πρώτα.

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

| Εργαλείο | Τύπος | Υποχρεωτικό; |
| --- | --- | --- |
| `formId` | `string` | Υποχρεωτικό |
| `status` | `all` \\| `submitted` \\| `pending` | Προαιρετικό |
| `page` | `integer` | Προαιρετικό |
| `pageSize` | `integer` | Προαιρετικό |

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

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_form_submissions",
    "arguments": {
      "formId": "0f1c7a2e-...."
    }
  }
}
```

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

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

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

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

### get_form_submission

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

Ανάγνωση μιας υποβολής και των απαντήσεών της.

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

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

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

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_form_submission",
    "arguments": {
      "formId": "0f1c7a2e-....",
      "submissionId": "0f1c7a2e-...."
    }
  }
}
```

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

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

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

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

### write_form

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

action=create φτιάχνει φόρμα· update επεξεργάζεται μεταδεδομένα· delete τη διαγράφει· replace_fields αντικαθιστά όλη τη λίστα πεδίων· create_link εκδίδει ΔΗΜΟΣΙΟ σύνδεσμο μίας χρήσης που λήγει σε 3 ημέρες (προαιρετικά δεσμευμένο σε ασθενή, του οποίου τον φάκελο οι απαντήσεις τότε αντικαθιστούν)· seed_defaults εγκαθιστά τα πρότυπα του pack.

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

| Εργαλείο | Τύπος | Υποχρεωτικό; |
| --- | --- | --- |
| `action` | `create` \\| `update` \\| `delete` \\| `replace_fields` \\| `create_link` \\| `seed_defaults` | Υποχρεωτικό |
| `formId` | `string` | Προαιρετικό |
| `patientId` | `string` | Προαιρετικό |
| `name` | `string` | Προαιρετικό |
| `description` | `string` | Προαιρετικό |
| `isActive` | `boolean` | Προαιρετικό |
| `fields` | `array` | Προαιρετικό |

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

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

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

```json
{
  "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;

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