> ## Documentation Index
> Fetch the complete documentation index at: https://docs.deskboy.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Etherly Insights

> Δώστε σε εργαλεία AI όπως το Claude, το ChatGPT ή το Grok πρόσβαση στα δεδομένα κρατήσεων και εσόδων σας.

## Τι είναι το Etherly Insights

Το Etherly Insights επιτρέπει σε εργαλεία AI (Claude, ChatGPT, Grok και άλλα που υποστηρίζουν MCP) να διαβάζουν τα δεδομένα κρατήσεων και εσόδων σας, ώστε να μπορείτε να κάνετε ερωτήσεις όπως «Πόσα έσοδα είχα τον προηγούμενο μήνα;» ή «Βρες την κράτηση με κωδικό HM-12345» απευθείας στο εργαλείο AI της επιλογής σας.

<Note>
  Ψάχνετε για προγραμματιστική πρόσβαση στα δεδομένα σας (REST/OpenAPI, χωρίς εργαλείο AI); Δείτε τον
  οδηγό **«Πρόσβαση Δεδομένων (API)»**.
</Note>

<Note>
  Το Etherly Insights είναι **αυστηρά μόνο για ανάγνωση**. Κανένα εργαλείο AI δεν μπορεί να δημιουργήσει, να τροποποιήσει ή να διαγράψει δεδομένα μέσω αυτής της σύνδεσης.
</Note>

***

## Πώς λειτουργεί

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

* **Ρωτήστε ελεύθερα**: Δεν χρειάζεται να γνωρίζετε ονόματα εργαλείων ή ειδική σύνταξη. Το AI
  εργαλείο διαβάζει την ερώτησή σας και επιλέγει μόνο του ποιο κομμάτι δεδομένων χρειάζεται
  (έσοδα, κρατήσεις, καθαριότητα, αφίξεις/αναχωρήσεις και άλλα).
* **Ζωντανά δεδομένα**: Κάθε ερώτηση φέρνει τα πιο πρόσφατα στοιχεία απευθείας από τον
  λογαριασμό σας τη στιγμή που ρωτάτε.
* **Μόνο τα δικά σας δεδομένα**: Κάθε σύνδεση βλέπει αποκλειστικά τα properties, τις κρατήσεις
  και τα έσοδα της δικής σας επιχείρησης.
* **Πολλαπλές συνδέσεις**: Μπορείτε να συνδέσετε περισσότερα από ένα εργαλεία AI ταυτόχρονα
  (π.χ. Claude Desktop και ChatGPT), το καθένα ως ξεχωριστή συνδεδεμένη εφαρμογή, και να τα
  διαχειρίζεστε ή να τα αποσυνδέετε ανεξάρτητα.

### Ενδεικτικές ερωτήσεις

* «Πόσα έσοδα είχα τον προηγούμενο μήνα ανά κανάλι κράτησης;»
* «Ποια properties έχουν το υψηλότερο ποσοστό πληρότητας φέτος;»
* «Ποιες αφίξεις έχω αύριο και ποιες είναι έτοιμες για check-in;»
* «Ποιο είναι το ποσοστό ακυρώσεων τον τελευταίο μήνα;»

***

## Απόρρητο επισκεπτών

Τα στοιχεία επισκεπτών **δεν** μοιράζονται ποτέ μέσω του Etherly Insights: όνομα, email, τηλέφωνο και αριθμός ταυτοποίησης δεν εμφανίζονται ποτέ στα αποτελέσματα. Επιτρέπονται μόνο μη-προσωποποιήσιμα στοιχεία (διανυκτερεύσεις, ποσά, κανάλι κράτησης και χώρα προέλευσης του επισκέπτη — υπολογισμένη από τον κωδικό χώρας του τηλεφώνου, όχι πραγματική εθνικότητα).

***

## Ενεργοποίηση

<Steps>
  <Step title="Μεταβείτε στις ρυθμίσεις">
    Πηγαίνετε στις **Ρυθμίσεις → Διασυνδέσεις** και βρείτε την κάρτα **Etherly Insights** στην
    ενότητα «Apps». Πατήστε **«Ενεργοποίηση»** — ανοίγει ένα αναδυόμενο παράθυρο συναίνεσης.
  </Step>

  <Step title="Ενεργοποιήστε τη λειτουργία">
    Διαβάστε τη σύντομη περιγραφή συναίνεσης στο παράθυρο και πατήστε **«Ενεργοποίηση»**. Μόλις
    ενεργοποιηθεί, η καρτέλα **«Etherly Insights»** εμφανίζεται μόνιμα στο μενού Ρυθμίσεων, με το
    **MCP endpoint** σας και τη λίστα συνδεδεμένων εφαρμογών.
  </Step>
