Galapunkts un autorizācija
POST https://teamwide.app/mcpGalapunktam ir nepieciešams Bearer tipa OAuth piekļuves marķieris. Informācija autorizācijas servera atrašanai ir pieejama adresē /.well-known/oauth-authorization-server. Pieprasījumi bez derīga Bearer marķiera atgriež statusa kodu 401.
Apskatei pieprasiet tvērumu read, bet rediģēšanai – read write. Katrs rīks pārbauda nepieciešamo tiesību tvērumu un pašreizējās darbvietas un tāfeles piekļuves tiesības. Ja esošajam marķierim nav nepieciešamā tvēruma, savienojums jāizveido no jauna.
Pieejamie rīki
Serveris pašlaik nodrošina darbvietu identificēšanu un saraksta iegūšanu, darbības ar tāfelēm, kolekcijām, dalībniekiem, konteineriem un savienotājiem, tāfeļu momentuzņēmumus un eksportēšanu PNG/PDF formātā. Rīkiem, kas maina datus, ir spēkā tie paši kontu, abonementu un piekļuves tiesību noteikumi kā tīmekļa saskarnei.
Kopīgs darbs tāfelē
Vairāki aģenti var vienlaikus strādāt vienā tāfelē. Izmaiņas tiek rādītas reāllaikā dalībniekiem, kuri ir pieteikušies. Versiju pārbaudes ziņo par konfliktiem, nevis nemanāmi pārraksta izmaiņas.
Darbs uz audekla
Sāciet ar whoami un account_list, pēc tam nododiet atlasīto account_id tāfeles darbībām. Izmantojiet explore_board, lai iegūtu kompaktu pārskatu, un get_containers atlasītajai informācijai. Vienreiz ielādējiet get_canvas_guide, lai redzētu koordinātu noteikumus, ierobežojumus un pilnīgus piemērus.
Izveidojiet saistītus objektus un bultiņas ar apply_canvas_changes. Ja kāda darbība neizdodas, tiek atceltas visas pakotnē veiktās izmaiņas. Pēc neskaidras atbildes atkārtoti izmantojiet to pašu pieprasījuma ID un tos pašus datus, lai izvairītos no objektu dublikātiem. Rediģējot nododiet jaunāko objekta versiju; vienlaicīgas izmaiņas izraisa konfliktu un netiek pārrakstītas.
Izmantojiet patch_container_content precīzai teksta aizstāšanai, create_image_upload un insert_uploaded_image lokāliem attēliem un get_board_image, lai pārbaudītu iegūto izkārtojumu. Rīku shēmās aprakstītas pieļaujamās vērtības, izvades formāti un dalīšanas lapās ierobežojumi.
Attēlam, kuram jau ir publisks URL, nosūtiet šo tiešo URL kā content uz create_container ar content_type: image. Serveris ienes un pievieno failu. Tikai URL virzās caur MCP. Izmantojiet update_container ar jaunu URL, lai aizstātu attēlu; vietējie faili izmanto tiešu augšupielādi uz parakstīto URL.
Klientprogrammas iestatīšana
Iestatiet https://teamwide.app/mcp kā attālu MCP galapunktu klientprogrammā, kas atbalsta OAuth autorizācijas servera atrašanu un PKCE. Apstipriniet piekļuvi Teamwide vidē. Izmantojiet account_list, lai izvēlētos darbvietu, un nododiet tās account_id turpmākajām darbībām ar tāfelēm.