Dvina MCP

Χρησιμοποίησε το Dvina από άλλες εφαρμογές με το MCP

Σύνδεσε μια εφαρμογή-πελάτη MCP, όπως το Claude Code, το ChatGPT ή το Cursor, στο Dvina, συνδέσου στον λογαριασμό σου και επίτρεψέ της να διαβάζει και να προσθέτει περιεχόμενο στο Dvina με την έγκρισή σου.

Προβολή ως Markdown

Το Dvina διαθέτει δικό του διακομιστή MCP. Σύνδεσε μια εφαρμογή-πελάτη MCP, όπως το Claude Code, το ChatGPT ή το Cursor, ώστε να μπορεί να κάνει αναζήτηση στο Dvina σου, να διαβάζει τα έγγραφα και τη μνήμη σου και να προσθέτει σημειώσεις, εργασίες και υπενθυμίσεις εκ μέρους σου.

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

Χρειάζεσαι τη διεύθυνση του διακομιστή:

https://api.dvina.ai/mcp

Αν η εταιρεία σου φιλοξενεί το Dvina στους δικούς της διακομιστές, χρησιμοποίησε τη διεύθυνση του API του Dvina της εταιρείας σου, προσθέτοντας /mcp στο τέλος. Ζήτησέ τη από τον διαχειριστή σου.

Ο διακομιστής χρησιμοποιεί Streamable HTTP. Αν η εφαρμογή-πελάτης ζητά να επιλέξεις τρόπο μεταφοράς, επίλεξε HTTP.

Σύνδεση εφαρμογής-πελάτη

Claude Code

  1. Στο τερματικό σου, εκτέλεσε:

    claude mcp add --transport http dvina https://api.dvina.ai/mcp

  2. Άνοιξε το Claude Code, εκτέλεσε /mcp, επίλεξε dvina και συνδέσου στο Dvina.

ChatGPT

  1. Άνοιξε την ενότητα του ChatGPT όπου μπορείς να προσθέσεις έναν διακομιστή MCP.
  2. Καταχώρισε το https://api.dvina.ai/mcp ως διεύθυνση του διακομιστή και επίλεξε OAuth αν σου ζητηθεί τρόπος σύνδεσης.
  3. Συνδέσου στο Dvina όταν σου το ζητήσει το ChatGPT.

Cursor

  1. Άνοιξε την ενότητα του Cursor όπου μπορείς να προσθέσεις έναν διακομιστή MCP.
  2. Πρόσθεσε έναν διακομιστή με όνομα dvina και διεύθυνση https://api.dvina.ai/mcp.
  3. Συνδέσου στο Dvina όταν σου το ζητήσει το Cursor.

Δεν χρειάζεσαι αναγνωριστικό ή μυστικό πελάτη. Η εφαρμογή-πελάτης εγγράφεται αυτόματα στο Dvina την πρώτη φορά που συνδέεται.

Σύνδεση στον λογαριασμό σου

Ο διακομιστής MCP του Dvina σε συνδέει μέσω OAuth, στο πρόγραμμα περιήγησής σου:

  1. Συνδέσου στο Dvina όπως συνήθως.
  2. Αν ανήκεις σε περισσότερους από έναν χώρους εργασίας, επίλεξε έναν στην ενότητα Επιλογή χώρου εργασίας και μετά επίλεξε Συνέχεια. Η εφαρμογή-πελάτης λειτουργεί μόνο σε αυτόν τον χώρο εργασίας.
  3. Στην ενότητα Εξουσιοδότηση πρόσβασης, έλεγξε το όνομα της εφαρμογής και μετά επίλεξε Να επιτρέπεται η πρόσβαση. Επίλεξε Απόρριψη αν δεν την αναγνωρίζεις.

Η εφαρμογή-πελάτης παραμένει συνδεδεμένη, οπότε δεν χρειάζεται να συνδέεσαι κάθε φορά.

Τι μπορεί να κάνει μια εφαρμογή-πελάτης

Η εφαρμογή-πελάτης βλέπει τα εργαλεία του Dvina και τα χρησιμοποιεί όταν χρειάζονται για το αίτημά σου:

Περιοχή Τι μπορεί να κάνει το πρόγραμμα-πελάτης
Αναζήτηση Αναζήτηση στις συνομιλίες, τα έγγραφα, τη μνήμη και τον κόσμο σας ταυτόχρονα.
Μνήμη Προβολή λίστας και ανάγνωση των αρχείων μνήμης σας, προσθήκη νέου αρχείου ή αλλαγή ενός αρχείου.
Κόσμος Προβολή λίστας των θεμάτων σας, εμφάνιση όσων γνωρίζει το Dvina για ένα θέμα ή οτιδήποτε άλλο και προβολή λίστας της Ροής σας.
Έγγραφα Προβολή λίστας, ανάγνωση και αναζήτηση στη Βιβλιοθήκη σας, δημιουργία σημειώσεων και φακέλων, μεταφόρτωση αρχείων και αντικατάσταση, μετακίνηση ή μετονομασία εγγράφου ή μεταφορά του στον κάδο.
Καμβάς Προβολή λίστας και ανάγνωση των καμβάδων σας, δημιουργία καμβά ή επανεγγραφή σελίδας.
Εργασίες και στόχοι Προβολή λίστας των εργασιών σας και ανάγνωση όσων έκαναν, έναρξη εργασίας ή εργασίας που συμβάλλει σε έναν στόχο, ανάθεση επιπλέον δουλειάς σε μια εργασία ή διακοπή της.
Προγραμματισμένα μηνύματα Προβολή λίστας, προγραμματισμός μηνύματος ή υπενθύμισης, μία φορά ή επαναλαμβανόμενα, ή ακύρωση.
Πράκτορες και δεξιότητες Προβολή λίστας και ανάγνωση των πρακτόρων και των δεξιοτήτων σας, δημιουργία πράκτορα, προσθήκη δεξιότητας ή αλλαγή οποιουδήποτε από τα δύο.
Έργα Προβολή λίστας των έργων σας και εμφάνιση του φακέλου και των πρόσφατων εργασιών ενός έργου.
Κοινή χρήση Προβολή του ποιος έχει πρόσβαση σε ένα στοιχείο και όσων έχουν μοιραστεί άλλοι μαζί σας ή παραχώρηση ή αφαίρεση της πρόσβασης κάποιου.
Ρυθμίσεις Εμφάνιση των προτιμήσεών σας ή ενεργοποίηση ή απενεργοποίηση της μνήμης.

