Διαχειριστείτε πίνακες από το API ή από έναν βοηθό τεχνητής νοημοσύνης

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

Το REST API

Κάθε λειτουργία περιλαμβάνεται στη δημόσια προδιαγραφή OpenAPI που διαθέτουμε, με δημιουργημένους πελάτες σε TypeScript, Python, PHP και Go, ενώ η διεπαφή γραμμής εντολών (CLI) παράγεται από την ίδια προδιαγραφή. Καλύπτονται πλήρως πίνακες, στήλες, κάρτες, σχόλια, ερωτήσεις, ετικέτες, μέλη και σύνδεσμοι κοινοποίησης.

Τα τελικά σημεία (endpoints) που θα χρησιμοποιήσετε περισσότερο:

• GET /v1/agency/boards — οι πίνακές σας
• GET /v1/agency/boards/{id} — ένας πίνακας με τις στήλες και τις κάρτες του
• POST /v1/agency/boards/{id}/cards — προσθήκη εργασίας
• POST /v1/agency/boards/{id}/cards/{id}/move — μετακίνηση εργασίας
• POST /v1/agency/boards/{id}/invites — δημιουργία συνδέσμου κοινοποίησης

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

Ο διακομιστής MCP

Εάν χρησιμοποιείτε έναν βοηθό τεχνητής νοημοσύνης που υποστηρίζει το MCP, συνδέστε τον και αποκτά απευθείας εργαλεία πινάκων: λίστα πινάκων, πλήρης ανάγνωση ενός πίνακα, δημιουργία πίνακα, προσθήκη κάρτας, μετακίνηση κάρτας, σχολιασμός, δημιουργία συνδέσμου κοινοποίησης και ανάκληση συνδέσμου. Αυτό μετατρέπει το "συνοψίστε την εβδομάδα και στείλτε έναν σύνδεσμο στην Acme" σε μία ενόργανη εντολή αντί για δύο συστήματα και αντιγραφή-επικόλληση.

Δύο πράγματα που αξίζει να γνωρίζετε σχετικά με τα εργαλεία:

• Μια νέα κάρτα είναι εσωτερική, εκτός εάν ορίσετε διαφορετικά. Ένας βοηθός που συνοψίζει την εσωτερική σας εργασία δεν πρέπει να δημοσιεύει αυτή τη σύνοψη στον πελάτη σας επειδή απλώς δεν του ζητήθηκε το αντίθετο, επομένως το πεδίο visibility ορίζεται από προεπιλογή σε εσωτερικό και πρέπει να ρυθμιστεί σε client εσκεμμένα.
• Η ανάκληση ενός συνδέσμου ζητά επιβεβαίωση, επειδή καταργεί επίσης οποιονδήποτε συμμετέχοντα συνδέθηκε μέσω αυτού του συνδέσμου — και το εργαλείο σάς ενημερώνει πόσα άτομα ήταν αυτά, αντί να αναφέρει απλώς μια τακτοποιημένη επιτυχία.

Τι απαιτείται

Η πρόσβαση σε API και MCP περιλαμβάνεται στα πακέτα Boards Business και σε κάθε πρόγραμμα φιλοξενίας Agency. Στα πακέτα Boards Free και Boards Pro, τα τελικά σημεία των πινάκων απαντούν με σχετικό μήνυμα.

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