Galinis taškas ir autorizavimas
POST https://teamwide.app/mcpGaliniam taškui reikalingas Bearer tipo OAuth prieigos raktas. Autorizavimo serverio aptikimo informacija pasiekiama adresu /.well-known/oauth-authorization-server. Užklausos be galiojančio Bearer prieigos rakto grąžina būsenos kodą 401.
Peržiūrai prašykite read, o redagavimui – read write teisių srities. Kiekvienas įrankis tikrina reikiamą teisių sritį ir esamas darbo srities bei lentos prieigos teises. Jei esamas prieigos raktas neturi reikiamos teisių srities, reikia iš naujo užmegzti ryšį.
Prieinami įrankiai
Serveris šiuo metu teikia darbo sričių identifikavimo ir sąrašo gavimo funkcijas, operacijas su lentomis, kolekcijomis, nariais, konteineriais ir jungtimis, lentų momentines kopijas bei eksportavimą į PNG/PDF. Duomenis keičiantiems įrankiams taikomos tos pačios paskyrų, prenumeratų ir prieigos teisių taisyklės kaip žiniatinklio sąsajai.
Bendras darbas lentoje
Keli agentai gali vienu metu dirbti vienoje lentoje. Prisijungę dalyviai pakeitimus mato realiuoju laiku. Versijų patikros praneša apie konfliktus, užuot nepastebimai perrašiusios pakeitimus.
Darbas drobėje
Pradėkite nuo whoami ir account_list, tada perduokite pasirinktą account_id lentos operacijoms. Naudokite explore_board glaustai apžvalgai ir get_containers pasirinktiems duomenims gauti. Vieną kartą įkelkite get_canvas_guide, kad susipažintumėte su koordinačių taisyklėmis, apribojimais ir išsamiais pavyzdžiais.
Kurkite susijusius objektus ir rodykles naudodami apply_canvas_changes. Jei kuri nors operacija nepavyksta, atšaukiami visi viso paketo pakeitimai. Gavę neaiškų atsakymą, pakartotinai naudokite tą patį užklausos ID ir tuos pačius duomenis, kad išvengtumėte objektų dubliavimo. Redaguodami perduokite naujausią objekto versiją; vienu metu atliekami pakeitimai sukelia konfliktą ir nėra perrašomi.
Naudokite patch_container_content tiksliam teksto pakeitimui, create_image_upload ir insert_uploaded_image vietiniams vaizdams, o get_board_image – gautam išdėstymui patikrinti. Įrankių schemose aprašomos priimtinos reikšmės, išvesties formatai ir skaidymo į puslapius apribojimai.
Jei vaizdas jau turi viešą URL, perduokite tą tiesioginį URL kaip content į create_container su content_type: image. Serveris paima ir prideda failą. Tik URL eina per MCP. Norėdami pakeisti vaizdą, naudokite update_container su nauju URL; vietiniai failai naudoja tiesioginį įkėlimą į pasirašytą URL.
Kliento programos konfigūravimas
Nustatykite https://teamwide.app/mcp kaip nuotolinį MCP galinį tašką kliento programoje, kuri palaiko OAuth autorizavimo serverio aptikimą ir PKCE. Suteikite prieigos leidimą Teamwide sistemoje. Naudodami account_list pasirinkite darbo sritį ir perduokite jos account_id tolesnėms lentų operacijoms.