Krajnja točka i autorizacija
POST https://teamwide.app/mcpKrajnja točka zahtijeva OAuth token vrste Bearer. Podaci za otkrivanje autorizacijskog poslužitelja dostupni su na /.well-known/oauth-authorization-server. Zahtjevi bez valjanog tokena Bearer vraćaju status 401.
Zatražite opseg read za pregled ili read write za uređivanje. Svaki alat provjerava potreban opseg ovlasti i trenutačna dopuštenja za radni prostor i ploču. Ako postojeći token nema potreban opseg, potrebno je ponovno uspostaviti vezu.
Dostupni alati
Poslužitelj trenutačno nudi identifikaciju i popis radnih prostora, operacije s pločama, zbirkama, članovima, spremnicima i spojnicama, snimke ploča te izvoz u PNG/PDF. Alati koji mijenjaju podatke slijede ista pravila za račune, pretplate i dopuštenja kao web-sučelje.
Zajednički rad na ploči
Više agenata može istodobno raditi na jednoj ploči. Promjene se prijavljenim sudionicima prikazuju uživo. Provjere verzija prijavljuju sukobe umjesto da se promjene neprimjetno prepišu.
Tijek rada na platnu
Započnite s whoami i account_list, zatim proslijedite odabrani account_id operacijama s pločom. Koristite explore_board za sažeti pregled i get_containers za odabrane detalje. Jednom učitajte get_canvas_guide za pravila o koordinatama, ograničenja i potpune primjere.
Stvorite povezane objekte i strelice s apply_canvas_changes. Ako neka operacija ne uspije, poništavaju se sve promjene u cijeloj skupini. Nakon nejasnog odgovora ponovno upotrijebite isti ID zahtjeva i iste podatke kako biste izbjegli dupliciranje objekata. Pri uređivanju proslijedite najnoviju verziju objekta; istodobne promjene uzrokuju sukob umjesto da budu prebrisane.
Koristite patch_container_content za točne zamjene teksta, create_image_upload i insert_uploaded_image za lokalne slike i get_board_image za pregled dobivenog izgleda. Sheme alata opisuju prihvaćene vrijednosti, izlazne formate i ograničenja paginacije.
Za sliku koja već ima javni URL, proslijedite taj izravni URL kao content do create_container s content_type: image. Poslužitelj dohvaća i prilaže datoteku. Samo URL putuje kroz MCP. Koristite update_container s novim URL-om za zamjenu slike; lokalne datoteke koriste izravan prijenos na potpisani URL.
Postavljanje klijentske aplikacije
Postavite https://teamwide.app/mcp kao udaljenu MCP krajnju točku u klijentskoj aplikaciji koja podržava otkrivanje OAuth autorizacijskog poslužitelja i PKCE. Odobrite pristup u Teamwideu. Upotrijebite account_list za odabir radnog prostora i proslijedite njegov account_id sljedećim operacijama na pločama.