Ändpunkt och auktorisering
POST https://teamwide.app/mcpÄndpunkten kräver en OAuth-token av typen Bearer. Information för att hitta auktoriseringsservern finns på /.well-known/oauth-authorization-server. Anrop utan en giltig Bearer-token returnerar status 401.
Begär behörighetsomfånget read för att läsa eller read write för att redigera. Varje verktyg kontrollerar det nödvändiga omfånget och de aktuella behörigheterna för arbetsytan och tavlan. Om en befintlig token saknar det nödvändiga omfånget måste anslutningen upprättas på nytt.
Tillgängliga verktyg
Servern erbjuder för närvarande identifiering och en lista över arbetsytor, åtgärder för tavlor, samlingar, medlemmar, behållare och kopplingslinjer, ögonblicksbilder av tavlor samt PNG/PDF-export. Verktyg som ändrar data följer samma regler för konton, prenumerationer och behörigheter som webbgränssnittet.
Samarbete på en tavla
Flera agenter kan arbeta på samma tavla samtidigt. Ändringar visas i realtid för inloggade deltagare. Versionskontroller rapporterar konflikter i stället för att skriva över ändringar utan förvarning.
Arbetsflöde på ritytan
Börja med whoami och account_list och skicka sedan det valda värdet för account_id till åtgärderna för tavlan. Använd explore_board för en kompakt översikt och get_containers för utvalda detaljer. Ladda get_canvas_guide en gång för att ta del av koordinatreglerna, begränsningarna och fullständiga exempel.
Skapa sammanhörande objekt och pilar med apply_canvas_changes. Om en åtgärd misslyckas återställs alla ändringar i hela batchen. Efter ett oklart svar ska du återanvända samma anrops-ID och samma data för att undvika dubbletter. Vid redigering ska du skicka den senaste objektversionen; samtidiga ändringar orsakar en konflikt i stället för att skrivas över.
Använd patch_container_content för exakta textersättningar, create_image_upload och insert_uploaded_image för lokala bilder och get_board_image för att granska den resulterande layouten. Verktygens scheman beskriver godkända värden, utdataformat och begränsningar för sidindelning.
För en bild som redan har en offentlig webbadress skickar du den direkta webbadressen som content till create_container med content_type: image. Servern hämtar och bifogar filen. Endast URL:en går genom MCP. Använd update_container med en ny URL för att ersätta en bild; lokala filer använder en direkt uppladdning till den signerade URL:en.
Klientkonfiguration
Ange https://teamwide.app/mcp som en extern MCP-ändpunkt i en klient som stöder automatisk identifiering av OAuth-auktoriseringsservern och PKCE. Godkänn åtkomsten i Teamwide. Använd account_list för att välja en arbetsyta och skicka dess account_id med efterföljande åtgärder på tavlor.