Päätepiste ja valtuutus
POST https://teamwide.app/mcpPäätepiste edellyttää Bearer-tyyppistä OAuth-käyttöoikeustunnistetta. Valtuutuspalvelimen löytämiseen tarvittavat tiedot ovat osoitteessa /.well-known/oauth-authorization-server. Pyynnöt, joissa ei ole kelvollista Bearer-tunnistetta, palauttavat tilakoodin 401.
Pyydä käyttöoikeusalue read katselua varten tai read write muokkausta varten. Jokainen työkalu tarkistaa vaaditun käyttöoikeusalueen sekä työtilan ja taulun nykyiset käyttöoikeudet. Jos olemassa olevasta tunnisteesta puuttuu vaadittu käyttöoikeusalue, yhteys on muodostettava uudelleen.
Käytettävissä olevat työkalut
Palvelin tarjoaa tällä hetkellä työtilojen tunnistamisen ja luetteloinnin, tauluihin, kokoelmiin, jäseniin, säilöihin ja yhdysviivoihin liittyvät toiminnot, taulujen tilannekuvat sekä PNG/PDF-viennin. Tietoja muuttavat työkalut noudattavat samoja tili-, tilaus- ja käyttöoikeussääntöjä kuin verkkokäyttöliittymä.
Yhteistyö samalla taululla
Useat agentit voivat työskennellä samalla taululla yhtä aikaa. Muutokset näkyvät kirjautuneille osallistujille reaaliajassa. Versiotarkistukset ilmoittavat ristiriidoista sen sijaan, että muutokset korvattaisiin huomaamatta.
Työskentely piirtoalueella
Aloita työkaluilla whoami ja account_list ja välitä sitten valittu account_id taulutoiminnoille. Käytä työkalua explore_board tiiviiseen yleiskatsaukseen ja työkalua get_containers valittujen yksityiskohtien hakemiseen. Lataa get_canvas_guide kerran, jotta saat koordinaattisäännöt, rajoitukset ja täydelliset esimerkit.
Luo toisiinsa liittyviä objekteja ja nuolia työkalulla apply_canvas_changes. Jos jokin toiminto epäonnistuu, koko erän kaikki muutokset perutaan. Käytä epäselvän vastauksen jälkeen uudelleen samaa pyynnön tunnistetta ja samoja tietoja, jotta objekteja ei synny kahteen kertaan. Välitä muokkauksissa objektin uusin versio; samanaikaiset muutokset aiheuttavat ristiriidan eikä niitä korvata.
Käytä työkalua patch_container_content tekstin täsmälliseen korvaamiseen, työkaluja create_image_upload ja insert_uploaded_image paikallisiin kuviin sekä työkalua get_board_image syntyneen asettelun tarkastamiseen. Työkalujen skeemat kuvaavat hyväksytyt arvot, tulosten muodot ja sivutuksen rajoitukset.
Jos kuvalla on jo julkinen URL-osoite, välitä suora osoite parametrina content työkalulle create_container käyttäen asetusta content_type: image. Palvelin hakee ja liittää tiedoston. Vain URL-osoite siirtyy MCP:n kautta. Käytä työkalua update_container uuden URL-osoitteen kanssa kuvan korvaamiseen; paikalliset tiedostot ladataan suoraan allekirjoitettuun URL-osoitteeseen.
Asiakasohjelman määritys
Määritä https://teamwide.app/mcp MCP-etäpäätepisteeksi asiakasohjelmassa, joka tukee OAuth-valtuutuspalvelimen automaattista löytämistä ja PKCE:tä. Valtuuta käyttö Teamwidessa. Valitse työtila työkalulla account_list ja välitä sen account_id seuraaville taulutoiminnoille.