Endpoint og autorisation
POST https://teamwide.app/mcpEndpointet kræver et OAuth-bearertoken. Oplysninger til at finde autorisationsserveren er tilgængelige på /.well-known/oauth-authorization-server. Anmodninger uden et gyldigt bearertoken returnerer status 401.
Anmod om scopet read til visning eller read write til redigering. Hvert værktøj kontrollerer det krævede scope og de aktuelle rettigheder til arbejdsområdet og tavlen. Hvis et eksisterende token mangler det krævede scope, skal forbindelsen oprettes igen.
Tilgængelige værktøjer
Serveren tilbyder i øjeblikket identifikation og en liste over arbejdsområder, handlinger for tavler, samlinger, medlemmer, containere og forbindelseslinjer, øjebliksbilleder af tavler samt PNG/PDF-eksport. Værktøjer, der ændrer data, følger de samme regler for konti, abonnementer og rettigheder som webgrænsefladen.
Arbejd sammen på én tavle
Flere agenter kan arbejde på én tavle samtidig. Ændringer vises live for deltagere, der er logget ind. Versionskontroller melder konflikter i stedet for at overskrive ændringer uden varsel.
Arbejdsgang på lærredet
Start med whoami og account_list, og send derefter det valgte account_id til tavlehandlingerne. Brug explore_board til en kompakt oversigt og get_containers til udvalgte detaljer. Indlæs get_canvas_guide én gang for at få koordinatregler, begrænsninger og komplette eksempler.
Opret sammenhørende objekter og pile med apply_canvas_changes. Hvis en handling mislykkes, fortrydes alle ændringer i hele batchen. Efter et uklart svar skal du genbruge det samme anmodnings-id og de samme data for at undgå dubletter. Ved redigering skal du sende den nyeste objektversion; samtidige ændringer medfører en konflikt i stedet for at blive overskrevet.
Brug patch_container_content til nøjagtige teksterstatninger, create_image_upload og insert_uploaded_image til lokale billeder og get_board_image til at inspicere det resulterende layout. Værktøjsskemaer beskriver de accepterede værdier, outputformater og pagineringsgrænser.
For et billede, der allerede har en offentlig URL, skal du videregive den direkte URL som content til create_container med content_type: image. Serveren henter og vedhæfter filen. Kun URL'en går gennem MCP. Brug update_container med en ny URL til at erstatte et billede; lokale filer bruger en direkte upload til den signerede URL.
Klientopsætning
Konfigurer https://teamwide.app/mcp som et eksternt MCP-endpoint i en klient, der understøtter discovery af OAuth-autorisationsserveren og PKCE. Godkend adgangen i Teamwide. Brug account_list til at vælge et arbejdsområde, og send dets account_id med i de efterfølgende tavlehandlinger.