Point de terminaison et autorisation
POST https://teamwide.app/mcpLe point de terminaison nécessite un jeton OAuth de type Bearer. Les informations de découverte du serveur d'autorisation sont disponibles à l'adresse /.well-known/oauth-authorization-server. Les requêtes sans jeton Bearer valide renvoient le statut 401.
Demandez la portée read pour consulter ou read write pour modifier. Chaque outil vérifie la portée requise et les autorisations actuelles sur l'espace de travail et le tableau blanc. Si un jeton existant ne dispose pas de la portée requise, il faut établir une nouvelle connexion.
Outils disponibles
Le serveur propose actuellement l'identification et la liste des espaces de travail, des opérations sur les tableaux blancs, collections, membres, conteneurs et connecteurs, des instantanés de tableaux blancs et l'exportation PNG/PDF. Les outils qui modifient les données suivent les mêmes règles de compte, d'abonnement et d'autorisation que l'interface web.
Travailler ensemble sur un tableau blanc
Plusieurs agents peuvent travailler en même temps sur un tableau blanc. Les modifications s’affichent en direct pour les participants connectés. Les vérifications de version signalent les conflits au lieu d’écraser les modifications sans avertissement.
Travail sur le canevas
Commencez par whoami et account_list, puis transmettez le account_id sélectionné aux opérations sur le tableau blanc. Utilisez explore_board pour une vue d'ensemble concise et get_containers pour obtenir les détails souhaités. Chargez get_canvas_guide une fois pour consulter les règles de coordonnées, les limites et les exemples complets.
Créez des objets et des flèches associés avec apply_canvas_changes. Si une opération échoue, toutes les modifications du lot sont annulées. Après une réponse incertaine, réutilisez le même identifiant de requête et les mêmes données pour éviter les doublons. Pour les modifications, transmettez la version la plus récente de l'objet ; les modifications simultanées produisent un conflit au lieu d'être écrasées.
Utilisez patch_container_content pour les remplacements de texte exacts, create_image_upload et insert_uploaded_image pour les images locales et get_board_image pour inspecter la mise en page résultante. Les schémas d'outils décrivent les valeurs acceptées, les formats de sortie et les limites de pagination.
Pour une image qui possède déjà une URL publique, transmettez cette URL directe comme content à create_container avec content_type: image. Le serveur récupère et joint le fichier. Seule l'URL transite par MCP. Utilisez update_container avec une nouvelle URL pour remplacer une image ; les fichiers locaux sont téléversés directement vers l'URL signée.
Configuration du client
Configurez https://teamwide.app/mcp comme point de terminaison MCP distant dans un client prenant en charge la découverte des serveurs d’autorisation OAuth et PKCE. Autorisez l’accès dans Teamwide. Utilisez account_list pour sélectionner un espace de travail et transmettez son account_id aux opérations suivantes sur les tableaux blancs.