Endpoint și autorizare
POST https://teamwide.app/mcpEndpointul necesită un token OAuth de tip Bearer. Informațiile pentru descoperirea serverului de autorizare sunt disponibile la /.well-known/oauth-authorization-server. Solicitările fără un token Bearer valid returnează codul de stare 401.
Solicitați domeniul de acces read pentru vizualizare sau read write pentru editare. Fiecare instrument verifică domeniul necesar și permisiunile curente pentru spațiul de lucru și tablă. Dacă un token existent nu are domeniul necesar, conexiunea trebuie restabilită.
Instrumente disponibile
Serverul oferă în prezent identificarea și listarea spațiilor de lucru, operațiuni cu table, colecții, membri, containere și conectori, instantanee ale tablelor și export în PNG/PDF. Instrumentele care modifică date respectă aceleași reguli pentru conturi, abonamente și permisiuni ca interfața web.
Colaborare pe o tablă
Mai mulți agenți pot lucra simultan pe aceeași tablă. Modificările sunt afișate în timp real participanților autentificați. Verificările de versiune semnalează conflictele în loc să suprascrie modificările fără avertisment.
Lucrul pe suprafața de desen
Începeți cu whoami și account_list, apoi transmiteți valoarea account_id selectată operațiunilor cu tabla. Utilizați explore_board pentru o prezentare generală concisă și get_containers pentru detaliile selectate. Încărcați get_canvas_guide o singură dată pentru a consulta regulile de coordonate, limitele și exemplele complete.
Creați obiecte și săgeți asociate cu apply_canvas_changes. Dacă o operațiune eșuează, sunt anulate toate modificările din întregul lot. După un răspuns incert, reutilizați același ID de solicitare și aceleași date pentru a evita obiectele duplicate. Pentru editare, transmiteți cea mai recentă versiune a obiectului; modificările simultane provoacă un conflict și nu sunt suprascrise.
Utilizați patch_container_content pentru înlocuirea exactă a textului, create_image_upload și insert_uploaded_image pentru imagini locale și get_board_image pentru a inspecta aspectul rezultat. Schemele instrumentelor descriu valorile acceptate, formatele de ieșire și limitele de paginare.
Pentru o imagine care are deja o adresă URL publică, transmiteți acea adresă URL directă ca content la create_container cu content_type: image. Serverul preia și atașează fișierul. Doar adresa URL circulă prin MCP. Utilizați update_container cu o nouă adresă URL pentru a înlocui o imagine; fișierele locale folosesc o încărcare directă la adresa URL semnată.
Configurarea aplicației client
Configurați https://teamwide.app/mcp ca endpoint MCP la distanță într-un client care acceptă descoperirea serverelor de autorizare OAuth și PKCE. Autorizați accesul în Teamwide. Utilizați account_list pentru a selecta un spațiu de lucru și transmiteți valoarea account_id a acestuia operațiunilor ulterioare pe table.