</Steps>

<Note>
  Αν προτιμάτε, μπορείτε να παραλείψετε αυτό το βήμα — η έγκριση μιας σύνδεσης μέσω Claude.ai, Grok
  ή ChatGPT (παρακάτω) ενεργοποιεί αυτόματα το Etherly Insights.
</Note>

***

## Σύνδεση με εργαλείο AI

Στην καρτέλα **Etherly Insights** θα βρείτε το **MCP endpoint** σας — το URL που χρειάζεστε για να
συνδέσετε οποιοδήποτε εργαλείο AI που υποστηρίζει MCP.

### Σύνδεση μέσω Claude.ai (OAuth)

Η λειτουργία **«Add custom connector»** του Claude.ai υποστηρίζει μόνο OAuth, όχι απευθείας API key. Για να συνδεθείτε:

<Steps>
  <Step title="Προσθήκη connector">
    Στο Claude.ai, πηγαίνετε στις **Settings → Connectors**, πατήστε το κουμπί **«Add»** πάνω
    δεξιά και επιλέξτε **«Add custom connector»**.
  </Step>

  <Step title="Συμπληρώστε τα στοιχεία">
    Δώστε ένα όνομα (π.χ. «Etherly Insights») και επικολλήστε το URL του **MCP endpoint**
    (`https://app.etherly.app/api/insights/mcp`) στο πεδίο **«Remote MCP server URL»**. Δεν
    χρειάζεται να συμπληρώσετε τα προαιρετικά πεδία «OAuth Client ID / Secret» στα Advanced
    settings — αφήστε τα κενά και πατήστε **«Add»**.
  </Step>

  <Step title="Σύνδεση και έγκριση">
    Το Claude ανοίγει μια οθόνη σύνδεσης και συναίνεσης. Συνδεθείτε με τον συνήθη λογαριασμό
    σας στο Etherly και πατήστε **«Allow»** για να δώσετε πρόσβαση.
  </Step>

  <Step title="Ολοκληρώθηκε">
    Η σύνδεση εμφανίζεται στις **Ρυθμίσεις → Etherly Insights** στη λίστα «Συνδεδεμένες
    εφαρμογές», με ημερομηνία **«Συνδέθηκε στις»** και δικό της κουμπί αποσύνδεσης.
  </Step>
</Steps>

<Note>
  Αν το Etherly Insights δεν ήταν ήδη ενεργοποιημένο, η έγκριση της σύνδεσης με το Claude.ai το
  ενεργοποιεί αυτόματα — δεν χρειάζεται ξεχωριστό βήμα χειροκίνητης ενεργοποίησης.
</Note>

### Σύνδεση μέσω Grok (OAuth)

<Steps>
  <Step title="Προσθήκη connector">
    Στο Grok, πηγαίνετε στο **Skills and Connectors → Connectors** και πατήστε
    **«New Connector»**.
  </Step>

  <Step title="Custom connector">
    Στο παράθυρο που ανοίγει, επιλέξτε **«Custom»**, δώστε ένα όνομα (π.χ. «Etherly Insights»)
    και επικολλήστε το URL του **MCP endpoint** (`https://app.etherly.app/api/insights/mcp`).
  </Step>

  <Step title="Σύνδεση και έγκριση">
    Το Grok ανοίγει μια οθόνη σύνδεσης και συναίνεσης. Συνδεθείτε με τον συνήθη λογαριασμό σας
    στο Etherly και εγκρίνετε την πρόσβαση.
  </Step>

  <Step title="Ολοκληρώθηκε">
    Η σύνδεση εμφανίζεται στις **Ρυθμίσεις → Etherly Insights** στη λίστα «Συνδεδεμένες
    εφαρμογές».
  </Step>
</Steps>

### Σύνδεση μέσω ChatGPT (OAuth)

