Punkt końcowy i autoryzacja
POST https://teamwide.app/mcpPunkt końcowy wymaga tokena OAuth typu Bearer. Informacje umożliwiające wykrycie serwera autoryzacji są dostępne pod adresem /.well-known/oauth-authorization-server. Żądania bez prawidłowego tokena Bearer zwracają status 401.
Zażądaj zakresu read do przeglądania lub read write do edycji. Każde narzędzie sprawdza wymagany zakres uprawnień oraz bieżące uprawnienia do obszaru roboczego i tablicy. Jeśli istniejący token nie ma wymaganego zakresu, trzeba ponownie nawiązać połączenie.
Dostępne narzędzia
Serwer udostępnia obecnie identyfikację i listę obszarów roboczych, operacje na tablicach, kolekcjach, członkach, kontenerach i łącznikach, migawki tablic oraz eksport do PNG/PDF. Narzędzia modyfikujące dane podlegają tym samym zasadom dotyczącym kont, subskrypcji i uprawnień co interfejs internetowy.
Wspólna praca na tablicy
Wielu agentów może jednocześnie pracować na tej samej tablicy. Zalogowani uczestnicy widzą zmiany na żywo. Kontrole wersji zgłaszają konflikty zamiast nadpisywać zmiany bez powiadomienia.
Praca na płótnie
Zacznij od whoami i account_list, a następnie przekaż wybrane account_id do operacji na tablicy. Użyj explore_board, aby uzyskać zwięzły przegląd, i get_containers, aby pobrać wybrane szczegóły. Jednorazowo wczytaj get_canvas_guide, aby poznać zasady dotyczące współrzędnych, ograniczenia i pełne przykłady.
Twórz powiązane obiekty i strzałki za pomocą apply_canvas_changes. Jeśli jedna operacja się nie powiedzie, wycofywane są wszystkie zmiany w całej partii. Po niejednoznacznej odpowiedzi użyj ponownie tego samego identyfikatora żądania i tych samych danych, aby uniknąć duplikatów obiektów. Przy edycji przekaż najnowszą wersję obiektu; równoczesne zmiany powodują konflikt i nie są nadpisywane.
Użyj patch_container_content do dokładnego zastąpienia tekstu, create_image_upload i insert_uploaded_image do obrazów lokalnych oraz get_board_image do sprawdzenia powstałego układu. Schematy narzędzi opisują akceptowane wartości, formaty wyjściowe i ograniczenia paginacji.
W przypadku obrazu, który ma już publiczny adres URL, przekaż ten bezpośredni adres URL jako content do create_container z content_type: image. Serwer pobiera i dołącza plik. Tylko adres URL przechodzi przez MCP. Użyj update_container z nowym adresem URL, aby zastąpić obraz; pliki lokalne korzystają z bezpośredniego przesyłania na podpisany adres URL.
Konfiguracja klienta
Skonfiguruj https://teamwide.app/mcp jako zdalny punkt końcowy MCP w kliencie obsługującym wykrywanie serwerów autoryzacji OAuth i PKCE. Autoryzuj dostęp w Teamwide. Użyj account_list do wybrania obszaru roboczego i przekaż jego account_id do kolejnych operacji na tablicach.