- Το MCP (Model Context Protocol) είναι ένα ανοιχτό πρότυπο που επιτρέπει στις εφαρμογές AI να καλούν εργαλεία άλλων υπηρεσιών, ώστε ένας βοηθός να απαντά από τα πραγματικά δεδομένα του καταστήματός σας.
- Το Ask AI του ROASaurus και ο MCP server του ROASaurus μοιράζονται 24 εργαλεία μόνο ανάγνωσης, από κέρδος, απόδοση και αξία πελατών έως κόστη, leads, συνδρομές, το marketing mix model και ανωμαλίες.
- Μια εφαρμογή AI συνδέεται κάνοντας είσοδο στο ROASaurus με OAuth ή με ένα API key σε header Authorization.
- Ένα κλειδί με όνομα που έχει μόνο το scope mcp μπορεί μόνο να διαβάζει· το κλειδί του Orders API μπορεί επίσης να στέλνει παραγγελίες, γι' αυτό κρατήστε κάθε κλειδί μυστικό και ανακαλέστε το αν διαρρεύσει.
- Οι περίοδοι είναι σταθερές (σήμερα, χθες ή οι τελευταίες 7, 14, 30 ή 90 ημέρες) και το Ask AI επιτρέπει από προεπιλογή 40 ερωτήσεις ανά χρήστη την ημέρα.
Ένας MCP server για το Shopify συνδέει τα δεδομένα του καταστήματός σας με έναν βοηθό AI μέσω του Model Context Protocol (MCP). Κάνετε μια ερώτηση σε απλή γλώσσα, όπως «Ποια καμπάνια έφερε το περισσότερο κέρδος τον περασμένο μήνα;», και ο βοηθός απαντά από τα πραγματικά νούμερα του καταστήματός σας αντί από μνήμης. Το ROASaurus τρέχει έναν MCP server με 24 εργαλεία analytics μόνο ανάγνωσης και τα ίδια εργαλεία κινούν το Ask AI μέσα στον πίνακα ελέγχου.
Ο οδηγός αυτός εξηγεί τι είναι το MCP, γιατί βοηθά να κάνετε ερωτήσεις analytics με αυτόν τον τρόπο, πώς λειτουργούν το Ask AI και ο MCP server, πώς συνδέετε έναν client, ποιες ερωτήσεις δουλεύουν καλά και ποιο είναι το απόρρητο, η ασφάλεια και τα όρια που πρέπει να γνωρίζετε.
Τι είναι το MCP;
Το MCP είναι ένα πρότυπο ανοιχτού κώδικα για τη σύνδεση εφαρμογών AI με εξωτερικά συστήματα. Μια εφαρμογή AI όπως το Claude είναι ο client. Μια υπηρεσία που προσφέρει δεδομένα ή ενέργειες είναι ο server. Ο server περιγράφει τα tools του: κάθε εργαλείο έχει όνομα, περιγραφή και ένα σχήμα για τις εισόδους του.
Όταν κάνετε μια ερώτηση, ο client ρωτά τον server ποια εργαλεία υπάρχουν (tools/list). Το μοντέλο διαλέγει το εργαλείο που ταιριάζει και ο client το καλεί (tools/call). Το αποτέλεσμα επιστρέφει στο μοντέλο, που γράφει την απάντηση. Δεν χρειάζεται να γνωρίζετε τα ονόματα των εργαλείων. Απλώς κάνετε την ερώτηση.
Και το Shopify τρέχει MCP servers. Επικεντρώνονται σε shopping agents και προγραμματιστές: αναζήτηση προϊόντων, καλάθια, checkout, λογαριασμούς πελατών και τεκμηρίωση για προγραμματιστές. Ένας MCP server analytics απαντά σε διαφορετικό είδος ερωτήσεων: κέρδος μετά τις διαφημίσεις, απόδοση και αξία πελατών, υπολογισμένα από τις παραγγελίες σας, τα κόστη σας και τη δαπάνη στους διαφημιστικούς λογαριασμούς σας.
Γιατί να ρωτάτε έναν βοηθό AI για τα δεδομένα του καταστήματός σας;
Οι περισσότερες ερωτήσεις για ένα κατάστημα χρειάζονται νούμερα από διάφορες αναφορές. Το «Έβγαλε λεφτά η Meta τον περασμένο μήνα;» χρειάζεται έσοδα, κόστη προϊόντων, μεταφορικά, προμήθειες και διαφημιστική δαπάνη σε ένα σημείο. Σε έναν πίνακα ελέγχου ανοίγετε τη σωστή αναφορά, ορίζετε τις ημερομηνίες και κάνετε τις πράξεις. Σε έναν βοηθό AI συνδεδεμένο με τα δεδομένα σας, κάνετε την ερώτηση και παίρνετε την απάντηση μαζί με τα νούμερα πίσω από αυτήν.
- Απλή γλώσσα. Χωρίς φίλτρα, report builders ή τύπους υπολογιστικών φύλλων.
- Επόμενες ερωτήσεις. Ρωτήστε «και για το TikTok;» ή «ποια καμπάνια το προκάλεσε αυτό;» χωρίς να ξεκινάτε από την αρχή.
- Πολλές αναφορές σε μία απάντηση. Το κέρδος, η απόδοση και η αξία πελατών μπορούν να συνδυαστούν σε μία απάντηση.
- Η δική σας γλώσσα. Το Ask AI απαντά στη γλώσσα στην οποία γράφετε.
- Δίπλα στην υπόλοιπη δουλειά σας. Μέσω MCP, τα νούμερα του καταστήματος είναι διαθέσιμα στην εφαρμογή AI όπου ήδη γράφετε ενημερώσεις ή σχέδια.
Η απάντηση είναι τόσο πλήρης όσο τα δεδομένα πίσω της. Συνδέστε πρώτα την server-side παρακολούθηση, τους διαφημιστικούς λογαριασμούς σας και τα κόστη προϊόντων σας, ώστε τα εργαλεία να έχουν παραγγελίες, δαπάνη και περιθώρια για να δουλέψουν.
Πώς λειτουργούν το Ask AI και ο MCP server του ROASaurus;
Το Ask AI είναι μια σελίδα συνομιλίας στον πίνακα ελέγχου του ROASaurus. Λειτουργεί με το Claude, το μοντέλο της Anthropic. Ο MCP server προσφέρει τα ίδια 24 εργαλεία σε έναν client AI της επιλογής σας. Και στις δύο περιπτώσεις τα εργαλεία διαβάζουν τις αναφορές σας στο ROASaurus και επιστρέφουν τα νούμερα ως JSON. Το μοντέλο γράφει την απάντηση από αυτά τα αποτελέσματα.
Κάθε εργαλείο analytics μόνο διαβάζει. Κανένα εργαλείο δεν μπορεί να αλλάξει το κατάστημά σας, τις καμπάνιες σας, τα κόστη σας ή τις ρυθμίσεις σας. Ο MCP server σημαίνει καθένα από αυτά ως μόνο ανάγνωσης και λέει στον client να απαντά μόνο από τα αποτελέσματα των εργαλείων. Ένα κλειδί με το scope actions:write λαμβάνει επίσης το propose_action, το οποίο προσθέτει μια προτεινόμενη αλλαγή διαφήμισης στα εισερχόμενα Actions· τίποτα δεν αλλάζει μέχρι να την εγκρίνει ένας ιδιοκτήτης ή διαχειριστής. Το έχει και το Ask AI στον πίνακα ελέγχου.
Στο Ask AI, μία ερώτηση μπορεί να χρησιμοποιήσει έως 8 γύρους κλήσεων εργαλείων. Αν μια ερώτηση χρειάζεται περισσότερους, ο βοηθός σας ζητά να γίνετε πιο συγκεκριμένοι. Το Ask AI κρατά τη συνομιλία σας ανά χρήστη και κατάστημα και χρησιμοποιεί τα τελευταία 12 μηνύματα ως πλαίσιο για μια επόμενη ερώτηση. Μπορείτε να διαγράψετε τη συνομιλία οποιαδήποτε στιγμή.
Ποιες ερωτήσεις μπορείτε να κάνετε;
Οι καλές ερωτήσεις κατονομάζουν μια μετρική και μία από τις υποστηριζόμενες περιόδους. Ο πίνακας δείχνει παραδείγματα ερωτήσεων, το εργαλείο που απαντά σε καθεμία και σε τι βασίζεται η απάντηση.
| Ερώτηση | Εργαλείο | Τι δείχνει η απάντηση |
|---|---|---|
| Πώς συγκρίθηκαν οι τελευταίες 7 ημέρες με τις 7 ημέρες πριν; | profit_summary | Έσοδα, παραγγελίες, διαφημιστική δαπάνη, MER, POAS και κέρδος, σε σύγκριση με την προηγούμενη περίοδο ίσης διάρκειας |
| Ποια καμπάνια είχε το καλύτερο POAS τις τελευταίες 30 ημέρες; | campaign_profit | Ανά καμπάνια: έσοδα που αποδίδονται, μικτό κέρδος, διαφημιστική δαπάνη, κέρδος μετά τις διαφημίσεις, ROAS, POAS και CAC |
| Ποιες διαφημίσεις έχουν υψηλό CPM και λίγες αγορές; | ads_table | Δαπάνη, εμφανίσεις, κλικ, CTR και CPM δίπλα σε παρακολουθούμενες αγορές, ROAS και CPA |
| Πόσους μήνες χρειάζεται ένα cohort για να αποσβέσει το CAC του; | ltv_insights | Μηνιαία cohort, ο μήνας απόσβεσης του CAC και το προβλεπόμενο LTV |
| Ποια προϊόντα φέρνουν τους περισσότερους πελάτες που αγοράζουν ξανά; | products | Κορυφαία προϊόντα και το ποσοστό των πρώτων αγοραστών που παρήγγειλαν ξανά |
| Βρισκόμαστε στον σωστό δρόμο για τον στόχο εσόδων αυτού του μήνα; | goals_forecast | Στόχοι, πραγματικά νούμερα μέχρι σήμερα και πρόβλεψη τέλους μήνα |
| Τι πρέπει να ξαναπαραγγείλω αυτή την εβδομάδα; | inventory | Διαθέσιμο απόθεμα, ρυθμός πωλήσεων, ημέρες αποθέματος που απομένουν και κατάσταση αναπαραγγελίας |
Να ένα αναλυτικό παράδειγμα. Ρωτάτε: «Έβγαλε λεφτά η Meta τις τελευταίες 30 ημέρες;» Το μοντέλο καλεί το campaign_profit με την περίοδο ορισμένη στις 30 ημέρες και το προεπιλεγμένο μοντέλο τελευταίου κλικ. Για ένα κατάστημα-παράδειγμα, η γραμμή της Meta στο αποτέλεσμα μοιάζει ως εξής:
| Γραμμή | Meta, τελευταίες 30 ημέρες | Πώς υπολογίζεται |
|---|---|---|
| Έσοδα που αποδίδονται | $24,000 | Τα έσοδα των παραγγελιών που αποδίδονται σε κλικ της Meta |
| Μικτό κέρδος (contribution στο αποτέλεσμα) | $13,440 | Έσοδα μείον κόστος προϊόντος, μεταφορικά, προμήθειες πληρωμών και διαχείριση (56%) |
| Διαφημιστική δαπάνη | $8,000 | Συγχρονίζεται από τον διαφημιστικό λογαριασμό της Meta |
| Κέρδος μετά τις διαφημίσεις | $5,440 | $13,440 − $8,000 |
| ROAS | 3.00 | $24,000 ÷ $8,000 |
| POAS | 1.68 | $13,440 ÷ $8,000 |
Στο Ask AI, η απάντηση ξεκινά με «Ναι», μετά δίνει το κέρδος μετά τις διαφημίσεις και το POAS και προτείνει το πολύ τρία επόμενα βήματα. Αν θέλετε άλλη οπτική, κάντε μια επόμενη ερώτηση όπως «και με το μοντέλο Total Impact;». Οι οδηγοί μας για το POAS και τα μοντέλα απόδοσης εξηγούν αυτά τα νούμερα σε μεγαλύτερο βάθος.
Πώς συνδέετε τον MCP server του ROASaurus;
Ο server χρησιμοποιεί τη μεταφορά Streamable HTTP του MCP και επιστρέφει απαντήσεις JSON, χωρίς server-sent events. Εφαρμογές AI όπως το Claude και το ChatGPT συνδέονται με OAuth: κάνετε είσοδο στο ROASaurus, επιλέγετε κατάστημα και επιτρέπετε τη σύνδεση. Οι clients όπου μπορείτε να ορίσετε header αιτήματος, όπως το Claude Code, μπορούν να χρησιμοποιήσουν αντί γι’ αυτό ένα API key, όπως στα παρακάτω βήματα.
- Δημιουργήστε ένα κλειδί API
Ανοίξτε το Store settings › API & data στο ROASaurus και δημιουργήστε ένα κλειδί με όνομα με το scope
mcp. Αντιγράψτε το: εμφανίζεται μόνο μία φορά. Μόνο οι ιδιοκτήτες και οι διαχειριστές μπορούν να δημιουργούν κλειδιά. - Ή χρησιμοποιήστε ξανά το κλειδί του Orders API
Μπορείτε επίσης να χρησιμοποιήσετε το κλειδί στην κάρτα Orders API, για παράδειγμα αυτό που χρησιμοποιεί το plugin του WooCommerce. Αυτό το κλειδί μπορεί επίσης να στέλνει παραγγελίες. Το Regenerate API key το αντικαθιστά και αποσυνδέει ό,τι χρησιμοποιεί το παλιό.
- Σημειώστε το κλειδί καταστήματος
Ένα κλειδί με όνομα μπαίνει μόνο του στο header. Με το κλειδί του Orders API, προσθέστε το store key: την τιμή
X-Roasaurus-Keyστην ίδια κάρτα, της οποίας η ενότητα MCP δείχνει ολόκληρο το header. - Προσθέστε τον server στον MCP client σας
Εισαγάγετε το endpoint και την κεφαλίδα Authorization που φαίνονται παρακάτω. Ο client πρέπει να υποστηρίζει Streamable HTTP και προσαρμοσμένες κεφαλίδες αιτημάτων.
- Κάντε μια δοκιμαστική ερώτηση
Ρωτήστε «Ποια ήταν τα έσοδά μου χθες;» και ελέγξτε τον αριθμό με τον πίνακα ελέγχου σας.
# Endpoint POST https://app.roasaurus.com/mcp Authorization: Bearer <named key with the mcp scope> # or, with the Orders API key Authorization: Bearer <store key>:<API key> # Claude Code claude mcp add --transport http roasaurus https://app.roasaurus.com/mcp \ --header "Authorization: Bearer <named key with the mcp scope>"
Μπορείτε επίσης να στείλετε το κλειδί καταστήματος σε μια κεφαλίδα X-Roasaurus-Key και μόνο το API key ως bearer token. Στο Claude Code, κρατήστε την προεπιλεγμένη τοπική εμβέλεια (local scope). Ένας server με εμβέλεια έργου αποθηκεύεται σε ένα αρχείο .mcp.json που μοιράζεται μέσω version control και αυτό θα μοιραζόταν το κλειδί σας.
Για να συνδεθείτε με λογαριασμό, προσθέστε το https://app.roasaurus.com/mcp ως προσαρμοσμένο connector στο Claude ή στο ChatGPT και κάντε είσοδο όταν σας το ζητήσει η εφαρμογή. Μόνο κάτοχοι και διαχειριστές μπορούν να επιτρέψουν μια σύνδεση. Το Store settings › API & data δείχνει κάθε συνδεδεμένη εφαρμογή, όπου μπορείτε να την αποσυνδέσετε, και μια σύνδεση σταματά επίσης όταν αυτό το άτομο αποχωρήσει από το workspace.
initialize · 2025-06-18Ο client και ο server συμφωνούν στην έκδοση του πρωτοκόλλουtools/list · 24 tools · readOnlyHint: trueΟ client μαθαίνει ποια εργαλεία υπάρχουνtools/call · campaign_profit · period 30Το μοντέλο ζητά 30 ημέρες κέρδους καμπάνιαςresult · isError: falseJSON με μία γραμμή ανά κανάλι και καμπάνια401 · Invalid store key or API key.Τι επιστρέφει ένα λάθος κλειδί ή ένα κλειδί που δημιουργήθηκε ξανάΕίναι ασφαλές; Απόρρητο και ασφάλεια
Επειδή τα εργαλεία analytics μόνο διαβάζουν, μια εφαρμογή AI δεν μπορεί να σταματήσει μια καμπάνια, να αλλάξει ένα κόστος ή να τροποποιήσει μια ρύθμιση μέσω του ROASaurus· με το actions:write μπορεί μόνο να προτείνει μια αλλαγή διαφήμισης για να την εγκρίνει ένας ιδιοκτήτης ή διαχειριστής. Τα εργαλεία δέχονται επίσης μόνο σταθερές εισόδους, όπως μια περίοδο ή ένα μοντέλο απόδοσης από μια λίστα. Παρ' όλα αυτά, μερικά σημεία θέλουν προσοχή.
- Πού πηγαίνουν τα δεδομένα. Το Ask AI στέλνει την ερώτησή σας και συγκεντρωτικές μετρικές του καταστήματος στην Anthropic, που τρέχει το Claude. Δεν στέλνει στοιχεία επικοινωνίας των πελατών σας. Μέσω MCP, τα αποτελέσματα των εργαλείων πηγαίνουν στον client AI που συνδέετε, σύμφωνα με τους όρους εκείνου του client. Ελέγξτε τις ρυθμίσεις διατήρησης δεδομένων και εκπαίδευσής του.
- Τι επιστρέφουν τα εργαλεία. Σύνολα ανά περίοδο, κανάλι, καμπάνια, διαφήμιση, προϊόν, cohort και τμήμα. Δεν επιστρέφουν ονόματα, διευθύνσεις email ή αριθμούς τηλεφώνου πελατών.
- Ποιος μπορεί να ρωτά. Όποιος έχει πρόσβαση στην εφαρμογή AI όπου προσθέτετε τη σύνδεση μπορεί να κάνει ερωτήματα στο κατάστημα. Προσθέστε την στον δικό σας λογαριασμό, όχι σε κοινόχρηστο.
- Άλλοι connectors. Η προδιαγραφή του MCP λέει ότι πρέπει πάντα να υπάρχει ένας άνθρωπος στη διαδικασία (human in the loop) που μπορεί να απορρίπτει κλήσεις εργαλείων και ότι οι clients πρέπει να αντιμετωπίζουν τα annotations των εργαλείων ως μη αξιόπιστα, εκτός αν ο server είναι αξιόπιστος. Αν η εφαρμογή AI σας έχει επίσης εργαλεία που στέλνουν email ή δημοσιεύουν μηνύματα, κρατήστε ενεργά τα μηνύματα επιβεβαίωσης για αυτά τα εργαλεία.
Ποια είναι τα όρια;
- Σταθερές περίοδοι. Σήμερα, χθες ή οι τελευταίες 7, 14, 30 ή 90 ημέρες, στη ζώνη ώρας του καταστήματος. Ένα προσαρμοσμένο εύρος, όπως μία εβδομάδα του Μαρτίου, δεν υποστηρίζεται. Τα εργαλεία αξίας πελατών και cohort δεν παίρνουν περίοδο: δουλεύουν από το ιστορικό παραγγελιών σας, με έως 12 μηνιαία cohort.
- Παράθυρο 7 ημερών για τον πίνακα διαφημίσεων. Το εργαλείο διαφημίσεων χρησιμοποιεί παράθυρο απόδοσης 7 ημερών, όποιο παράθυρο κι αν ορίσετε στο Store settings. Τα εργαλεία απόδοσης και κέρδους καμπάνιας, όπως και οι αναφορές απόδοσης στον πίνακα ελέγχου, χρησιμοποιούν τη δική σας ρύθμιση ή ένα παράθυρο που ζητάτε.
- Συντομευμένες λίστες. Οι λίστες καμπανιών επιστρέφουν το πολύ 25 καμπάνιες, ο πίνακας διαφημίσεων τις 30 γραμμές με τη μεγαλύτερη δαπάνη και η λίστα προϊόντων τα 25 κορυφαία προϊόντα.
- Ένα κατάστημα ανά σύνδεση. Για περισσότερα καταστήματα, δημιουργήστε ένα κλειδί και μια σύνδεση για καθένα.
- Το όριο ερωτήσεων του Ask AI. Κάθε χρήστης μπορεί να κάνει 40 ερωτήσεις την ημέρα από προεπιλογή, μετρημένες στις τελευταίες 24 ώρες. Μέσω MCP, ισχύουν αντί γι' αυτό τα δικά όρια χρήσης του client AI σας.
- Οι απαντήσεις μπορεί να είναι λάθος. Το μοντέλο μπορεί να διαβάσει λάθος ένα αποτέλεσμα. Ελέγξτε τα σημαντικά νούμερα στις αναφορές πριν ενεργήσετε με βάση αυτά, για παράδειγμα στην ανάλυση κέρδους.
Πηγές
- Model Context Protocol: What is the Model Context Protocol (MCP)?
- Model Context Protocol specification (2025-06-18): Tools
- Claude Code Docs: Connect Claude Code to tools via MCP
- Claude Docs: Authentication for connectors
- OpenAI: Building MCP servers for plugins and API integrations