Eindpunt en autorisatie
POST https://teamwide.app/mcpHet eindpunt vereist een OAuth-bearertoken. Informatie voor het vinden van de autorisatieserver is beschikbaar op /.well-known/oauth-authorization-server. Verzoeken zonder geldig bearertoken geven status 401 terug.
Vraag de scope read aan om gegevens te bekijken of read write om ze te bewerken. Elke tool controleert de vereiste scope en de huidige rechten voor de werkruimte en het whiteboard. Als een bestaand token de vereiste scope mist, moet de verbinding opnieuw tot stand worden gebracht.
Beschikbare tools
De server biedt momenteel identificatie en een overzicht van werkruimten, bewerkingen voor whiteboards, collecties, leden, containers en verbindingslijnen, whiteboardsnapshots en PNG/PDF-export. Tools die gegevens wijzigen, volgen dezelfde regels voor accounts, abonnementen en rechten als de webinterface.
Samenwerken op een whiteboard
Meerdere agents kunnen tegelijk aan één whiteboard werken. Wijzigingen zijn live zichtbaar voor aangemelde deelnemers. Versiecontroles melden conflicten in plaats van wijzigingen ongemerkt te overschrijven.
Canvas-workflow
Begin met whoami en account_list en geef vervolgens de geselecteerde account_id door aan whiteboardbewerkingen. Gebruik explore_board voor een compact overzicht en get_containers voor geselecteerde details. Laad get_canvas_guide één keer voor de coördinaatregels, limieten en volledige voorbeelden.
Maak gerelateerde objecten en pijlen met apply_canvas_changes. Bij een mislukte bewerking wordt de volledige batch teruggedraaid. Gebruik dezelfde aanvraag-ID en payload opnieuw na een onzeker antwoord om dubbele objecten te voorkomen. Voor bewerkingen geeft u de nieuwste objectversie door; gelijktijdige wijzigingen veroorzaken een conflict in plaats van dat ze worden overschreven.
Gebruik patch_container_content voor exacte tekstvervangingen, create_image_upload en insert_uploaded_image voor lokale afbeeldingen, en get_board_image om de resulterende lay-out te inspecteren. Toolschema's beschrijven de geaccepteerde waarden, uitvoerformaten en pagineringslimieten.
Voor een afbeelding die al een openbare URL heeft, geeft u die directe URL door als content aan create_container met content_type: image. De server haalt het bestand op en voegt het toe. Alleen de URL reist door MCP. Gebruik update_container met een nieuwe URL om een afbeelding te vervangen; lokale bestanden gebruiken een directe upload naar de ondertekende URL.
Clientconfiguratie
Stel https://teamwide.app/mcp in als extern MCP-eindpunt in een client die detectie van OAuth-autorisatieservers en PKCE ondersteunt. Verleen toegang in Teamwide. Gebruik account_list om een werkruimte te kiezen en geef de bijbehorende account_id door aan volgende whiteboardbewerkingen.