Endpunkt und Autorisierung
POST https://teamwide.app/mcpDer Endpunkt benötigt ein OAuth-Bearer-Token. Die Erkennung des Autorisierungsservers ist unter /.well-known/oauth-authorization-server verfügbar. Anfragen ohne gültiges Bearer-Token erhalten den Status 401.
Fordern Sie read zum Lesen oder read write zum Bearbeiten an. Jedes Werkzeug prüft den benötigten Berechtigungsumfang sowie die aktuellen Workspace- und Board-Rechte. Wenn einem bestehenden Token der benötigte Berechtigungsumfang fehlt, muss die Verbindung neu hergestellt werden.
Verfügbare Werkzeuge
Der Server bietet derzeit die Identifikation und Auflistung von Workspaces, Aktionen für Boards, Sammlungen, Mitglieder, Container und Verbindungen, Board-Momentaufnahmen sowie PNG-/PDF-Export. Werkzeuge, die Daten ändern, unterliegen denselben Konto-, Abo- und Berechtigungsregeln wie die Weboberfläche.
Gemeinsam auf einem Board arbeiten
Mehrere Agenten können gleichzeitig an einem Board arbeiten. Änderungen erscheinen live bei angemeldeten Teilnehmenden. Versionsprüfungen melden Konflikte, statt Änderungen stillschweigend zu überschreiben.
Arbeiten auf der Zeichenfläche
Beginnen Sie mit whoami und account_list und übergeben Sie anschließend die gewählte account_id an Board-Aktionen. Verwenden Sie explore_board für einen kompakten Überblick und get_containers für ausgewählte Details. Laden Sie get_canvas_guide einmal für Koordinatenregeln, Grenzen und vollständige Beispiele.
Erstellen Sie zusammengehörige Objekte und Pfeile mit apply_canvas_changes. Schlägt eine Aktion fehl, werden alle Änderungen des gesamten Stapels rückgängig gemacht. Verwenden Sie nach einer unklaren Antwort dieselbe Anfrage-ID und dieselben Anfragedaten erneut, um doppelte Objekte zu vermeiden. Übergeben Sie bei Änderungen die neueste Objektversion; gleichzeitige Änderungen führen zu einem Konflikt und werden nicht überschrieben.
Verwenden Sie patch_container_content für genaue Textersetzungen, create_image_upload und insert_uploaded_image für lokale Bilder sowie get_board_image, um das Ergebnis anzusehen. Die Werkzeugschemas beschreiben erlaubte Werte, Ausgabeformate und Grenzen der Paginierung.
Wenn ein Bild bereits eine öffentliche URL hat, übergeben Sie diese direkte URL als content an create_container mit content_type: image. Der Server lädt die Datei und hängt sie an. Nur die URL wird über MCP übertragen. Verwenden Sie update_container mit einer neuen URL, um ein Bild zu ersetzen; lokale Dateien werden direkt an die signierte URL hochgeladen.
Client einrichten
Richten Sie https://teamwide.app/mcp als Remote-MCP-Endpunkt in einem Client ein, der die Erkennung von OAuth-Autorisierungsservern und PKCE unterstützt. Autorisieren Sie den Zugriff in Teamwide. Wählen Sie mit account_list einen Workspace und übergeben Sie dessen account_id an nachfolgende Board-Aktionen.