Αναφορά MCP

Τελικό σημείο και εξουσιοδότηση

POST https://teamwide.app/mcp
Authorization: Bearer <OAUTH_ACCESS_TOKEN>
Content-Type: application/json
Accept: application/json, text/event-stream
MCP-Protocol-Version: 2025-06-18

Το τελικό σημείο απαιτεί διακριτικό OAuth τύπου Bearer. Οι πληροφορίες εντοπισμού του διακομιστή εξουσιοδότησης είναι διαθέσιμες στη διεύθυνση /.well-known/oauth-authorization-server. Τα αιτήματα χωρίς έγκυρο διακριτικό Bearer επιστρέφουν κωδικό 401.

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

Εύρεση και κλήση εργαλείων

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-06-18",
    "capabilities": {},
    "clientInfo": {
      "name": "my-client",
      "version": "1.0.0"
    }
  }
}

{
  "jsonrpc": "2.0",
  "method": "notifications/initialized"
}

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list",
  "params": {}
}

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "account_list",
    "arguments": {}
  }
}

Ξεκινήστε με whoami και account_list και έπειτα μεταβιβάστε το επιλεγμένο account_id στις λειτουργίες του πίνακα. Χρησιμοποιήστε το explore_board για μια συνοπτική επισκόπηση και το get_containers για επιλεγμένες λεπτομέρειες. Φορτώστε το get_canvas_guide μία φορά για τους κανόνες συντεταγμένων, τα όρια και τα πλήρη παραδείγματα.

Αποτελέσματα και σφάλματα

Διαβάστε τα result.content και, όταν υπάρχει, result.structuredContent. Ελέγχετε το result.isError ακόμη και μετά από HTTP 200. Μη έγκυρα ορίσματα παράγουν σφάλματα JSON-RPC· τα δικαιώματα ελέγχονται σε κάθε κλήση.

Διαθέσιμα εργαλεία

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

account_listread