Endpoint u awtorizzazzjoni
POST https://teamwide.app/mcpL-endpoint jeħtieġ token OAuth tat-tip Bearer. L-informazzjoni biex jinstab is-server tal-awtorizzazzjoni hija disponibbli fuq /.well-known/oauth-authorization-server. Talbiet mingħajr token Bearer validu jirritornaw il-kodiċi tal-istatus 401.
Itlob l-ambitu read biex tara d-dejta jew read write biex teditjaha. Kull għodda tiċċekkja l-ambitu meħtieġ u l-permessi attwali għall-ispazju tax-xogħol u għall-whiteboard. Jekk token eżistenti ma jkollux l-ambitu meħtieġ, il-konnessjoni trid tiġi stabbilita mill-ġdid.
Għodod disponibbli
Is-server bħalissa jipprovdi l-identifikazzjoni u l-lista tal-ispazji tax-xogħol, operazzjonijiet fuq whiteboards, kollezzjonijiet, membri, kontenituri u konnetturi, ritratti tal-istat tal-whiteboards u esportazzjoni PNG/PDF. Għodod li jibdlu d-dejta jsegwu l-istess regoli għall-kontijiet, l-abbonamenti u l-permessi bħall-interface tal-web.
Ħidma flimkien fuq bord wieħed
Diversi aġenti jistgħu jaħdmu fuq bord wieħed fl-istess ħin. Il-bidliet jintwerew live lill-parteċipanti li jkunu illoggjati. Il-kontrolli tal-verżjonijiet jirrappurtaw kunflitti minflok jissostitwixxu bidliet mingħajr twissija.
Fluss tax-xogħol tal-kanvas
Ibda b'whoami u account_list, imbagħad għaddi l-valur magħżul ta' account_id lill-operazzjonijiet tal-whiteboard. Uża explore_board għal ħarsa ġenerali qasira u get_containers għal dettalji magħżula. Għabbi get_canvas_guide darba biex tara r-regoli tal-koordinati, il-limiti u l-eżempji kompluti.
Oħloq oġġetti u vleġeġ relatati billi tuża apply_canvas_changes. Jekk operazzjoni tfalli, jitreġġgħu lura l-bidliet kollha fil-lott kollu. Wara tweġiba inċerta, uża mill-ġdid l-istess ID tat-talba u l-istess dejta biex tevita oġġetti duplikati. Għall-editjar, għaddi l-aktar verżjoni reċenti tal-oġġett; bidliet simultanji jikkawżaw kunflitt u ma jinkitbux fuqhom.
Uża patch_container_content għal sostituzzjonijiet eżatti tat-test, create_image_upload u insert_uploaded_image għal stampi lokali, u get_board_image biex tispezzjona t-tqassim li jirriżulta. L-iskemi tal-għodda jiddeskrivu l-valuri aċċettati, il-formati tal-output u l-limiti tal-paġnar.
Għal immaġni li diġà għandha URL pubbliku, għaddi dak il-URL dirett bħala content lil create_container b'content_type: image. Is-server iniżżel u jehmeż il-fajl. Il-URL biss jintbagħat permezz ta' MCP. Uża update_container b'URL ġdid biex tissostitwixxi immaġni; fajls lokali jittellgħu direttament lejn il-URL iffirmat.
Konfigurazzjoni tal-klijent
Ikkonfigura https://teamwide.app/mcp bħala endpoint MCP remot f’klijent li jappoġġa l-iskoperta tas-server tal-awtorizzazzjoni OAuth u PKCE. Awtorizza l-aċċess f’Teamwide. Uża account_list biex tagħżel spazju tax-xogħol u għaddi l-account_id tiegħu lill-operazzjonijiet tal-bord li jmiss.