<Steps>
  <Step title="Ενεργοποίηση Developer mode">
    Στο ChatGPT, πηγαίνετε στις **Settings → Plugins** και ενεργοποιήστε το
    **«Developer mode»**.
  </Step>

  <Step title="Άνοιγμα της σελίδας Plugins">
    Επιλέξτε **Plugins** από το αριστερό μενού του ChatGPT ή ανοίξτε απευθείας το
    [chatgpt.com/plugins](https://chatgpt.com/plugins), και πατήστε το **+**.
  </Step>

  <Step title="Στοιχεία σύνδεσης">
    Συμπληρώστε:

    * **Όνομα** (π.χ. «Etherly Insights»)
    * **Περιγραφή** (σύντομη, προαιρετική)
    * Το **HTTPS endpoint του MCP server** του Etherly
      (`https://app.etherly.app/api/insights/mcp`)
    * Τρόπος authentication: **OAuth**

    Πατήστε **Create / Scan Tools**.
  </Step>

  <Step title="Σύνδεση και έγκριση">
    Το ChatGPT ανοίγει μια οθόνη σύνδεσης και συναίνεσης. Συνδεθείτε με τον συνήθη λογαριασμό
    σας στο Etherly και εγκρίνετε την πρόσβαση.
  </Step>

  <Step title="Ολοκληρώθηκε">
    Η σύνδεση εμφανίζεται στις **Ρυθμίσεις → Etherly Insights** στη λίστα «Συνδεδεμένες
    εφαρμογές».
  </Step>

  <Step title="Χρήση σε συνομιλία">
    Ανοίξτε νέα συνομιλία και πατήστε **+ → More → Developer mode** και μετά το όνομα της
    εφαρμογής, ή πληκτρολογήστε το όνομα που δώσατε για να τη βρείτε.
  </Step>
</Steps>

<Tip>
  **Πιο γρήγορος τρόπος:** αντί για το **+**, γράψτε `@` και το όνομα που δώσατε στην εφαρμογή
  στην αρχή της ερώτησής σας — π.χ. `@Etherly ποια είναι η πληρότητα του Αυγούστου;`. Έτσι το
  ChatGPT χρησιμοποιεί σίγουρα τα δεδομένα του Etherly για τη συγκεκριμένη ερώτηση.
</Tip>

***

## Διαθέσιμα εργαλεία

Δεν χρειάζεται να επιλέξετε εσείς εργαλείο — απλά ρωτήστε, και το AI εργαλείο σας διαλέγει
αυτόματα το κατάλληλο. Ο παρακάτω πίνακας δείχνει τι μπορείτε να ρωτήσετε.

### Έσοδα & απόδοση

| Εργαλείο                  | Περιγραφή                                                                                        |
| ------------------------- | ------------------------------------------------------------------------------------------------ |
| **business-overview**     | Συνολικές κρατήσεις, διανυκτερεύσεις, έσοδα και ανάλυση ανά κανάλι για ένα εύρος ημερομηνιών     |
| **revenue-summary**       | Σύγκριση κρατήσεων, διανυκτερεύσεων και εσόδων του τρέχοντος μήνα ή εβδομάδας με την προηγούμενη |
| **revenue-breakdown**     | Ανάλυση ποσών σε μεικτά έσοδα, φόρους/τέλη, προμήθεια καναλιού και καθαρή απόδοση ιδιοκτήτη      |
| **cancellation-analysis** | Ποσοστό ακυρώσεων συνολικά και ανά κανάλι κράτησης, μαζί με τα χαμένα έσοδα                      |

### Τιμολόγηση & πληρότητα

| Εργαλείο         | Περιγραφή                                                                                                |
| ---------------- | -------------------------------------------------------------------------------------------------------- |
| **booking-pace** | Πόσο έχει προχωρήσει η πληρότητα μιας μελλοντικής περιόδου σε σχέση με την αντίστοιχη περυσινή           |
| **occupancy**    | Ποσοστό πληρότητας, μέση τιμή διανυκτέρευσης (ADR) και έσοδα ανά διαθέσιμο δωμάτιο (RevPAR) ανά property |

### Κατατάξεις & συγκρίσεις

| Εργαλείο                  | Περιγραφή                                                                                            |
| ------------------------- | ---------------------------------------------------------------------------------------------------- |
| **channel-profitability** | Ποιο κανάλι κράτησης αποφέρει τα περισσότερα καθαρά έσοδα ανά διανυκτέρευση                          |
| **seasonality**           | Κρατήσεις, διανυκτερεύσεις και έσοδα ανά μήνα για ένα ημερολογιακό έτος                              |
| **length-of-stay-value**  | Σύγκριση μέσης τιμής διανυκτέρευσης ανάμεσα σε μεγάλες διαμονές (28+ διανυκτερεύσεις) και μικρότερες |
| **property-leaderboard**  | Κατάταξη όλων των properties σας βάσει εσόδων, κρατήσεων ή διανυκτερεύσεων                           |

### Κρατήσεις & επισκέπτες

| Εργαλείο                      | Περιγραφή                                                                                                                                                                                                                |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **booking-search**            | Εύρεση κράτησης βάσει κωδικού κράτησης, ή μέρους του ονόματος επισκέπτη (η αναζήτηση γίνεται με βάση το όνομα, αλλά το όνομα του επισκέπτη δεν εμφανίζεται ποτέ στα αποτελέσματα — δείτε παρακάτω «Απόρρητο επισκεπτών») |
| **checkin-completion-status** | Ποιοι επερχόμενοι επισκέπτες έχουν ολοκληρώσει το Online Check-In                                                                                                                                                        |
| **arrivals-departures**       | Ποιοι αφικνούνται/αναχωρούν σε ένα εύρος ημερομηνιών, με ένδειξη ταυτόχρονων check-out/check-in                                                                                                                          |
| **guest-nationality-mix**     | Κατανομή χώρας προέλευσης επισκεπτών (βάσει κωδικού χώρας τηλεφώνου) για ένα εύρος ημερομηνιών                                                                                                                           |
| **list-properties**           | Λίστα των properties σας (όνομα, κανάλι, τοποθεσία)                                                                                                                                                                      |

### Λειτουργικά

| Εργαλείο                | Περιγραφή                                                                                                         |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------- |
| **operational-backlog** | Πλήθος κρατήσεων που εκκρεμούν για τιμολόγηση, ακυρωμένων, σε παύση, μεγάλης διαμονής και προς χειροκίνητο έλεγχο |
| **cleaning-readiness**  | Ποια properties είναι έτοιμα για μια συγκεκριμένη ημέρα, με εκκρεμείς και επερχόμενες εργασίες καθαριότητας       |

### Αγορά περιοχής

| Εργαλείο                     | Περιγραφή                                                                                                                                                                                                                                                                    |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **market-snapshot**          | Εικόνα της αγοράς βραχυχρόνιας μίσθωσης στην περιοχή σας: πληρότητα αγοράς, μέση τιμή διανυκτέρευσης και ενεργές καταχωρήσεις                                                                                                                                                |
| **market-comparison**        | Σύγκριση της δικής σας πληρότητας και μέσης τιμής με την αγορά της περιοχής για έναν μήνα — με καταλύματα αντίστοιχης χωρητικότητας όταν αυτή είναι γνωστή (π.χ. βίλα με βίλες), και για μελλοντικούς μήνες με τις μέχρι στιγμής κρατήσεις και των δύο πλευρών               |
| **property-market-position** | Πού βρίσκεται ένα κατάλυμα απέναντι στα συγκρίσιμα της περιοχής του (ίδιο προφίλ μεγέθους): σε ποιο εύρος της κατανομής κάθεται η τιμή, η πληρότητα και τα έσοδά του — απαιτεί συμπληρωμένα συντεταγμένες, χωρητικότητα, υπνοδωμάτια και μπάνια στην καρτέλα του καταλύματος |

<Note>
  Τα εργαλεία αγοράς βασίζονται σε εξωτερική πηγή δεδομένων αγοράς και διαθέτουν ημερήσιο όριο χρήσης ανά λογαριασμό. Η ακρίβεια της περιοχής βελτιώνεται όταν τα properties σας έχουν συντεταγμένες — δείτε τον οδηγό «Ρύθμιση Καταλυμάτων».
</Note>

Περισσότερα εργαλεία θα προστεθούν σταδιακά.

***

## Όρια χρήσης

* **Ημερήσιο όριο**: έως 500 κλήσεις/ημέρα, συνολικά για όλες τις συνδεδεμένες εφαρμογές σας
  μαζί. Στην καρτέλα **Etherly Insights** εμφανίζεται μια μπάρα με τη σημερινή χρήση σε σχέση με
  αυτό το όριο.
* Ισχύει επίσης όριο κλήσεων ανά λεπτό για λόγους ασφαλείας.

Αν ξεπεραστεί κάποιο όριο, το εργαλείο AI θα λάβει μήνυμα σφάλματος και θα πρέπει να περιμένει πριν ξαναδοκιμάσει.

***

## Ανάκληση πρόσβασης

* Για να αποσυνδέσετε μια εφαρμογή (π.χ. το Claude), πατήστε το εικονίδιο διαγραφής δίπλα της
  στη λίστα «Συνδεδεμένες εφαρμογές».
* Για να απενεργοποιήσετε εντελώς το Etherly Insights, πατήστε **«Απενεργοποίηση»** — όλες οι
  συνδεδεμένες εφαρμογές αποσυνδέονται άμεσα.

<Note>
  Η ανάκληση ισχύει άμεσα· δεν υπάρχει καθυστέρηση ή cache που θα επέτρεπε σε μια αποσυνδεδεμένη εφαρμογή να συνεχίσει να λειτουργεί.
</Note>