Endpoint e autorizzazione
POST https://teamwide.app/mcpL'endpoint richiede un token OAuth di tipo Bearer. Le informazioni per individuare il server di autorizzazione sono disponibili all'indirizzo /.well-known/oauth-authorization-server. Le richieste senza un token Bearer valido restituiscono lo stato 401.
Richiedi l'ambito read per la consultazione o read write per la modifica. Ogni strumento verifica l'ambito richiesto e le autorizzazioni attuali per l'area di lavoro e la lavagna. Se un token esistente non dispone dell'ambito richiesto, occorre stabilire nuovamente la connessione.
Strumenti disponibili
Il server offre attualmente l'identificazione e l'elenco delle aree di lavoro, operazioni su lavagne, raccolte, membri, contenitori e connettori, istantanee delle lavagne ed esportazione in PNG/PDF. Gli strumenti che modificano i dati seguono le stesse regole relative ad account, abbonamenti e autorizzazioni dell'interfaccia web.
Lavorare insieme su una lavagna
Più agenti possono lavorare contemporaneamente sulla stessa lavagna. Le modifiche vengono mostrate in tempo reale ai partecipanti che hanno effettuato l’accesso. I controlli di versione segnalano i conflitti anziché sovrascrivere le modifiche senza avviso.
Lavorare sulla tela
Inizia con whoami e account_list, quindi passa il account_id selezionato alle operazioni sulla lavagna. Utilizza explore_board per una panoramica sintetica e get_containers per i dettagli selezionati. Carica get_canvas_guide una volta per consultare le regole delle coordinate, i limiti e gli esempi completi.
Crea oggetti e frecce correlati con apply_canvas_changes. Se un'operazione fallisce, vengono annullate tutte le modifiche dell'intero batch. Dopo una risposta incerta, riutilizza lo stesso ID della richiesta e gli stessi dati per evitare oggetti duplicati. Per le modifiche, passa la versione più recente dell'oggetto; le modifiche simultanee generano un conflitto invece di essere sovrascritte.
Utilizza patch_container_content per sostituzioni esatte del testo, create_image_upload e insert_uploaded_image per immagini locali e get_board_image per controllare il layout risultante. Gli schemi degli strumenti descrivono i valori accettati, i formati di output e i limiti di paginazione.
Per un'immagine che ha già un URL pubblico, passa l'URL diretto come content a create_container con content_type: image. Il server recupera e allega il file. Solo l'URL passa attraverso MCP. Utilizza update_container con un nuovo URL per sostituire un'immagine; i file locali utilizzano un caricamento diretto sull'URL firmato.
Configurazione del client
Configura https://teamwide.app/mcp come endpoint MCP remoto in un client che supporta il rilevamento dei server di autorizzazione OAuth e PKCE. Autorizza l’accesso in Teamwide. Utilizza account_list per selezionare un’area di lavoro e passa il relativo account_id alle successive operazioni sulle lavagne.