Serwer MCP Miro (przewodnik administratora)

Kto może to zrobić: administratorzy firmy i administratorzy zespołu w abonamentach Enterprise

Jako administrator firmy w subskrypcji Enterprise kontrolujesz, czy Miro MCP Server jest dostępny dla Twojej organizacji. To ustawienie decyduje o tym, czy Twoje zespoły mogą korzystać z integracji AI łączących się z Miro.

Użyj Miro MCP (Model Context Protocol), aby połączyć swoje tablice Miro z narzędziami AI zgodnymi z MCP. Po włączeniu i autoryzacji asystenci AI mogą odczytywać kontekst z konkretnych tablic i (tam, gdzie to dozwolone) wykonywać działania, takie jak streszczanie treści lub tworzenie diagramów za pomocą wyselekcjonowanego zestawu narzędzi Miro MCP. Ten przewodnik wyjaśnia wymagania wstępne, sposób włączenia, zasady zarządzania oraz rozwiązywanie problemów.

Zanim zaczniesz

• Włącz dla całej organizacji lub tylko dla wybranych zespołów (uprawnienia na poziomie tablicy nadal obowiązują).

Włączanie i wyłączanie Serwera MCP

Aby włączyć Serwer MCP:

1. Przejdź do Ustawienia administratora > Aplikacje i integracje > MCP.
2. Wybierz zakres.
   1. Organizacja: Każdy użytkownik w Twojej organizacji może autoryzować MCP dla tablic, do których już ma dostęp.
   2. Wybrane zespoły: Tylko użytkownicy z tych zespołów mogą autoryzować MCP. Nadal obowiązują uprawnienia na poziomie tablicy.
3. Włącz przełącznik. Zmiany wchodzą w życie natychmiast.

Aby tymczasowo wstrzymać użycie, wyłącz Miro MCP w tym samym miejscu (wstrzymuje nowe wywołania narzędzi).

UWAGA: Jeśli nie widzisz przełącznika MCP, skontaktuj się z opiekunem konta.

Jak działają dostęp i uprawnienia

Gdy włączysz MCP, pozwalasz na:

• odczytywanie zawartości tablic przez zewnętrzne asystenty AI po autoryzacji przez użytkowników.
• tworzenie lub modyfikowanie zawartości tablic Miro przez narzędzia AI.
• bezpieczna wymiana danych między Miro a aplikacjami firm trzecich.

Ważne kwestie bezpieczeństwa:

• Cały dostęp jest uwierzytelniany za pomocą OAuth 2.1.
• Użytkownicy mogą udzielać dostępu tylko do tablic, które mogą wyświetlać.
• Zapewniona jest zgodność bezpieczeństwa w ramach Enterprise.
• Standardowe limity liczby żądań API mają zastosowanie do wszystkich operacji.
• Użytkownicy w Twojej organizacji będą mogli uwierzytelniać się do serwera Miro MCP, co pozwoli zewnętrznym asystentom AI lub asystentom firm trzecich czytać i tworzyć treści na tablicy w ich imieniu.

Zarządzanie MCP w Twojej organizacji

Jako administrator rozważ:

1. Komunikacja: Poinformuj zespoły o dostępności Miro MCP oraz o możliwych zastosowaniach.
2. Szkolenie: Zapewnij wskazówki, jak skutecznie korzystać z MCP przy użyciu różnych narzędzi AI.
3. Zarządzanie: Ustal wytyczne dotyczące odpowiedniego użycia treści generowanych przez AI.
4. Monitorowanie: Okresowo przeglądaj wykorzystanie MCP i w razie potrzeby dostosuj ustawienia.

Aby uzyskać więcej informacji o zarządzaniu aplikacjami w środowisku Miro, zobacz dokumentację zarządzania aplikacjami.

Wytyczne dotyczące wdrażania

• Zacznij od małej skali: włącz dla jednego lub dwóch zespołów pilotażowych (np. zespoły inżynierii i produktu) i zweryfikuj korzyści oraz mechanizmy kontroli.
• Zadbaj o higienę promptów: wymagaj, aby użytkownicy dołączali pełny URL tablicy w każdym promptzie MCP.

Kontroluj, które klienty MCP mogą łączyć się z Miro

Jako administrator firmy możesz zezwolić wszystkim klientom na dostęp do Miro z Twojej organizacji lub zarządzać listą dozwolonych klientów, w tym własnymi niestandardowymi klientami MCP.

Wykonaj następujące kroki:

1. W konsoli administracyjnej przejdź do Aplikacje i integracje > MCP. Jeśli MCP nie jest jeszcze włączone, zobacz Włącz MCP.
2. W sekcji Kontrola dostępu domyślnym ustawieniem jest Wszyscy klienci. Aby zmodyfikować, kliknij Wszyscy klienci, a następnie kliknij Konkretni klienci.
   Otworzy się panel Konkretni klienci MCP.
3. Włącz przełączniki przy klientach, którym chcesz zezwolić na dostęp. Aby zezwolić na niestandardowego klienta MCP, wpisz nazwę klienta w pasku wyszukiwania (u góry), a następnie kliknij Dodaj. Więcej informacji znajdziesz w dokumentacji deweloperskiej Miro MCP.
4. Kliknij Zapisz.
   Panel zostanie zamknięty, a wskazani klienci pojawią się w wierszu pod Kontrolą dostępu.

Wskazówka: Aby zablokować dowolnego klienta, wróć do Aplikacje i integracje > MCP > Wszyscy klienci (w sekcji Kontrola dostępu) i wyłącz przełącznik dla tego klienta. 

Uwaga: Jeśli dodasz niestandardowego klienta MCP, a następnie go zablokujesz, klient zostanie usunięty z listy. Aby ponownie dopuścić klienta, musisz dodać go ponownie. Zobacz krok 3 w Kontroluj, które klienty MCP mogą łączyć się z Miro. 

Rozwiązywanie problemów

• “Nie widzę narzędzi Miro MCP w moim kliencie”
  • Potwierdź, że MCP jest włączone dla organizacji lub docelowego zespołu i że użytkownik należy do tego zespołu.
  • Ponownie uruchom przepływ OAuth i wybierz zespół, dla którego MCP jest włączone.
  • Zweryfikuj, czy klient obsługuje MCP i czy znajduje się na liście klientów, które opisujemy w dokumentacji.
• “Odmowa dostępu podczas wysyłania promptu”
  • Upewnij się, że prompt zawiera pełny adres URL tablicy; asystenci nie będą automatycznie wykrywać tablic.
  • Potwierdź, że użytkownik ma już dostęp do tej tablicy w Miro.
• „Musimy teraz wstrzymać korzystanie”
  • Wyłącz MCP w Ustawienia administratora > Aplikacje i integracje > Miro MCP.
• „Klient użytkownika jest zablokowany lub zwraca błąd dostępu”
  • Upewnij się, że klient jest włączony w Kontrola dostępu, albo dodaj go jako niestandardowego klienta.