Βοηθός AI (MCP)

Το CongPlan μπορεί να συνδεθεί με έναν βοηθό AI μέσω της διεπαφής MCP (Model Context Protocol). Έτσι μπορείς να κάνεις ερωτήσεις σχετικά με τον προγραμματισμό σε φυσική γλώσσα ή να υπαγορεύεις καταχωρίσεις αντί να κάνεις κλικ μέσα από τα μενού. Ο βοηθός διαβάζει και γράφει τα ίδια δεδομένα με την εφαρμογή, οπότε κάθε ενέργεια περνά από τους ίδιους ελέγχους δικαιωμάτων, ελέγχους διενέξεων και καταγραφή στο ημερολόγιο ελέγχου.

Ανοιχτό πρότυπο

Το MCP είναι ένα ανοιχτό πρότυπο, οπότε η σύνδεση λειτουργεί με οποιονδήποτε βοηθό υποστηρίζει MCP. Το CongPlan παρέχει ένα τελικό σημείο MCP ξεχωριστά για κάθε εκκλησία και χρησιμοποιεί OAuth 2.1 για την εξουσιοδότηση. Αν ο πελάτης σου υποστηρίζει OAuth, συνδέεσαι μόνο με το URL του τελικού σημείου και κάνεις είσοδο μέσω του CongPlan — δεν χρειάζεται διακριτικό. Ένα προσωπικό διακριτικό πρόσβασης απαιτείται μόνο σε πελάτες χωρίς υποστήριξη OAuth ή όταν χρειάζεσαι ένα στατικό, μακράς διάρκειας διαπιστευτήριο.

Πριν ξεκινήσεις

Η πρόσβαση MCP είναι απενεργοποιημένη από προεπιλογή. Πριν μπορέσεις να τη χρησιμοποιήσεις, χρειάζονται δύο βήματα:

1. Ένας διαχειριστής ενεργοποιεί τη διεπαφή MCP για την εκκλησία (στις ρυθμίσεις διαχειριστή).
2. Ένας διαχειριστής σού παραχωρεί πρόσβαση ώστε να μπορείς να συνδέσεις έναν βοηθό — είτε μέσω σύνδεσης OAuth είτε δημιουργώντας ένα προσωπικό διακριτικό. Αν δεν έχεις ακόμη πρόσβαση, μπορείς να τη ζητήσεις από την οθόνη MCP.

Σύνδεση του βοηθού σου

Το τελικό σημείο MCP του CongPlan είναι https://my.congplan.app/api/mcp.

Claude.ai / Claude Desktop

1. Άνοιξε τις ρυθμίσεις του λογαριασμού σου στο Claude (με την ένδειξη Settings ή Customize, ανάλογα με το πρόγραμμά σου) και βρες Connectors > Add custom connector.
2. Επικόλλησε το παρακάτω URL του τελικού σημείου. Το Claude ανοίγει ένα πρόγραμμα περιήγησης για να κάνεις είσοδο μέσω του CongPlan και ολοκληρώνει αυτόματα τη σύνδεση OAuth — δεν χρειάζεται διακριτικό.

https://my.congplan.app/api/mcp

Claude Code CLI

# OAuth (recommended): opens a browser to log in to CongPlan
claude mcp add --transport http congplan https://my.congplan.app/api/mcp

# Personal access token (fallback for non-interactive/CI use)
claude mcp add --transport http congplan https://my.congplan.app/api/mcp \
  --header "Authorization: Bearer cpm_your_token_here"

ChatGPT (προσαρμοσμένος σύνδεσμος)

1. Στο ChatGPT, άνοιξε Settings και βρες Connectors (η ακριβής διατύπωση του μενού μπορεί να διαφέρει ανάλογα με το πρόγραμμα ή την έκδοση της εφαρμογής)· επίλεξε να προσθέσεις ή να δημιουργήσεις έναν νέο σύνδεσμο.
2. Επικόλλησε το URL του τελικού σημείου και ολοκλήρωσε τη σύνδεση OAuth. Δεν χρειάζεται διακριτικό — οι σύνδεσμοι του ChatGPT υποστηρίζουν το OAuth απευθείας.

Γενικό mcp.json (Cursor, Windsurf κ.λπ.)

Οι πελάτες που διαβάζουν τη λίστα διακομιστών MCP από ένα αρχείο mcp.json υποστηρίζουν και τους δύο τύπους σύνδεσης — χρησιμοποίησε OAuth αν το υποστηρίζει ο πελάτης, διαφορετικά ένα διακριτικό τύπου bearer:

{
  "mcpServers": {
    "congplan-oauth": {
      "url": "https://my.congplan.app/api/mcp"
    },
    "congplan-token": {
      "url": "https://my.congplan.app/api/mcp",
      "headers": {
        "Authorization": "Bearer cpm_your_token_here"
      }
    }
  }
}

Ζήτησε από τον βοηθό σου να ρυθμιστεί μόνος του

Πολλοί βοηθοί μπορούν να ρυθμίσουν μόνοι τους τη σύνδεση αν επικολλήσεις μια σύντομη οδηγία:

Add the CongPlan MCP server at https://my.congplan.app/api/mcp using OAuth.
If OAuth isn't supported, ask me for a personal access token and use it as an
Authorization: Bearer header instead.

