Končna točka in avtorizacija
POST https://teamwide.app/mcpKončna točka zahteva žeton OAuth vrste Bearer. Podatki za odkrivanje avtorizacijskega strežnika so na voljo na /.well-known/oauth-authorization-server. Zahteve brez veljavnega žetona Bearer vrnejo stanje 401.
Zahtevajte obseg read za ogled ali read write za urejanje. Vsako orodje preveri zahtevani obseg dovoljenj ter trenutna dovoljenja za delovni prostor in tablo. Če obstoječi žeton nima zahtevanega obsega, je treba znova vzpostaviti povezavo.
Razpoložljiva orodja
Strežnik trenutno ponuja identifikacijo in seznam delovnih prostorov, operacije s tablami, zbirkami, člani, vsebniki in povezovalniki, posnetke tabel ter izvoz v PNG/PDF. Orodja, ki spreminjajo podatke, upoštevajo ista pravila za račune, naročnine in dovoljenja kot spletni vmesnik.
Skupno delo na tabli
Več agentov lahko hkrati dela na isti tabli. Spremembe se prijavljenim udeležencem prikazujejo v živo. Preverjanje različic opozori na konflikte, namesto da bi se spremembe neopazno prepisale.
Potek dela na platnu
Začnite z whoami in account_list, nato izbrani account_id posredujte operacijam s tablo. Uporabite explore_board za strnjen pregled in get_containers za izbrane podrobnosti. Enkrat naložite get_canvas_guide za pravila o koordinatah, omejitve in popolne primere.
Ustvarite povezane objekte in puščice z apply_canvas_changes. Če katera od operacij ne uspe, se razveljavijo vse spremembe v celotnem paketu. Po nejasnem odgovoru znova uporabite isti ID zahteve in iste podatke, da se izognete podvojenim objektom. Pri urejanju posredujte najnovejšo različico objekta; sočasne spremembe povzročijo spor in se ne prepišejo.
Uporabite patch_container_content za natančne zamenjave besedila, create_image_upload in insert_uploaded_image za lokalne slike in get_board_image za pregled nastale postavitve. Sheme orodij opisujejo sprejete vrednosti, izhodne formate in omejitve paginacije.
Za sliko, ki že ima javni URL, posredujte ta neposredni URL kot content do create_container z content_type: image. Strežnik pridobi in pripne datoteko. Skozi MCP potuje samo URL. Za zamenjavo slike uporabite update_container z novim URL-jem; lokalne datoteke uporabljajo neposredno nalaganje na podpisani URL.
Nastavitev odjemalca
Nastavite https://teamwide.app/mcp kot oddaljeno končno točko MCP v odjemalcu, ki podpira odkrivanje avtorizacijskega strežnika OAuth in PKCE. Odobrite dostop v Teamwide. Z account_list izberite delovni prostor in njegov account_id posredujte nadaljnjim operacijam s tablami.