Διακομιστής MCP (πράκτορες AI)
Το Joryio είναι διακομιστής MCP. Ένας βοηθός AI συνδέεται με είσοδο και δουλεύει με τον χώρο εργασίας σας: παραθέτει καμπάνιες και journeys, διαβάζει τα αποτελέσματά τους και τα ευρήματα του ελέγχου εκκίνησης, ρωτά για συμβάντα, ελέγχει ποιο περιεχόμενο αποδίδει και - όταν το επιτρέψετε - δημιουργεί πρόχειρα καμπανιών και τμήματα για να τα ελέγξει ένας άνθρωπος.
Δεν υπάρχει τίποτα να εγκαταστήσετε και κανένα κλειδί να αντιγράψετε. Ο πράκτορας μιλά με το ίδιο δημόσιο REST API που τεκμηριώνεται στην Αναφορά API· κάθε εργαλείο είναι ένα τεκμηριωμένο endpoint.
Δικαιώματα - ποιανού πρόσβαση παίρνει ο πράκτορας;
Τη δική σας. Όταν συνδέετε έναν πελάτη AI, το Joryio σας στέλνει σε μια οθόνη συγκατάθεσης στον πίνακα ελέγχου, όπου συνδέεστε ως εσείς και επιλέγετε τι μπορεί να κάνει ο πράκτορας. Από τότε ο πράκτορας ενεργεί ως εσείς, περιορισμένος σε ό,τι επιλέξατε:
- Δεν μπορεί ποτέ να κάνει περισσότερα από εσάς. Η οθόνη συγκατάθεσης προσφέρει μόνο δικαιώματα που έχετε, και κάθε αίτημα ελέγχει τόσο τα δικαιώματά σας όσο και τα επιλεγμένα πεδία.
- Αν χάσετε ένα δικαίωμα, κάθε πράκτορας που συνδέσατε το χάνει στο επόμενο αίτημά του. Αποσυνδέστε έναν πράκτορα από Ρυθμίσεις > Γενικά και τα διακριτικά του παύουν αμέσως.
- Κάθε σύνδεση δένεται με τον χώρο εργασίας στον οποίο βρισκόσασταν όταν την εγκρίνατε.
- Οι ενέργειες του πράκτορα καταγράφονται ως δικές σας. Συνδέστε με τον ρόλο που εννοείτε: ένας συνάδελφος που συνδέει το Claude ως ο ίδιος παραχωρεί τη δική του πρόσβαση, όχι τη δική σας.
Δεν υπάρχει ξεχωριστός "χρήστης πράκτορα" ούτε κλειδί API προς διαχείριση. Οργανισμοί που προτιμούν κλειδιά μπορούν ακόμα να χρησιμοποιούν το REST API απευθείας.
Τα δεδομένα επαφών είναι απενεργοποιημένα από προεπιλογή
Τα δεδομένα ατόμων είναι το ευαίσθητο μέρος ενός χώρου εργασίας marketing, οπότε ένας πράκτορας AI δεν τα παίρνει εκτός αν ισχύουν δύο πράγματα:
- Ένας διαχειριστής έχει ενεργοποιήσει το Επιτρέψτε στους πράκτορες AI να διαβάζουν δεδομένα επαφών από Ρυθμίσεις > Γενικά για τον οργανισμό. Μέχρι τότε η οθόνη συγκατάθεσης δεν προσφέρει καθόλου τα εργαλεία επαφών.
- Το άτομο που συνδέει τον πράκτορα κατέχει το δικαίωμα Πράκτορες AI: δεδομένα επαφών (
agents:contacts, δικαίωμα επιπέδου διαχειριστή) και το επιλέγει στην οθόνη συγκατάθεσης.
Ακόμα και τότε, τα πεδία που ο χώρος εργασίας σημειώνει ως προσωπικά δεδομένα επιστρέφουν καλυμμένα εκτός αν αυτό το άτομο έχει το δικαίωμα PII - ο ίδιος κανόνας που εφαρμόζουν ο πίνακας ελέγχου και το REST API. Ένα κλειδί API μπορεί να φέρει το πεδίο agents:contacts υπό τον ίδιο διακόπτη του οργανισμού.
Σύνδεση πελάτη
Η διεύθυνση σύνδεσής σας εμφανίζεται στο Ρυθμίσεις > Γενικά > Πράκτορες AI με κουμπί αντιγραφής. Πάρτε τη από εκεί αντί να την πληκτρολογήσετε: κάθε περιοχή του Joryio έχει τη δική της διεύθυνση, και η κάρτα δείχνει πάντα αυτή της περιοχής όπου βρίσκεται ο χώρος εργασίας σας. Για την περιοχή ΕΕ είναι:
https://api-eu1.joryio.com/api/mcp
- Claude (claude.ai, Claude Desktop, Claude Code): προσθέστε προσαρμοσμένο σύνδεσμο με αυτή τη διεύθυνση, ή
claude mcp add --transport http joryio https://api-eu1.joryio.com/api/mcp. - ChatGPT: προσθέστε τη διεύθυνση ως σύνδεσμο στις ρυθμίσεις συνδέσμων της εφαρμογής.
- Grok (xAI): δείτε το Grok παρακάτω - το grok.com και το CLI Grok Build συνδέονται με είσοδο· το API της xAI όχι.
- Cursor και άλλοι πελάτες που υποστηρίζουν απομακρυσμένους διακομιστές MCP (Streamable HTTP) με OAuth: προσθέστε τη διεύθυνση· ο πελάτης εγγράφεται και ανοίγει την οθόνη συγκατάθεσης στον περιηγητή σας.
- Πελάτες που τρέχουν μόνο τοπικούς διακομιστές: χρησιμοποιήστε τη γέφυρα της κοινότητας
npx -y mcp-remote https://api-eu1.joryio.com/api/mcp.
Ο διακομιστής χρησιμοποιεί OAuth 2.1 με δυναμική εγγραφή πελάτη και PKCE· η ανακάλυψη βρίσκεται στο https://api-eu1.joryio.com/.well-known/oauth-authorization-server. Τα διακριτικά πρόσβασης διαρκούν μία ώρα και ανανεώνονται σιωπηλά για τριάντα ημέρες ή μέχρι να αποσυνδέσετε.
Grok (xAI)
- grok.com: ανοίξτε το grok.com/connectors, επιλέξτε New Connector και μετά Custom, και επικολλήστε τη διεύθυνση σύνδεσής σας. Το Grok σας στέλνει στην οθόνη συγκατάθεσης του Joryio για να συνδεθείτε και να επιλέξετε τι επιτρέπεται να κάνει. Στα Grok Business και Enterprise ένας διαχειριστής της ομάδας ρυθμίζει πρώτα τον σύνδεσμο στην κονσόλα της xAI· τα μέλη τον βρίσκουν μετά στους συνδέσμους τους.
- Grok Build (το CLI
grok):grok mcp add --transport http joryio https://api-eu1.joryio.com/api/mcp. Η είσοδος ανοίγει στον περιηγητή σας την πρώτη φορά που το Grok χρησιμοποιεί τον διακομιστή· μπορείτε επίσης να την ξεκινήσετε από την καρτέλα MCP στο/mcps. - API της xAI (απομακρυσμένα εργαλεία MCP σε αίτημα Responses): δεν υποστηρίζεται. Αυτή η διαδρομή στέλνει ένα σταθερό διακριτικό στην κεφαλίδα
Authorizationκαι δεν μπορεί να ολοκληρώσει είσοδο, ενώ το endpoint MCP του Joryio δέχεται μόνο τα διακριτικά που εκδίδει η δική του είσοδος - ένα κλειδί API απορρίπτεται. Για να φτάσετε στο Joryio από τον δικό σας κώδικα μέσω του API της xAI, καλέστε το REST API με κλειδί API από τα δικά σας εργαλεία συναρτήσεων (function tools).
Τι προσφέρει η οθόνη συγκατάθεσης
| Ομάδα | Πεδία | Τι μπορεί να κάνει ο πράκτορας |
|---|---|---|
| Ανάγνωση | campaigns:read canvas:read segments:read events:read analytics:read | Παράθεση και ανάγνωση καμπανιών, journeys, τμημάτων, συμβάντων, αναφορών και του καταλόγου |
| Δημιουργία πρόχειρων | campaigns:write segments:write events:track | Δημιουργία πρόχειρων καμπανιών και τμημάτων για έλεγχο από εσάς· καταγραφή συμβάντων |
| Δεδομένα επαφών | users:read users:write agents:contacts | Αναζήτηση και ανάγνωση ατόμων, ενημέρωση χαρακτηριστικών - μόνο με ενεργό τον διακόπτη του οργανισμού |
Επιλεγμένα από προεπιλογή: ό,τι ζήτησε ο πελάτης, ή η ομάδα Ανάγνωση.
Εργαλεία
| Εργαλείο | Τι επιστρέφει | Endpoint |
|---|---|---|
list_campaigns | Καμπάνιες ανά κατάσταση, κανάλι ή όνομα | GET /campaigns |
get_campaign | Μία καμπάνια με τις παραλλαγές και τη στόχευσή της | GET /campaigns/:id |
get_campaign_stats | Απεσταλμένα, παραδοθέντα, ανοίγματα, κλικ, μετατροπές | GET /campaigns/:id/stats |
get_campaign_failure_reasons | Αποτυχίες παράδοσης ανά κωδικό παρόχου | GET /campaigns/:id/failure-reasons |
get_campaign_launch_review | Εμπόδια και συστάσεις | GET /campaigns/:id/launch-review |
get_campaign_performance | Καμπάνιες ταξινομημένες κατά επαυξητικές μετατροπές, η καθεμία στον δικό της στόχο μετατροπής | GET /campaigns/performance |
get_journey | Ένα journey πλήρες: έναυσμα, κόμβοι με τα μηνύματά τους, ακμές | GET /journeys/:id |
list_journeys, get_journey_stats, get_journey_launch_review | Το ίδιο για journeys | GET /journeys… |
list_segments, get_segment_size | Αποθηκευμένα κοινά και το μέγεθός τους | GET /segments… |
list_contact_imports | Εισαγωγές επαφών με όνομα αρχείου και ημερομηνία, για φίλτρο τμήματος «προήλθε από εισαγωγή» (χρειάζεται users:read, όχι agents:contacts) | GET /users/import/sources |
query_events, list_recent_events, get_event_trend | Συμβάντα σε εύρος, ο εξερευνητής, μια τάση | GET /events/query, GET /analytics/events, POST /analytics/events/trend |
get_active_users_now, get_content_performance | Ζωντανή μέτρηση, ποιο περιεχόμενο αποδίδει | GET /analytics/… |
list_products, get_catalog_stats | Ο κατάλογος και η κατάστασή του | GET /catalog/… |
create_campaign_draft | Δημιουργεί καμπάνια ως πρόχειρο - πάντα πρόχειρο, ό,τι κι αν ζητήσει ο πράκτορας | POST /campaigns |
create_segment | Δημιουργεί αποθηκευμένο τμήμα | POST /segments |
track_event | Καταγράφει ένα συμβάν για ένα άτομο | POST /users/track |
search_contacts, get_contact, update_contact | Άτομα (μόνο με την ομάδα δεδομένων επαφών) | GET /users/search, GET /users/:id, PUT /users/by-user-id/:id |
Ένα εργαλείο εμφανίζεται μόνο όταν η σύνδεση φέρει το πεδίο του.
Τι δεν μπορεί ποτέ να κάνει ο πράκτορας
Δεν υπάρχει εργαλείο που στέλνει, προγραμματίζει, ενεργοποιεί, εγκρίνει, ξαναστέλνει, εξάγει ή διαγράφει οτιδήποτε, ούτε που διαχειρίζεται κλειδιά API ή μέλη ομάδας - ό,τι κι αν επιλέξατε. Ένα πρόχειρο που δημιουργεί ο πράκτορας περιμένει στον πίνακα ελέγχου έναν άνθρωπο να το ελέγξει, να τρέξει τον έλεγχο εκκίνησης και να το στείλει.
Διαχείριση συνδέσεων
Ρυθμίσεις > Γενικά > Πράκτορες AI παραθέτει τους πράκτορες που είναι συνδεδεμένοι ως εσείς, με τα πεδία του καθενός και την τελευταία χρήση. Η Αποσύνδεση τον ανακαλεί αμέσως. Οι διαχειριστές βρίσκουν τον διακόπτη δεδομένων επαφών του οργανισμού στην ίδια κάρτα.
Όρια
Τα αιτήματα μετρούν στα κανονικά όρια ρυθμού του API του χώρου εργασίας· ο πράκτορας καλείται να περιμένει όταν φτάσει σε ένα. Κάθε κλήση εργαλείου λήγει μετά από 30 δευτερόλεπτα. Οι λίστες σελιδοποιούνται με τις ίδιες παραμέτρους limit και page / offset όπως το REST API.