Προσωπικά διακριτικά πρόσβασης

Χρειάζεσαι διακριτικό μόνο αν ο πελάτης σου δεν μπορεί να χρησιμοποιήσει OAuth ή χρειάζεται ένα μακράς διάρκειας διαπιστευτήριο.

Μόλις αποκτήσεις πρόσβαση, δημιούργησε ένα προσωπικό διακριτικό στις ρυθμίσεις του λογαριασμού σου:

1. Άνοιξε Εγώ > Ενσωματώσεις.
2. Επίλεξε Δημιουργία διακριτικού.
3. Δώσε στο διακριτικό ένα όνομα, επίλεξε τα εύρη πρόσβασης που μπορεί να χρησιμοποιεί και όρισε μια ημερομηνία λήξης (έως 90 ημέρες).
4. Αντίγραψε το διακριτικό αμέσως — εμφανίζεται μόνο μία φορά και δεν μπορεί να ανακτηθεί ξανά.

Χρησιμοποίησε ένα διακριτικό στον βοηθό της επιλογής σου που υποστηρίζει MCP, για να τον συνδέσεις με την εκκλησία σου.

Εύρη πρόσβασης

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

• Ανάγνωση — προφίλ εκκλησίας, ευαγγελιζόμενοι, όμιλοι υπηρεσίας αγρού, συναθροίσεις, διορισμοί (συμπεριλαμβανομένων των τεχνικών διορισμών), συναθροίσεις για υπηρεσία αγρού, εργασίες, δημόσια μαρτυρία, εξερχόμενες δημόσιες ομιλίες και (ευαίσθητες) απουσίες.
• Εγγραφή — εργασίες, συναθροίσεις για υπηρεσία αγρού, διορισμοί, συναθροίσεις, δημόσια μαρτυρία και τα δικά σου αιτήματα παράδοσης ή εγγραφές.

Παραχώρησε μόνο τα εύρη πρόσβασης που πραγματικά χρειάζεσαι. Ένα διακριτικό μπορεί να ανακληθεί ανά πάσα στιγμή.

Αιτήματα βάσει ονόματος

Όταν ζητάς από τον βοηθό να ενεργήσει για συγκεκριμένους ευαγγελιζόμενους με το όνομά τους, για παράδειγμα «κατέγραψε μια απουσία για τη Λίντα και τον Τιμ», πρέπει πρώτα να αντιστοιχίσει αυτά τα ονόματα στα εσωτερικά αναγνωριστικά ευαγγελιζόμενων του CongPlan. Παραχώρησε το εύρος Publishers read μαζί με το αντίστοιχο εύρος εγγραφής, όπως το Absences write, ώστε ο βοηθός να μπορεί να αναζητήσει τα άτομα που πρέπει να ενημερώσει.

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

Παραδείγματα αιτημάτων

Αυτό που λες εξαρτάται από τον βοηθό, αλλά τα τυπικά αιτήματα μοιάζουν κάπως έτσι:

• «Ποιος έχει διοριστεί στη μεσοβδόμαδη συνάθροιση της επόμενης εβδομάδας;»
• «Ποια μέρη παραμένουν χωρίς διορισμό για τη συνάθροιση του Σαββατοκύριακου στις 14 Ιουλίου;»
• «Ποιες συναθροίσεις έχουν προγραμματιστεί την επόμενη εβδομάδα;»
• «Όρισε τον αδελφό Μίλερ ως ομιλητή για τη Δημόσια Ομιλία στις 14 Ιουλίου.»
• «Δημιούργησε μια εργασία: έλεγξε τα μικρόφωνα για τη συνάθροιση του Σαββατοκύριακου το Σάββατο.»
• «Δείξε μου όλες τις συναθροίσεις για υπηρεσία αγρού αυτής της εβδομάδας με τον οδηγό και το σημείο συνάντησης.»
• «Ποιος έχει μικρόφωνο ή υπηρεσία ήχου/εικόνας αυτό το Σαββατοκύριακο;»
• «Ποιοι ομιλητές μας έχουν προγραμματισμένη εξερχόμενη ομιλία τον επόμενο μήνα;»
• «Δημιούργησε τη συνάθροιση Σαββατοκύριακου για τις 16 Αυγούστου.»

Ο βοηθός προτείνει την ενέργεια· αυτή αποθηκεύεται μέσω των ίδιων διαδρομών με μια χειροκίνητη καταχώριση, συμπεριλαμβανομένων των ελέγχων καταλληλότητας και διενέξεων. Όταν του ζητάς να δημιουργήσει μια νέα συνάθροιση, το CongPlan εφαρμόζει αυτόματα το κατάλληλο πρότυπο προγράμματος — το ίδιο που θα ίσχυε αν το δημιουργούσες χειροκίνητα — ώστε η συνάθροιση να μην ξεκινά κενή. Αν δεν ταιριάζει κανένα πρότυπο (ή ζητήσεις ρητά μια κενή συνάθροιση), δημιουργείται χωρίς πρόγραμμα.

Ανωνυμοποίηση από προεπιλογή

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

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

Δικαιώματα και ασφάλεια

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

Σχετικά

• Δικαιώματα
• Εργασίες