Τελικό σημείο και εξουσιοδότηση
POST https://teamwide.app/mcpΤο τελικό σημείο απαιτεί διακριτικό OAuth τύπου Bearer. Οι πληροφορίες εντοπισμού του διακομιστή εξουσιοδότησης είναι διαθέσιμες στη διεύθυνση /.well-known/oauth-authorization-server. Τα αιτήματα χωρίς έγκυρο διακριτικό Bearer επιστρέφουν κωδικό 401.
Ζητήστε το πεδίο δικαιωμάτων read για προβολή ή read write για επεξεργασία. Κάθε εργαλείο ελέγχει το απαιτούμενο πεδίο δικαιωμάτων και τα τρέχοντα δικαιώματα στον χώρο εργασίας και στον πίνακα. Αν ένα υπάρχον διακριτικό δεν έχει το απαιτούμενο πεδίο δικαιωμάτων, χρειάζεται νέα σύνδεση.
Διαθέσιμα εργαλεία
Ο διακομιστής παρέχει προς το παρόν αναγνώριση και λίστα χώρων εργασίας, λειτουργίες για πίνακες, συλλογές, μέλη, περιέκτες και συνδέσμους, στιγμιότυπα πινάκων και εξαγωγή σε PNG/PDF. Τα εργαλεία που τροποποιούν δεδομένα ακολουθούν τους ίδιους κανόνες λογαριασμού, συνδρομής και δικαιωμάτων με τη διαδικτυακή διεπαφή.
Συνεργασία στον ίδιο πίνακα
Πολλοί πράκτορες μπορούν να εργάζονται ταυτόχρονα στον ίδιο πίνακα. Οι αλλαγές εμφανίζονται ζωντανά στους συμμετέχοντες που έχουν συνδεθεί. Οι έλεγχοι εκδόσεων αναφέρουν συγκρούσεις αντί να αντικαθιστούν αλλαγές χωρίς ειδοποίηση.
Ροή εργασίας καμβά
Ξεκινήστε με whoami και account_list και έπειτα μεταβιβάστε το επιλεγμένο account_id στις λειτουργίες του πίνακα. Χρησιμοποιήστε το explore_board για μια συνοπτική επισκόπηση και το get_containers για επιλεγμένες λεπτομέρειες. Φορτώστε το get_canvas_guide μία φορά για τους κανόνες συντεταγμένων, τα όρια και τα πλήρη παραδείγματα.
Δημιουργήστε συναφή αντικείμενα και βέλη με το apply_canvas_changes. Αν αποτύχει μια λειτουργία, αναιρούνται όλες οι αλλαγές ολόκληρης της παρτίδας. Μετά από μια ασαφή απόκριση, χρησιμοποιήστε ξανά το ίδιο αναγνωριστικό και το ίδιο περιεχόμενο αιτήματος, ώστε να αποφύγετε διπλότυπα αντικείμενα. Για επεξεργασία, μεταβιβάστε την πιο πρόσφατη έκδοση του αντικειμένου· οι ταυτόχρονες αλλαγές προκαλούν σύγκρουση αντί να αντικαθίστανται.
Χρησιμοποιήστε patch_container_content για ακριβείς αντικαταστάσεις κειμένου, create_image_upload και insert_uploaded_image για τοπικές εικόνες και get_board_image για να επιθεωρήσετε τη διάταξη που προκύπτει. Τα σχήματα εργαλείων περιγράφουν τις αποδεκτές τιμές, τις μορφές εξόδου και τα όρια σελιδοποίησης.
Για μια εικόνα που έχει ήδη δημόσια διεύθυνση URL, περάστε αυτήν την άμεση διεύθυνση URL ως content σε create_container με content_type: image. Ο διακομιστής ανακτά και επισυνάπτει το αρχείο. Μόνο η διεύθυνση URL ταξιδεύει μέσω MCP. Χρησιμοποιήστε το update_container με μια νέα διεύθυνση URL για να αντικαταστήσετε μια εικόνα. Τα τοπικά αρχεία χρησιμοποιούν απευθείας μεταφόρτωση στην υπογεγραμμένη διεύθυνση URL.
Ρύθμιση εφαρμογής πελάτη
Ρυθμίστε το https://teamwide.app/mcp ως απομακρυσμένο τελικό σημείο MCP σε εφαρμογή πελάτη που υποστηρίζει εντοπισμό διακομιστή εξουσιοδότησης OAuth και PKCE. Εγκρίνετε την πρόσβαση στο Teamwide. Επιλέξτε έναν χώρο εργασίας με το account_list και διαβιβάστε το account_id του στις επόμενες λειτουργίες του πίνακα.