Το πρόγραμμα-πελάτης δεν μπορεί να διαγράψει τίποτα οριστικά, να ανοίξει δημόσιους συνδέσμους, να συνδέσει ή να αποσυνδέσει εφαρμογές ή να αλλάξει ρυθμίσεις διαχείρισης ή χρέωσης.

Έγκριση αλλαγών

Οι ενέργειες του προγράμματος-πελάτη ακολουθούν τους ίδιους κανόνες που ισχύουν παντού στο Dvina:

  • Η ανάγνωση γίνεται χωρίς να σας ζητηθεί έγκριση.
  • Η προσθήκη νέου στοιχείου, όπως μιας σημείωσης, ενός αρχείου μνήμης ή μιας εργασίας, γίνεται χωρίς να σας ζητηθεί έγκριση. Δεν αλλάζει ποτέ όσα υπάρχουν ήδη.
  • Η αλλαγή ή η αφαίρεση στοιχείου, όπως η μεταφορά ενός εγγράφου στον κάδο, η επανεγγραφή μιας σελίδας καμβά, η διακοπή μιας εργασίας ή η κοινή χρήση ενός στοιχείου, απαιτεί πρώτα την έγκρισή σας. Το πρόγραμμα-πελάτης εμφανίζει τη σύνοψη της αλλαγής που παρέχει το ίδιο το Dvina και εσείς την εγκρίνετε ή την απορρίπτετε. Αν την απορρίψετε, δεν αλλάζει τίποτα.

Σημείωση

Αν ένα πρόγραμμα-πελάτης δεν μπορεί να σας ζητήσει επιβεβαίωση, το Dvina δεν πραγματοποιεί την αλλαγή μέσω αυτού. Κάντε την αλλαγή στην εφαρμογή Dvina ή χρησιμοποιήστε ένα πρόγραμμα-πελάτης που μπορεί να σας ζητήσει επιβεβαίωση.

Η πρόσβασή σας και οι κανόνες της εταιρείας σας

Το πρόγραμμα-πελάτης ενεργεί εκ μέρους σας, με πρόσβαση σε όσα μπορείτε να δείτε και να κάνετε στο Dvina:

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

Σύνδεση με κλειδί API αντί για OAuth

Στο πρόγραμμα Enterprise, ένα πρόγραμμα-πελάτης μπορεί να συνδεθεί με ένα προσωπικό διακριτικό πρόσβασης αντί να κάνετε είσοδο. Χρησιμοποιήστε αυτή την επιλογή για ένα πρόγραμμα-πελάτης που δεν μπορεί να συνδεθεί μέσω OAuth ή για ένα script.

  1. Ανοίξτε τις Ρυθμίσεις και επιλέξτε Πρόσβαση API.
  2. Στην ενότητα Προσωπικά διακριτικά πρόσβασης, επιλέξτε Δημιουργία διακριτικού.
  3. Εισαγάγετε ένα Όνομα, επιλέξτε την Πρόσβαση και πότε Λήγει και, στη συνέχεια, επιλέξτε Δημιουργία διακριτικού.
  4. Στην ενότητα Αντιγραφή του διακριτικού σας, αντιγράψτε το διακριτικό. Αυτή είναι η μόνη φορά που εμφανίζεται.

Επιλέξτε την πρόσβαση που χρειάζεται το πρόγραμμα-πελάτης:

  • Μόνο ανάγνωση: το πρόγραμμα-πελάτης βλέπει μόνο τα εργαλεία ανάγνωσης. Μπορεί να κάνει αναζήτηση και να διαβάζει το περιεχόμενό σας στο Dvina, αλλά δεν μπορεί να προσθέσει ή να αλλάξει τίποτα.
  • Ανάγνωση και εγγραφή: το πρόγραμμα-πελάτης βλέπει όλα τα εργαλεία και οι αλλαγές εξακολουθούν να απαιτούν την έγκρισή σας, όπως και με το OAuth.

Στείλτε το διακριτικό στην κεφαλίδα Authorization, μετά το Bearer. Στο Claude Code, για παράδειγμα:

claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"

Σε άλλο πρόγραμμα-πελάτης, προσθέστε την ίδια κεφαλίδα στο σημείο όπου μπορείτε να ορίσετε κεφαλίδες για έναν διακομιστή MCP.

Το διακριτικό ενεργεί εκ μέρους σας, στον χώρο εργασίας όπου το δημιουργήσατε, με τον τρέχοντα ρόλο σας εκεί. Για να το αντικαταστήσετε, ανοίξτε το στην ενότητα Προσωπικά διακριτικά πρόσβασης και επιλέξτε Ανανέωση…: ένα νέο διακριτικό το αντικαθιστά και το παλιό σταματά να λειτουργεί αμέσως. Για να το απενεργοποιήσετε, επιλέξτε Ανάκληση…: οτιδήποτε το χρησιμοποιεί σταματά να λειτουργεί αμέσως.

Για περισσότερες πληροφορίες σχετικά με τα διακριτικά, δείτε την ενότητα Πρόσβαση API.