Csatlakozás MCP-vel

Végpont és jogosultságkezelés

POST https://teamwide.app/mcp

A végponthoz Bearer típusú OAuth-token szükséges. Az engedélyezési kiszolgáló felderítéséhez szükséges információk a /.well-known/oauth-authorization-server címen érhetők el. Az érvényes Bearer-token nélküli kérésekre a kiszolgáló 401-es állapotkóddal válaszol.

Megtekintéshez a read, szerkesztéshez a read write hatókört kérje. Minden eszköz ellenőrzi a szükséges jogosultsági hatókört, valamint a munkaterületre és a táblára vonatkozó aktuális jogosultságokat. Ha egy meglévő token nem rendelkezik a szükséges hatókörrel, újra létre kell hozni a kapcsolatot.

Elérhető eszközök

A kiszolgáló jelenleg a munkaterületek azonosítását és listázását, a táblákhoz, gyűjteményekhez, tagokhoz, tárolókhoz és összekötőkhöz kapcsolódó műveleteket, táblapillanatképeket és PNG/PDF-exportálást kínál. Az adatokat módosító eszközökre ugyanazok a fiók-, előfizetési és jogosultsági szabályok vonatkoznak, mint a webes felületre.

Közös munka egy táblán

Több ügynök is dolgozhat egyszerre ugyanazon a táblán. A bejelentkezett résztvevők élőben látják a változásokat. A verzióellenőrzések jelzik az ütközéseket ahelyett, hogy észrevétlenül felülírnák a módosításokat.

Munka a vásznon

Kezdje a whoami és az account_list eszközzel, majd adja át a kiválasztott account_id értéket a táblaműveleteknek. Használja az explore_board eszközt a tömör áttekintéshez, a get_containers eszközt pedig a kiválasztott részletekhez. Töltse be egyszer a get_canvas_guide útmutatót a koordinátaszabályok, korlátok és teljes példák megismeréséhez.

Hozzon létre összetartozó objektumokat és nyilakat az apply_canvas_changes segítségével. Ha egy művelet sikertelen, a teljes köteg összes módosítása visszavonásra kerül. Bizonytalan válasz után ugyanazt a kérésazonosítót és ugyanazokat az adatokat használja újra, hogy elkerülje az objektumok megkettőzését. Szerkesztéskor adja át az objektum legújabb verzióját; az egyidejű módosítások ütközést okoznak, és nem íródnak felül.

Használja a patch_container_content-t a szöveg pontos cseréjéhez, a create_image_upload-t és a insert_uploaded_image-t a helyi képekhez, a get_board_image-t pedig a kapott elrendezés ellenőrzéséhez. Az eszközsémák leírják az elfogadott értékeket, a kimeneti formátumokat és a lapozási korlátokat.

Ha egy képnek már van nyilvános URL-je, ezt a közvetlen URL-t adja át content értékként a create_container eszköznek a content_type: image beállítással. A kiszolgáló letölti és csatolja a fájlt. Az MCP-n keresztül csak az URL továbbítódik. Kép cseréjéhez használja az update_container eszközt egy új URL-lel; a helyi fájlok közvetlenül az aláírt URL-re töltődnek fel.

Kliens beállítása

Állítsa be a https://teamwide.app/mcp címet távoli MCP-végpontként egy olyan kliensben, amely támogatja az OAuth-engedélyezési kiszolgálók felderítését és a PKCE-t. Engedélyezze a hozzáférést a Teamwide-ban. Az account_list eszközzel válasszon munkaterületet, majd adja át annak account_id értékét a későbbi táblaműveleteknek.