Εργαλεία MCP
Το cc_server φιλοξενεί ένα μητρώο εργαλείων MCP (JSON-RPC 2.0), που εξυπηρετείται στην κύρια θύρα του διακομιστή (προεπιλογή 9030) στα POST /mcp και GET /sse, με έκδοση πρωτοκόλλου 2024-11-05. Κάθε πελάτης φτάνει στο ίδιο μητρώο: η εφαρμογή για υπολογιστή, η έκδοση για web, οι εξωτερικοί πελάτες MCP και ο ενσωματωμένος runtime πράκτορα. Εξωτερικοί διακομιστές MCP μπορούν να γεφυρωθούν στο ίδιο μητρώο ως δυναμικό επίπεδο.
Μέγεθος μητρώου
Ενότητα με τίτλο «Μέγεθος μητρώου»| Μέτρηση | Πλήθος |
|---|---|
Εργαλεία που καταχωρίζει το cc_server |
110 |
Από το packages/cc_mcp |
108 |
Από το packages/cc_mcp_client (ανακάλυψη εργαλείων) |
2 |
Καταχωρισμένα στο βασικό μητρώο (server_mcp_registry.dart) |
63 |
Καταχωρισμένα μετά την εκκίνηση, καθώς ενεργοποιούνται οι υπηρεσίες τους (cc_server_runtime.dart) |
47 |
| Από τα 63 του βασικού μητρώου, υπό συνθήκη ύπαρξης αποθετηρίου γραφήματος κώδικα | 5 |
Τα πέντε εργαλεία γραφήματος κώδικα καταχωρίζονται μόνο όταν ο ξενιστής περνά αποθετήριο γραφήματος κώδικα στο buildServerMcpRegistry. Το cc_server περνά πάντα ένα, οπότε και τα 110 είναι ενεργά στο δυαδικό που διανέμεται.
Το πλήρες μητρώο ανακοινώνεται στο tools/list χωρίς φραγή ανακάλυψης. Οι επεξεργασίες εισιτηρίων είναι τυποποιημένα εργαλεία.
Κοινές παράμετροι
Ενότητα με τίτλο «Κοινές παράμετροι»workspace_id
Ενότητα με τίτλο «workspace_id»Απαιτείται σε κάθε εργαλείο που αγγίζει δεδομένα εμβέλειας χώρου εργασίας. Ένα απόν ή μη έγκυρο workspace_id επιστρέφει ρητό σφάλμα, και μια τιμή που δεν ταιριάζει με τον χώρο εργασίας της οντότητας-στόχου απορρίπτεται αντί να αγνοηθεί σιωπηλά. Παραλείψτε το στα πραγματικά καθολικά εργαλεία: το list_workspaces και τα έξι εργαλεία ροής ειδήσεων (list_feeds, list_articles, get_article, set_article_read, set_article_saved, refresh_feeds), που βασίζονται στη λίστα ροών ανά χρήστη του ιδιοκτήτη του διακομιστή. Τα εργαλεία ανακάλυψης (search_tool_bm25, list_my_tools) το παίρνουν προαιρετικά, ώστε να μπορούν να χαρακτηρίσουν τη δυνατότητα κλήσης ανά λειτουργία συνομιλίας. Όταν ο διακομιστής αποστέλλει έναν πράκτορα, ο χώρος εργασίας επιβάλλεται στην πλευρά του διακομιστή, οπότε ο πράκτορας δεν μπορεί να φτάσει σε άλλον χώρο εργασίας περνώντας ένα ξένο id.
Ανακάλυψη εργαλείων
Ενότητα με τίτλο «Ανακάλυψη εργαλείων»Και τα δύο προέρχονται από το cc_mcp_client, όχι από το cc_mcp, και και τα δύο συμβουλεύονται τον φύλακα λειτουργίας, ώστε να αναφέρουν τι είναι καλούμενο στην τρέχουσα λειτουργία συνομιλίας.
| Εργαλείο | Περιγραφή |
|---|---|
search_tool_bm25 |
Αναζητά στον κατάλογο εργαλείων με λέξη-κλειδί· επιστρέφει τα εργαλεία που ταιριάζουν, τα σχήματα ορισμάτων τους και αν το καθένα είναι καλούμενο αυτή τη στιγμή |
list_my_tools |
Παραθέτει τα εργαλεία που είναι καλούμενα αυτή τη στιγμή σε αυτή τη συνομιλία, φιλτραρισμένα κατά τη λειτουργία της |
Ένα τρίτο εργαλείο ανακάλυψης, το search_tools, υπάρχει μόνο μέσα στον ενσωματωμένο μηχανισμό και δεν αποτελεί μέρος αυτού του μητρώου MCP. Κατατάσσει την επιφάνεια εργαλείων της ίδιας της εκτέλεσης και, σε αντίθεση με το search_tool_bm25, φορτώνει τα σχήματα όσων βρίσκει, ώστε ο πράκτορας να μπορεί να καλέσει ένα ταίριασμα στην επόμενη στροφή του. Οι πράκτορες στον μηχανισμό καλό είναι να το προτιμούν· οι πελάτες MCP έχουν το search_tool_bm25.
Εργαλεία πράκτορα
Ενότητα με τίτλο «Εργαλεία πράκτορα»| Εργαλείο | Περιγραφή |
|---|---|
list_agents |
Παραθέτει τους καταχωρισμένους πράκτορες σε έναν χώρο εργασίας |
Ανταλλαγή μηνυμάτων και ανάθεση μεταξύ ομότιμων πρακτόρων
Ενότητα με τίτλο «Ανταλλαγή μηνυμάτων και ανάθεση μεταξύ ομότιμων πρακτόρων»Οι πράκτορες μιλούν μεταξύ τους μέσω χώρων (διαρκών, ορατών στον κατάλογο συμμετεχόντων). Το ask_agent είναι ερώτηση/απάντηση με υποχρεωτικό χρονικό όριο· το delegate_task φυλάσσεται στην πλευρά του διακομιστή από ανώτατο όριο βάθους, ανίχνευση κύκλων, πλαίσιο προϋπολογισμού και ανώτατο όριο αυτονομίας.
| Εργαλείο | Περιγραφή |
|---|---|
send_to_agent |
Στέλνει μονόδρομο μήνυμα σε άλλον πράκτορα, με διεύθυνση μέσω to_agent_id ή ακριβούς to_agent_name |
ask_agent |
Ρωτά άλλον πράκτορα και περιμένει την απάντησή του ή λήγει ο χρόνος |
delegate_task |
Αναθέτει μια εργασία σε άλλον πράκτορα ως παρακολουθούμενο θυγατρικό εισιτήριο |
consult_agent |
Προσθέτει στον χώρο τον ειδικό που ταιριάζει καλύτερα με βάση τις δεξιότητες και τον αποστέλλει με μια εστιασμένη οδηγία |
todo_read |
Διαβάζει την αποθηκευμένη λίστα ελέγχου εργασιών αυτής της συνομιλίας |
Εργαλεία δεξιοτήτων
Ενότητα με τίτλο «Εργαλεία δεξιοτήτων»Κάθε εγκατάσταση και ενημέρωση περνά από πύλη σάρωσης με ασφαλή αποτυχία προτού φτάσει οποιοδήποτε περιεχόμενο δεξιότητας στον δίσκο ή σε προτροπή πράκτορα.
| Εργαλείο | Περιγραφή |
|---|---|
list_skills |
Παραθέτει τα slugs των δεξιοτήτων που είναι διαθέσιμα σε έναν χώρο εργασίας |
create_skill |
Δημιουργεί νέα δεξιότητα από περιεχόμενο markdown |
install_skill |
Εγκαθιστά ολόκληρο τον κατάλογο μιας δεξιότητας από αποθετήριο GitHub σε καρφιτσωμένη αναφορά |
update_skill |
Ενημερώνει μια εγκατεστημένη δεξιότητα GitHub σε νέα αναφορά, με νέα σάρωση και νέο καρφίτσωμα |
list_skill_updates |
Παραθέτει τις δεξιότητες για τις οποίες υπάρχει νεότερη έκδοση |
verify_skills |
Επαληθεύει τις κλειδωμένες δεξιότητες ως προς τους κατακερματισμούς περιεχομένου τους στον δίσκο |
pin_skill |
Κατακερματίζει μια υπάρχουσα δεξιότητα στον δίσκο στο skills-lock.json |
Εργαλεία σχεδίου, playbook και τεχνουργημάτων
Ενότητα με τίτλο «Εργαλεία σχεδίου, playbook και τεχνουργημάτων»| Εργαλείο | Περιγραφή |
|---|---|
submit_plan |
Το συμβόλαιο εξόδου της λειτουργίας σχεδίου: εκπέμπει ένα τυποποιημένο PlanDocument που ανοίγει στο Plan Studio |
create_playbook |
Αποθηκεύει ένα σχέδιο ως επώνυμο, εκδοσιακά διαχειριζόμενο πρότυπο με τυποποιημένα σύμβολα {{param}} |
run_playbook |
Δημιουργεί στιγμιότυπο ενός playbook με τιμές παραμέτρων, παράγοντας ένα σχέδιο που εγκρίνει ο χειριστής |
publish_artifact |
Δημοσιεύει μια διατεταγμένη λίστα τυποποιημένων μπλοκ (markdown, table, chart, mermaid, code, JSON) που αποδίδονται εγγενώς στον πελάτη |
revise_artifact |
Αντικαθιστά το περιεχόμενο ενός δημοσιευμένου τεχνουργήματος |
list_artifacts |
Παραθέτει τα τεχνουργήματα του χώρου εργασίας |
get_artifact |
Διαβάζει ένα τεχνούργημα |
complete_goal |
Δηλώνει ότι ο ενεργός διαρκής στόχος της συνομιλίας (που ξεκίνησε με /goal ή /loop) έχει επιτευχθεί |
Εργαλεία χώρου εργασίας
Ενότητα με τίτλο «Εργαλεία χώρου εργασίας»| Εργαλείο | Περιγραφή |
|---|---|
list_workspaces |
Παραθέτει όλους τους χώρους εργασίας με τα ids και τα ονόματά τους (καθολικό· χωρίς workspace_id) |
Εργαλεία αποθετηρίων
Ενότητα με τίτλο «Εργαλεία αποθετηρίων»| Εργαλείο | Περιγραφή |
|---|---|
list_repos |
Παραθέτει τα αποθετήρια που είναι καταχωρισμένα σε έναν χώρο εργασίας. Όσοι πράκτορες τα καλούν λαμβάνουν τις απομονωμένες διαδρομές worktree copy-on-write της συνομιλίας τους, ποτέ τα αρχικά checkout |
Εργαλεία μηνυμάτων
Ενότητα με τίτλο «Εργαλεία μηνυμάτων»| Εργαλείο | Περιγραφή |
|---|---|
list_spaces |
Παραθέτει τους χώρους μηνυμάτων σε έναν χώρο εργασίας |
get_messages |
Ανακτά μηνύματα από έναν χώρο |
send_message |
Στέλνει μήνυμα σε έναν χώρο ως επώνυμος πράκτορας αποστολέας |
get_space_notes |
Διαβάζει το κοινόχρηστο έγγραφο παράδοσης ενός χώρου |
update_space_notes |
Αντικαθιστά το κοινόχρηστο έγγραφο παράδοσης ενός χώρου |
todo_write |
Αντικαθιστά τη λίστα ελέγχου εργασιών αυτής της συνομιλίας σε μία κλήση (περάστε ολόκληρη τη λίστα) |
Εργαλεία ελέγχου
Ενότητα με τίτλο «Εργαλεία ελέγχου»| Εργαλείο | Περιγραφή |
|---|---|
start_ai_review |
Ξεκινά τον έλεγχο με AI για ένα PR: υπολογίζει τις περιοχές ελέγχου, διασπείρει εξειδικευμένους ελεγκτές στον χώρο του PR, συντάσσει την καθοδηγούμενη περιήγηση και οριστικοποιεί |
add_review_node |
Προσθέτει ένα δομημένο εύρημα ελέγχου (αρχείο, γραμμή, προτεραιότητα P0–P3) σε έναν χώρο ελέγχου |
confirm_review_node |
Επιβεβαιώνει το εύρημα ενός ομότιμου· ο συντάκτης δεν μπορεί να αυτοεπιβεβαιωθεί |
resolve_review_node |
Σημειώνει ένα εύρημα ως διορθωμένο αφού όντως γίνει η αλλαγή· αναρτά ένα ίχνος στον χώρο ελέγχου |
dismiss_review_node |
Απορρίπτει ένα εύρημα που δεν εφαρμόζεται· καταγράφει ένα γεγονός καταστολής, ώστε οι ελεγκτές να σταματήσουν να το επισημαίνουν ξανά |
request_peer_review |
Ζητά από άλλον πράκτορα ελεγκτή μια δεύτερη ματιά σε ένα εύρημα |
dispatch_reviewers |
Αποστέλλει τους πράκτορες ελεγκτές που ταιριάζουν σε έναν χώρο ελέγχου, ταυτόχρονα |
submit_reviewer_verdict |
Αναρτά ετυμηγορία ship/hold/block ανά ελεγκτή με βεβαιότητα και εξήγηση |
finalize_review |
Υπολογίζει τη συναίνεση ανά κόμβο και την ετυμηγορία ανά PR και κλείνει τον έλεγχο |
set_cohort_summary |
Ορίζει τη σύνοψη σε απλή γλώσσα μιας κοόρτας ελέγχου |
add_review_diagram |
Επισυνάπτει ένα δομημένο, επαληθευμένο από το γράφημα διάγραμμα (sequence, entityRelation, stateMachine) σε μια κοόρτα |
publish_review_to_github |
Δημοσιεύει τον οριστικοποιημένο έλεγχο στο GitHub ως ενσωματωμένα σχόλια συν ένα σώμα σύνοψης |
Εργαλεία μνήμης
Ενότητα με τίτλο «Εργαλεία μνήμης»| Εργαλείο | Περιγραφή |
|---|---|
search_memory |
Αναζητά γεγονότα και πολιτικές (λέξη-κλειδί, σημασιολογική ή υβριδική — η υβριδική είναι η προεπιλογή) |
propose_fact |
Αποθηκεύει ένα σύντομο γεγονός markdown σε έναν τομέα |
supersede_fact |
Σημειώνει ένα γεγονός ως αντικατασταθέν από άλλο |
propose_policy |
Αποθηκεύει έναν κανονιστικό κανόνα σε έναν τομέα (απαιτεί δικαίωμα εγγραφής σε αυτόν) |
supersede_policy |
Αποσύρει μια πολιτική — τη σημειώνει ως ανενεργή διατηρώντας την για έλεγχο |
list_policies |
Παραθέτει τις ενεργές πολιτικές, προαιρετικά φιλτραρισμένες κατά τομέα |
list_memory_domains |
Παραθέτει τους τομείς μνήμης του χώρου εργασίας με πλήθη γεγονότων και πολιτικών |
record_observation |
Καταγράφει μια ακατέργαστη παρατήρηση στη μνήμη εργασίας του πράκτορα |
get_my_notes |
Διαβάζει το πρόχειρο μνήμης εργασίας του καλούντος πράκτορα |
update_my_notes |
Ενημερώνει το πρόχειρο μνήμης εργασίας του καλούντος πράκτορα |
remember |
Προσθέτει μια σημείωση στη θερμή μνήμη εργασίας του πράκτορα για αυτή τη συνεδρία (με όρια TTL και πλήθους) |
consolidate_memory |
Εκτελεί ένα πέρασμα συγκέντρωσης («ύπνου»): εκδιώκει τα ληγμένα θερμά στοιχεία, κυλά τα διαρκή σε μακροπρόθεσμα γεγονότα |
harmonize_memory |
Εκτελεί εναρμόνιση πεποιθήσεων μεταξύ πρακτόρων (SHMR) και επισημαίνει αντιφάσεις |
list_memory_conflicts |
Παραθέτει τις ανιχνευμένες αντιφάσεις και το πώς επιλύθηκε καθεμιά |
Εργαλεία διακυβέρνησης
Ενότητα με τίτλο «Εργαλεία διακυβέρνησης»| Εργαλείο | Περιγραφή |
|---|---|
create_goal |
Δημιουργεί οργανωτικό στόχο (επίπεδο εταιρείας, ομάδας, πράκτορα ή εργασίας) |
list_goals |
Παραθέτει στόχους με επίπεδο, κατάσταση και συγκεντρωτική πρόοδο |
update_goal_progress |
Ορίζει την πρόοδο ενός στόχου |
create_approval |
Ανοίγει έγκριση διακυβέρνησης για ελεγχόμενη ενέργεια (έξοδος σχεδίου, συγχώνευση, κυκλοφορία, πρόσληψη, προσαρμοσμένη) |
list_approvals |
Παραθέτει εγκρίσεις, προαιρετικά φιλτραρισμένες κατά κατάσταση |
decide_approval |
Καταγράφει μια απόφαση: έγκριση, απόρριψη, αίτημα αναθεώρησης ή νέα υποβολή |
comment_approval |
Σχολιάζει μια έγκριση διακυβέρνησης |
exit_plan_mode |
Ανοίγει (και, μόλις εγκριθεί, καταναλώνει) μια έγκριση plan_exit, βγάζοντας τη συνομιλία από τη λειτουργία σχεδίου |
agent_heartbeat |
Αναφέρει ζωτικότητα (ζωντανός, αδρανής, κολλημένος)· η σιωπή μετατρέπει την υγεία του runtime σε recently-lost και μετά σε offline |
list_runtime_health |
Παραθέτει την υγεία του runtime κάθε πράκτορα |
list_agent_presence |
Παραθέτει την παρουσία κάθε πράκτορα (υγεία, κύκλος ζωής, πλήθη σε εκτέλεση και σε ουρά, χωρητικότητα) |
get_org_chart |
Διαβάζει το δέντρο αναφορών, με τον CEO στη ρίζα, ένθετο κατά reports_to |
create_work_product |
Δημιουργεί ένα διαρκές παραδοτέο συνδεδεμένο με εισιτήριο |
save_work_product_revision |
Αποθηκεύει νέα αναθεώρηση· περάστε base_revision_id για να απορριφθείτε σε ταυτόχρονη επεξεργασία |
list_work_products |
Παραθέτει προϊόντα εργασίας, προαιρετικά φιλτραρισμένα σε ένα εισιτήριο |
get_work_product |
Διαβάζει ένα προϊόν εργασίας με το ιστορικό αναθεωρήσεών του |
create_runtime_profile |
Ορίζει ένα επαναχρησιμοποιήσιμο προφίλ runtime (οικογένεια πρωτοκόλλου, εντολή CLI, σταθερά ορίσματα εκκίνησης) |
list_runtime_profiles |
Παραθέτει τα προφίλ runtime του χώρου εργασίας |
Εργαλεία γραφήματος κώδικα
Ενότητα με τίτλο «Εργαλεία γραφήματος κώδικα»Καταχωρίζονται μόνο όταν ο ξενιστής παρέχει αποθετήριο γραφήματος κώδικα. Το ευρετήριο καλύπτει το σύνολο γραμματικών που διανέμεται (Dart, JS/TS, PHP, Python, Rust, Zig, C/C++, Go, Java, Ruby, C#, Swift, Kotlin, R, Assembly, MATLAB, Ada)· σύμβολα σε οποιαδήποτε άλλη γλώσσα δεν υπάρχουν.
| Εργαλείο | Περιγραφή |
|---|---|
search_code |
Αναζητά στα ευρετηριασμένα σύμβολα κατά όνομα, υπογραφή και σχόλιο τεκμηρίωσης (υβριδική BM25 + σημασιολογική) |
code_symbol |
Αναζητά σύμβολα κατά ακριβές όνομα· επιστρέφει file:line και υπογραφή |
code_callers |
Παραθέτει τα σύμβολα που καλούν ή εξαρτώνται από ένα σύμβολο (εισερχόμενες ακμές) |
code_callees |
Παραθέτει τα σύμβολα που καλεί ή από τα οποία εξαρτάται ένα σύμβολο (εξερχόμενες ακμές) |
code_impact |
Υπολογίζει τη μεταβατική ακτίνα επίπτωσης ενός συμβόλου, μέχρι ένα βάθος |
Εργαλεία εισιτηρίων
Ενότητα με τίτλο «Εργαλεία εισιτηρίων»| Εργαλείο | Περιγραφή |
|---|---|
create_ticket |
Δημιουργεί εισιτήριο στον διαμορφωμένο πάροχο |
get_ticket |
Ανακτά ένα εισιτήριο κατά id |
list_tickets |
Παραθέτει εισιτήρια, προαιρετικά φιλτραρισμένα κατά κατάσταση ή ανατεθειμένο |
update_ticket |
Ενημερώνει κατάσταση, τίτλο, περιγραφή, προτεραιότητα ή ετικέτες (η κατάσταση δέχεται ψευδώνυμα όπως in_progress / completed) |
assign_ticket |
Αναθέτει ένα εισιτήριο σε πράκτορα ή/και ομάδα |
reassign_ticket |
Αναθέτει ξανά ένα εισιτήριο σε διαφορετικό πράκτορα |
add_ticket_collaborator |
Προσκαλεί έναν πράκτορα να συνεργαστεί σε ένα εισιτήριο (προστίθεται στον χώρο του) |
comment_on_ticket |
Σχολιάζει ένα εισιτήριο |
close_ticket |
Κλείνει ένα εισιτήριο (το σημειώνει ως ολοκληρωμένο) με προαιρετική έξοδο |
fail_ticket |
Σημειώνει ένα εισιτήριο ως αποτυχημένο με μήνυμα σφάλματος |
delegate_ticket |
Αναθέτει ένα εισιτήριο σε πράκτορα, δημιουργώντας παρακολουθούμενο εισιτήριο |
ticket_pr_link |
Συνδέει ή αποσυνδέει ένα εισιτήριο και ένα pull request με το αναγνωριστικό κόμβου του PR (action: link | unlink) |
ticket_relation |
Προσθέτει ή αφαιρεί σχέση μεταξύ δύο εισιτηρίων — blocked_by, blocking, related_to, duplicate_of, duplicated_by, sub_issue_of, parent_of (action: add | remove) |
list_ticket_relations |
Παραθέτει τον γονικό, τα υποεισιτήρια και τους συνδέσμους εξάρτησης ενός εισιτηρίου |
Εργαλεία ομάδας και pipeline
Ενότητα με τίτλο «Εργαλεία ομάδας και pipeline»| Εργαλείο | Περιγραφή |
|---|---|
record_team_activity |
Καταγράφει μια καταχώριση δραστηριότητας του επικεφαλής ομάδας σε ένα εισιτήριο |
preview_trigger |
Δοκιμαστική εκτέλεση του ποιες εκτελέσεις pipeline θα ξεκινούσε ένα υποθετικό συμβάν, χωρίς να δεσμεύσει τίποτα |
submit_output |
Υποβάλλει το δομημένο φορτίο εξόδου για την τρέχουσα εκτέλεση pipeline του καλούντος· επικυρώνεται ως προς το δηλωμένο σχήμα εξόδου της εκτέλεσης |
Εργαλεία ενορχήστρωσης
Ενότητα με τίτλο «Εργαλεία ενορχήστρωσης»| Εργαλείο | Περιγραφή |
|---|---|
propose_orchestration |
Εκπέμπει ένα δομημένο σχέδιο ενορχήστρωσης πολλών πρακτόρων για μία εκ των προτέρων έγκριση· επικυρώνει και επιστρέφει τυχόν παραβάσεις |
Εργαλεία ροής ειδήσεων
Ενότητα με τίτλο «Εργαλεία ροής ειδήσεων»| Εργαλείο | Περιγραφή |
|---|---|
list_feeds |
Παραθέτει τις καταχωρισμένες ροές RSS/Atom |
list_articles |
Παραθέτει άρθρα, προαιρετικά φιλτραρισμένα κατά ροή, μη αναγνωσμένα ή αποθηκευμένα |
get_article |
Ανακτά ένα άρθρο |
set_article_read |
Σημειώνει ένα άρθρο ως αναγνωσμένο ή μη αναγνωσμένο |
set_article_saved |
Αποθηκεύει ή αφαιρεί από τα αποθηκευμένα ένα άρθρο |
refresh_feeds |
Ανακτά ξανά τώρα κάθε ενεργοποιημένη ροή |
Εργαλεία περιβλήματος (σταθμών)
Ενότητα με τίτλο «Εργαλεία περιβλήματος (σταθμών)»Οδηγήστε αναλώσιμες μηχανές — ένα περίκλειστο πρόγραμμα περιήγησης ή επιφάνεια
εργασίας Linux, έναν εξομοιωτή Android ή έναν Προσομοιωτή iOS — μέσα από μια
εκτέλεση. Καταχωρίζονται μετά την εκκίνηση, άνευ όρων: το αν μια μηχανή μπορεί
όντος να εκκινήσει είναι ερώτημα ανίχνευσης που τα εργαλεία απαντούν ανά κλήση.
Επαναλαμβανόμενες κλήσεις σε μία συνομιλία επαναχρησιμοποιούν μία μηχανή· τα
στιγμιότυπα οθόνης επιστρέφουν ως περιεχόμενο εικόνας με προϋπολογισμό μίας
εικόνας ανά αποτέλεσμα, και το εξαγόμενο περιεχόμενο σελίδας/UI περιφράσσεται ως
μη αξιόπιστα δεδομένα. Τα τέσσερα εργαλεία χρήσης συν το rig_close δηλώνουν το
enclosureControl ως κλάση ενεργειών
(τα εργαλεία χρήσης δηλώνουν επίσης networkEgress και processSpawn· τα
mobile_use και ios_use δηλώνουν επίσης packageInstall), οπότε οι λειτουργίες
μόνο για ανάγνωση τα αρνούνται. Το rig_list δεν δηλώνει καμία — διαβάζει μόνο
την κατάσταση του χώρου εργασίας. Το πλήρες λεξιλόγιο ρημάτων ανά επιφάνεια
βρίσκεται στην αναφορά σταθμών.
| Εργαλείο | Περιγραφή |
|---|---|
computer_use |
Οδηγεί μια επιφάνεια εργασίας Linux σε περίκλειστη VM: μετακίνηση, κλικ, σύρσιμο, κύλιση, πληκτρολόγηση, αλλαγή μεγέθους, πρόχειρο, στιγμιότυπο οθόνης |
browser_use |
Οδηγεί ένα headless Chromium, Firefox ή WebKit (engine): πλοήγηση, κλικ, συμπλήρωση, εξαγωγή (a11y/DOM/κονσόλα), πρόχειρο, στιγμιότυπο οθόνης |
mobile_use |
Οδηγεί το Android μέσω ADB: επιθεώρηση/είσοδος, στιγμιότυπα οθόνης, εγκατάσταση/εκκίνηση/διακοπή/επαναφορά/απεγκατάσταση εφαρμογών, βαθείς σύνδεσμοι και εντολές συσκευής σε μορφή argv |
ios_use |
Οδηγεί τον Προσομοιωτή iOS μέσω WebDriverAgent/CoreSimulator: επιθεώρηση/είσοδος, στιγμιότυπα οθόνης, εγκατάσταση/εκκίνηση/διακοπή/απεγκατάσταση εφαρμογών, βαθείς σύνδεσμοι και διεργασίες προσομοιωτή σε μορφή argv |
rig_list |
Παραθέτει τους σταθμούς ενός χώρου εργασίας με επιφάνεια, κατάσταση, μέγεθος οθόνης και ελεγκτή |
rig_close |
Καταστρέφει έναν σταθμό και απορρίπτει την κατάσταση της μηχανής που του ανήκει |
Όσα δεν εκτίθενται μέσω MCP
Ενότητα με τίτλο «Όσα δεν εκτίθενται μέσω MCP»Το ημερολόγιο και οι συσκέψεις δεν έχουν εργαλεία MCP. Οι πράκτορες δεν μπορούν να διαβάσουν το ημερολόγιό σας, τις συσκέψεις, τις απομαγνητοφωνήσεις, τα στοιχεία ενέργειας ή τις αποφάσεις σας. Η σύνοψη που παράγει στοιχεία ενέργειας και αποφάσεις εκτελείται ως το ενσωματωμένο pipeline meeting_summary, όχι ως εργαλείο που μπορεί να καλέσει ένας πράκτορας.
Περιορισμός εργαλείων ανά λειτουργία
Ενότητα με τίτλο «Περιορισμός εργαλείων ανά λειτουργία»Ο περιορισμός επιβάλλεται δύο φορές από έναν πίνακα (ModeToolPolicy): μία στον αποστολέα MCP για τον προσαρμογέα Claude Code και μία στο μητρώο του ενσωματωμένου μηχανισμού. Μια αποκλεισμένη κλήση επιστρέφει τον λόγο.
| Λειτουργία | Επιφάνεια εργαλείων |
|---|---|
chat |
Κάθε καταχωρισμένο εργαλείο· χωρίς λίστα επιτρεπόμενων |
plan |
Μια επιμελημένη λίστα επιτρεπόμενων. Χωρίς εγγραφές στο worktree και χωρίς τα ρήματα εισιτηρίων create / assign / delegate, αλλά επιτρέπονται η μνήμη, τα τεχνουργήματα, οι λίστες εργασιών, το submit_plan, το exit_plan_mode και τα ρήματα ολοκλήρωσης εισιτηρίου στο εισιτήριο που έχει αποσταλεί |
review |
Μια επιμελημένη λίστα επιτρεπόμενων: συμμετοχή σε έλεγχο, επικοινωνία, ανακτήσεις πλαισίου μόνο για ανάγνωση και το πλήρες σύνολο ρημάτων εισιτηρίων, συμπεριλαμβανομένων των create_ticket και assign_ticket |
orchestrate |
Μια επιμελημένη λίστα επιτρεπόμενων: εργαλεία έρευνας και ανάγνωσης συν τα propose_orchestration, create_playbook και run_playbook. Η πρόσληψη, η αποσύνθεση και η ολοκλήρωση εισιτηρίων συμβαίνουν ντετερμινιστικά μετά την έγκριση, ποτέ στη μέση της εκτέλεσης |
Επιτρέπονται σε κάθε λειτουργία ανεξάρτητα από τη λίστα επιτρεπόμενων:
| Σύνολο | Εργαλεία |
|---|---|
| Μνήμη και τεχνουργήματα | search_memory, propose_fact, propose_policy, supersede_fact, supersede_policy, record_observation, update_my_notes, get_my_notes, list_memory_domains, list_policies, publish_artifact, revise_artifact, list_artifacts, get_artifact |
| Γράφημα κώδικα | search_code, code_symbol, code_callers, code_callees, code_impact |
| Μηχανική εκτέλεσης | search_tool_bm25, list_my_tools, todo_write, todo_read |
Το να βρίσκεται ένα εργαλείο σε λίστα επιτρεπόμενων δεν το κάνει καλούμενο, και ισχύει και το αντίστροφο: η δυνατότητα υποβολής ερώτησης στον χειριστή είναι εργαλείο του μηχανισμού (ask_user), οπότε δεν εμφανίζεται καθόλου σε αυτόν τον κατάλογο MCP.
Εργαλεία με πύλη έγκρισης
Ενότητα με τίτλο «Εργαλεία με πύλη έγκρισης»Ένα εργαλείο μπορεί να δηλώνει requiresApproval. Τότε ο αποστολέας χτίζει ένα ApprovalPayload και το προβάλλει μέσω του ConfirmationPort πριν εκτελεστεί το εργαλείο· το cc_server συνδέει αυτή τη θύρα, οπότε η πύλη είναι ενεργή.
Τα καταχωρισμένα εργαλεία που το δηλώνουν: create_ticket, update_ticket, assign_ticket, reassign_ticket, close_ticket, ticket_relation, create_goal, update_goal_progress, create_approval, decide_approval, comment_approval, create_work_product, save_work_product_revision, create_runtime_profile, install_skill, update_skill.
Ανεξάρτητα, οι ενοποιημένοι περιορισμοί ενεργειών βάζουν σε πύλη κάθε εργαλείο που δηλώνει μη κενό σύνολο ActionClass. Μια απόφαση prompt χωρίς συνδεδεμένο εγκρίνοντα απορρίπτεται. Δείτε Περιορισμοί.
Δυνατότητες χωρίς εργαλείο πίσω τους
Ενότητα με τίτλο «Δυνατότητες χωρίς εργαλείο πίσω τους»Δεν είναι κάθε δυνατότητα του προϊόντος προσβάσιμη από πράκτορα. Αυτές δεν έχουν καθόλου εργαλείο, οπότε ένα όνομα που ίσως έχετε δει να αναφέρεται αλλού επιστρέφει «άγνωστο εργαλείο»:
| Δυνατότητα | Πού ζει αντ’ αυτού |
|---|---|
| Πρόσληψη, απόλυση ή επεξεργασία πράκτορα | Το UI των πρακτόρων. Δεν υπάρχει εργαλείο hire_agent / fire_agent / update_agent |
| Δημιουργία χώρου εργασίας | workspace.upsert μέσω RPC, που αρχικοποιεί και σφραγίζει την κυριότητα |
| Έργα (δημιουργία / λίστα / ενημέρωση / καταχώριση) | Το UI των εισιτηρίων. Τα έργα είναι επιφάνεια χειριστή — δείτε Οργάνωση εργασίας με έργα |
| Υποβολή αποκλειστικής ερώτησης στον χειριστή | Το εργαλείο ask_user του μηχανισμού, όχι το MCP. Αποδίδει μια φόρμα στη συνομιλία και μπλοκάρει μέχρι την απάντηση |
| Διαγνωστικά ανά πράκτορα | Τίποτα. Δεν υπάρχει doctor — δείτε Διάγνωση πράκτορα |
| Ημερολόγιο και συσκέψεις | RPC μόνο για ανθρώπινους πελάτες (δείτε παραπάνω) |