Koncový bod a autorizácia
POST https://teamwide.app/mcpKoncový bod vyžaduje token OAuth typu Bearer. Informácie na vyhľadanie autorizačného servera sú dostupné na adrese /.well-known/oauth-authorization-server. Požiadavky bez platného tokenu Bearer vracajú stav 401.
Vyžiadajte si rozsah read na prezeranie alebo read write na úpravy. Každý nástroj kontroluje požadovaný rozsah oprávnení a aktuálne oprávnenia k pracovnému priestoru a tabuli. Ak existujúci token nemá požadovaný rozsah, treba znova nadviazať spojenie.
Dostupné nástroje
Server momentálne poskytuje identifikáciu a zoznam pracovných priestorov, operácie s tabuľami, kolekciami, členmi, kontajnermi a konektormi, snímky tabúľ a export do PNG/PDF. Nástroje, ktoré menia údaje, sa riadia rovnakými pravidlami pre účty, predplatné a oprávnenia ako webové rozhranie.
Spoločná práca na tabuli
Viacerí agenti môžu súčasne pracovať na jednej tabuli. Zmeny sa prihláseným účastníkom zobrazujú v reálnom čase. Kontroly verzií hlásia konflikty namiesto tichého prepisovania zmien.
Práca na plátne
Začnite s whoami a account_list, potom odovzdajte vybrané account_id operáciám s tabuľou. Použite explore_board na stručný prehľad a get_containers na vybrané podrobnosti. Raz načítajte get_canvas_guide, kde nájdete pravidlá súradníc, obmedzenia a úplné príklady.
Vytvorte súvisiace objekty a šípky pomocou apply_canvas_changes. Ak niektorá operácia zlyhá, vrátia sa späť všetky zmeny v celej dávke. Po nejednoznačnej odpovedi znova použite rovnaké ID požiadavky a rovnaké údaje, aby ste zabránili vzniku duplicitných objektov. Pri úpravách odovzdajte najnovšiu verziu objektu; súbežné zmeny vyvolajú konflikt a nebudú prepísané.
Použite patch_container_content na presné nahradenie textu, create_image_upload a insert_uploaded_image na lokálne obrázky a get_board_image na kontrolu výsledného rozloženia. Schémy nástrojov popisujú akceptované hodnoty, výstupné formáty a limity stránkovania.
V prípade obrázka, ktorý už má verejnú adresu URL, odovzdajte túto priamu adresu URL ako content do create_container s content_type: image. Server načíta a pripojí súbor. Iba adresa URL prechádza cez MCP. Na nahradenie obrázka použite update_container s novou adresou URL; lokálne súbory používajú priame nahranie na podpísanú adresu URL.
Nastavenie klienta
Nastavte https://teamwide.app/mcp ako vzdialený koncový bod MCP v klientovi, ktorý podporuje zisťovanie autorizačného servera OAuth a PKCE. Povoľte prístup v Teamwide. Pomocou account_list vyberte pracovný priestor a odovzdajte jeho account_id nasledujúcim operáciám s tabuľami.