Lõpp-punkt ja autoriseerimine
POST https://teamwide.app/mcpLõpp-punkt nõuab OAuthi Bearer-tüüpi pääsutõendit. Autoriseerimisserveri leidmise teave on saadaval aadressil /.well-known/oauth-authorization-server. Ilma kehtiva Bearer-pääsutõendita päringud tagastavad olekukoodi 401.
Vaatamiseks taotlege õiguste ulatust read ja muutmiseks read write. Iga tööriist kontrollib nõutavat õiguste ulatust ning kehtivaid tööruumi ja tahvli kasutusõigusi. Kui olemasoleval pääsutõendil puudub nõutav ulatus, tuleb ühendus uuesti luua.
Saadaolevad tööriistad
Server pakub praegu tööruumide tuvastamist ja loendit, toiminguid tahvlite, kogumike, liikmete, konteinerite ja ühendusjoontega, tahvlite hetktõmmiseid ning PNG/PDF-eksporti. Andmeid muutvatele tööriistadele kehtivad samad konto-, tellimus- ja kasutusõiguste reeglid mis veebiliidesele.
Koostöö samal tahvlil
Mitu agenti saab töötada samal tahvlil korraga. Muudatused kuvatakse sisselogitud osalejatele reaalajas. Versioonide kontroll annab konfliktidest teada, selle asemel et muudatusi märkamatult üle kirjutada.
Lõuendi töövoog
Alustage tööriistadega whoami ja account_list, seejärel edastage valitud account_id tahvlitoimingutele. Kasutage explore_board lühiülevaate saamiseks ja get_containers valitud üksikasjade jaoks. Laadige get_canvas_guide üks kord, et tutvuda koordinaadireeglite, piirangute ja täielike näidetega.
Looge seotud objekte ja nooli tööriistaga apply_canvas_changes. Kui mõni toiming ebaõnnestub, võetakse kogu paketi kõik muudatused tagasi. Pärast ebaselget vastust kasutage uuesti sama päringu ID-d ja samu andmeid, et vältida objektide dubleerimist. Muutmisel edastage objekti uusim versioon; samaaegsed muudatused põhjustavad konflikti ja neid ei kirjutata üle.
Kasutage patch_container_content teksti täpseks asendamiseks, create_image_upload ja insert_uploaded_image kohalike piltide jaoks ning get_board_image saadud paigutuse kontrollimiseks. Tööriistade skeemid kirjeldavad lubatud väärtusi, väljundvorminguid ja lehekülgedeks jaotamise piiranguid.
Kui pildil on juba avalik URL, edastage see otsene URL parameetrina content tööriistale create_container koos väärtusega content_type: image. Server laadib faili alla ja lisab selle. MCP kaudu edastatakse ainult URL. Pildi asendamiseks kasutage update_container koos uue URL-iga; kohalikud failid laaditakse üles otse allkirjastatud URL-ile.
Klientrakenduse seadistamine
Seadistage https://teamwide.app/mcp MCP kaugligipääsu lõpp-punktiks klientrakenduses, mis toetab OAuthi autoriseerimisserveri tuvastamist ja PKCE-d. Andke Teamwide’is juurdepääsuluba. Kasutage tööruumi valimiseks account_list ja edastage selle account_id järgnevatele tahvlitoimingutele.