Koncový bod a autorizace
POST https://teamwide.app/mcpKoncový bod vyžaduje token OAuth typu Bearer. Informace pro vyhledání autorizačního serveru jsou dostupné na adrese /.well-known/oauth-authorization-server. Požadavky bez platného tokenu Bearer vracejí stav 401.
Vyžádejte si rozsah read pro prohlížení nebo read write pro úpravy. Každý nástroj kontroluje požadovaný rozsah oprávnění a aktuální oprávnění k pracovnímu prostoru a tabuli. Pokud stávající token nemá požadovaný rozsah, je nutné znovu navázat spojení.
Dostupné nástroje
Server aktuálně nabízí identifikaci a výpis pracovních prostorů, operace s tabulemi, kolekcemi, členy, kontejnery a konektory, snímky tabulí a export do PNG/PDF. Nástroje, které mění data, se řídí stejnými pravidly pro účty, předplatné a oprávnění jako webové rozhraní.
Společná práce na jedné tabuli
Na jedné tabuli může pracovat více agentů současně. Změny se přihlášeným účastníkům zobrazují živě. Kontroly verzí hlásí konflikty místo tichého přepisování změn.
Práce na plátně
Začněte s whoami a account_list, poté předejte vybrané account_id operacím s tabulí. Použijte explore_board pro stručný přehled a get_containers pro vybrané podrobnosti. Jednou načtěte get_canvas_guide, kde najdete pravidla souřadnic, omezení a úplné příklady.
Vytvářejte související objekty a šipky pomocí apply_canvas_changes. Pokud některá operace selže, vrátí se zpět všechny změny v celé dávce. Po nejednoznačné odpovědi znovu použijte stejné ID požadavku a stejná data, abyste zabránili vzniku duplicitních objektů. Při úpravách předejte nejnovější verzi objektu; souběžné změny vyvolají konflikt a nebudou přepsány.
Použijte patch_container_content pro přesné nahrazení textu, create_image_upload a insert_uploaded_image pro místní obrázky a get_board_image pro kontrolu výsledného rozvržení. Schémata nástrojů popisují akceptované hodnoty, výstupní formáty a limity stránkování.
U obrázku, který již má veřejnou adresu URL, předejte tuto přímou adresu URL jako content do create_container s content_type: image. Server načte a připojí soubor. Pouze adresa URL prochází MCP. K nahrazení obrázku použijte update_container s novou URL; místní soubory používají přímé nahrávání na podepsanou adresu URL.
Nastavení klienta
Nastavte https://teamwide.app/mcp jako vzdálený koncový bod MCP v klientu, který podporuje vyhledání autorizačního serveru OAuth a PKCE. Povolte přístup v Teamwide. Pomocí account_list vyberte pracovní prostor a jeho account_id předávejte dalším operacím s tabulemi.