Крайна точка и оторизация
POST https://teamwide.app/mcpКрайната точка изисква OAuth токен от тип Bearer. Откриването на сървъра за оторизация е достъпно на адрес /.well-known/oauth-authorization-server. Заявките без валиден Bearer токен връщат статус 401.
Поискайте обхват read за преглед или read write за редактиране. Всеки инструмент проверява необходимия обхват на правата и текущите разрешения за работното пространство и дъската. Ако съществуващ токен няма необходимия обхват, връзката трябва да бъде установена отново.
Налични инструменти
Сървърът предоставя идентификация и списък на работните пространства, операции с дъски, колекции, членове, контейнери и конектори, моментни снимки на дъски и експортиране в PNG/PDF. Инструментите, които променят данни, спазват същите правила за акаунта, абонамента и разрешенията като уеб интерфейса.
Съвместна работа по едно табло
Няколко агента могат да работят едновременно по едно табло. Промените се показват на живо на участниците, които са влезли в профила си. Проверките на версиите съобщават за конфликти, вместо да презаписват промените без предупреждение.
Работа върху платното
Започнете с whoami и account_list, след което подайте избрания account_id на операциите с дъски. Използвайте explore_board за кратък преглед и get_containers за избрани подробности. Заредете get_canvas_guide веднъж, за да получите правилата за координатите, ограниченията и пълните примери.
Създайте свързани обекти и стрелки с apply_canvas_changes. При неуспешна операция се отменят всички промени от целия пакет. След неясен отговор използвайте отново същия идентификатор на заявката и същите данни, за да избегнете дублиране на обекти. При редактиране подайте най-новата версия на обекта; едновременните промени водят до конфликт, вместо да бъдат презаписани.
Използвайте patch_container_content за точни замени на текст, create_image_upload и insert_uploaded_image за локални изображения и get_board_image, за да проверите полученото оформление. Схемите на инструментите описват допустимите стойности, изходните формати и ограниченията при странициране.
За изображение, което вече има публичен URL адрес, предайте този директен URL като content към create_container с content_type: image. Сървърът извлича и прикачва файла. Само URL преминава през MCP. Използвайте update_container с нов URL адрес, за да замените изображение; локалните файлове използват директно качване към подписания URL адрес.
Настройване на клиентското приложение
Настройте https://teamwide.app/mcp като отдалечена MCP крайна точка в клиентско приложение, което поддържа откриване на OAuth сървъри за оторизация и PKCE. Разрешете достъпа в Teamwide. Изберете работно пространство с account_list и предайте неговия account_id при следващите операции с табла.