Miro MCP Server (przewodnik administratora)

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

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

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

Zanim zaczniesz

• Włącz MCP dla organizacji, a następnie użyj Kontroli dostępu, aby zdecydować, kto może z niego korzystać.
• Możesz pozostawić dostęp otwarty dla wszystkich lub ograniczyć go do wybranych zespołów i opcjonalnie grup użytkowników. Nadal obowiązują uprawnienia na poziomie tablicy.

Włączanie lub wyłączanie serwera MCP

Aby włączyć MCP Server:

1. Przejdź do Ustawienia administratora > Aplikacje i integracje > MCP.
2. W sekcji Włącz MCP włącz opcję Pozwól użytkownikom w twojej organizacji łączyć Miro z klientami zgodnymi z MCP.

Zmiany wchodzą w życie natychmiast.

Aby tymczasowo wstrzymać użycie, wyłącz ten sam przełącznik (wstrzymuje nowe wywołania narzędzi).

Jeśli nie widzisz ustawień MCP, skontaktuj się ze swoim opiekunem konta.

Kontrola dostępu za pomocą zespołów i grup użytkowników

W sekcji Kontrola dostępu > Zespoły i grupy użytkowników wybierz, kto może korzystać z Miro MCP po jego włączeniu.

Ustawienie	Kto może korzystać z MCP
Wszyscy (domyślnie)	Wszyscy użytkownicy będący członkami włączonych zespołów
Wybrane zespoły i grupy użytkowników	Tylko użytkownicy, którzy należą zarówno do wybranych zespołów, jak i do wybranych grup użytkowników

Ogranicz dostęp do wybranych zespołów i grup użytkowników

1. W konsoli administracyjnej przejdź do Aplikacje i integracje > MCP.
2. W sekcji Kontrola dostępu otwórz rozwijane menu Zespoły i grupy użytkowników, a następnie wybierz Wybrane zespoły i grupy użytkowników.
   Otworzy się panel Dodaj dostęp do MCP.
3. Wybierz zespoły:
   1. Wybierz Wszystkie zespoły w organizacji lub Wybrane zespoły.
   2. Jeśli wybierzesz Wybrane zespoły, otwórz selektor zespołów, wyszukaj i wybierz zespoły, kliknij Dodaj zespoły, a następnie wróć do panelu.
   3. Kliknij Dalej.
4. Filtruj według grup użytkowników:
   1. Wybierz Wszyscy użytkownicy w wybranych zespołach lub Tylko użytkownicy, którzy są także w określonych grupach użytkowników.
   2. Jeśli wybierzesz określone grupy użytkowników, otwórz selektor grup użytkowników, wyszukaj i wybierz grupy, kliknij Dodaj grupy użytkowników, a następnie wróć do panelu.
   3. Kliknij Dalej.
5. Przejrzyj i potwierdź podsumowanie (na przykład użytkownicy z 6 zespołów, którzy są także w 1 grupie użytkowników, będą mieć dostęp do Miro MCP). Możesz kliknąć Edytuj, aby zmienić zespoły lub grupy użytkowników.
6. Kliknij Dodaj dostęp.

Jak działa dostęp oparty na zespołach i grupach użytkowników

Gdy używasz Wybranych zespołów i grup użytkowników, użytkownik może autoryzować Miro MCP tylko wtedy, gdy spełnia oba skonfigurowane warunki:

1. Należy do wybranego zespołu (lub dowolnego zespołu, jeśli wybrałeś Wszystkie zespoły).
2. Jeśli wybrałeś grupy użytkowników, należy także do co najmniej jednej z tych grup użytkowników.

Jeżeli wybierzesz Wszyscy użytkownicy w wybranych zespołach, obowiązuje tylko wymóg dotyczący zespołu.

Sam fakt przynależności do grupy użytkowników nie wystarcza. Użytkownik musi także należeć do wybranego zespołu.

Gdy wybierzesz więcej niż jedną grupę użytkowników, użytkownik musi pasować do przynajmniej jednej z nich (nie do wszystkich naraz).

Przykłady

• Wszyscy: Każdy użytkownik w włączonym zespole może autoryzować MCP.
• Wybrane zespoły (na przykład A i B), wszyscy użytkownicy w wybranych zespołach: Użytkownicy z Zespołu A lub Zespołu B mogą autoryzować MCP. Użytkownicy tylko z Zespołu C nie mogą.
• Wybrane zespoły (Zespół A) i wybrane grupy użytkowników (Grupa użytkowników 1): Tylko użytkownicy, którzy są w Zespole A i w Grupie użytkowników 1, mogą autoryzować MCP. Na przykład jeśli Zespół A ma 100 członków, a Grupa użytkowników 1 obejmuje 20 z nich, tylko ci 20 użytkownicy mogą korzystać z MCP.
• Wszystkie zespoły i wybrane grupy użytkowników: Użytkownicy w dowolnym zespole, którzy jednocześnie należą do wybranej grupy użytkowników, mogą autoryzować MCP.
• Powrót do ustawienia Wszyscy: Dostęp nie jest już ograniczony do zespołów i grup użytkowników wybranych wcześniej w panelu.

Jak działają dostęp i uprawnienia

Gdy włączysz MCP, zezwalasz na:

• Odczytywanie przez zewnętrznych agentów AI zawartości tablic, gdy użytkownicy udzielą autoryzacji.
• Tworzenie lub modyfikowanie zawartości na tablicach Miro przez narzędzia AI.
• Bezpieczną wymianę danych między Miro a aplikacjami firm trzecich.

Ważne zagadnienia związane z bezpieczeństwem:

• Dostęp jest uwierzytelniany za pomocą OAuth 2.1 lub za pomocą autoryzacji zarządzanej przez przedsiębiorstwo (EMA) dla Claude, gdy ją włączysz. Zobacz Skonfiguruj autoryzację zarządzaną przez przedsiębiorstwo dla Miro MCP.
• Użytkownicy mogą udzielać dostępu tylko do tablic, do których mają uprawnienia do wyświetlania.
• Zachowywana jest zgodność z politykami bezpieczeństwa przedsiębiorstwa.
• Standardowe limity szybkości API mają zastosowanie do wszystkich operacji.
• Użytkownicy w twojej organizacji będą mogli uwierzytelniać się na serwerze MCP, co pozwoli zewnętrznym lub firmowym agentom AI na odczytywanie i tworzenie treści na tablicy w ich imieniu.
• Jeśli ograniczysz MCP za pomocą zespołów i grup użytkowników, użytkownicy spoza tego wyboru nie będą mogli autoryzować MCP przez OAuth. EMA używa domyślnego zespołu i zaufanych issuerów, które skonfigurujesz zamiast tego.

Zarządzanie MCP w organizacji

Jako administrator powinieneś rozważyć:

1. Komunikacja: Poinformuj zespoły o dostępności Miro MCP i przypadkach użycia.
2. Szkolenie: Zapewnij wskazówki dotyczące efektywnego korzystania z MCP z różnymi narzędziami 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 dostosowuj ustawienia.

Więcej informacji o zarządzaniu aplikacjami w środowisku Miro znajdziesz w dokumentacji zarządzania aplikacjami.

Wytyczne dotyczące wdrożenia

• Zacznij od małej skali: w sekcji Kontrola dostępu wybierz Wybrane zespoły i grupy użytkowników, wybierz jeden lub dwa zespoły pilotażowe i pozostaw grupy użytkowników jako Wszyscy użytkownicy w wybranych zespołach.
• Dla węższego pilotażu wybierz również Tylko użytkownicy, którzy są także w określonych grupach użytkowników, aby tylko ta grupa mogła autoryzować MCP.
• Wzmocnij zasady dotyczące promptów: wymagaj, aby użytkownicy dołączali pełny adres URL tablicy w każdym zapytaniu MCP.

Skonfiguruj autoryzację zarządzaną przez przedsiębiorstwo dla Claude

Autoryzacja zarządzana przez przedsiębiorstwo (EMA) umożliwia twojemu dostawcy tożsamości przyznawanie dostępu do Miro MCP dla Claude, dzięki czemu osoby nie wykonują osobnego logowania OAuth do Miro. Inni klienci MCP nadal korzystają z OAuth.

Na stronie MCP, w sekcji Enterprise-Managed Authorization, wybierz domyślny zespół, dodaj zaufanych issuerów z twojego dostawcy tożsamości (Okta w pierwszym wydaniu) i dokończ konfigurację w konsoli administracyjnej Anthropic.

Więcej informacji: Zobacz Skonfiguruj autoryzację zarządzaną przez przedsiębiorstwo dla Miro 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 jeszcze nie włączyłeś MCP, zobacz Włączanie lub wyłączanie serwera MCP.
2. W sekcji Kontrola dostępu ustawienie Wszyscy klienci jest domyślne. Aby zmodyfikować, kliknij Wszyscy klienci, a następnie kliknij Określeni klienci.
   Otworzy się panel Określeni klienci MCP.
3. Włącz przełączniki przy klientach, które chcesz zezwolić. Aby dodać 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 wybrani klienci pojawią się w wierszu pod Kontrolą dostępu.

Aby zabronić któregokolwiek klienta, wróć do Aplikacje i integracje > MCP > Wszyscy klienci (w sekcji Kontrola dostępu) i wyłącz ten klienta.

Jeśli dodasz niestandardowego klienta MCP, a potem go zabronisz, klient zostanie usunięty z listy. Aby ponownie umożliwić dostęp, musisz dodać klienta 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.
  • W sekcji Kontrola dostępu > Zespoły i grupy użytkowników potwierdź, że użytkownik jest uwzględniony (w wybranym zespole, oraz w wybranej grupie użytkowników, jeśli ją skonfigurowano).
  • Ponownie uruchom przepływ OAuth i wybierz zespół, który ma dostęp do MCP.
  • Dla Claude przy użyciu autoryzacji zarządzanej przez przedsiębiorstwo potwierdź, że EMA jest włączona, użytkownik należy do domyślnego zespołu EMA, trusted issuer pokazuje Discovery resolved i Keys reachable, oraz że EMA jest włączona dla Miro connector w konsoli administracyjnej Anthropic.
  • Zweryfikuj, czy klient obsługuje MCP i czy znajduje się wśród klientów, do których kierujemy i dokumentujemy wsparcie.
• „Odmowa dostępu podczas wysyłania zapytania”
  • Upewnij się, że zapytanie zawiera pełny adres URL tablicy; agenci nie będą automatycznie wykrywać tablic.
  • Potwierdź, że użytkownik już ma dostęp do tej tablicy w Miro.
  • Jeśli użytkownik wcześniej miał dostęp, a przestało działać, sprawdź, czy zmieniła się kontrola dostępu Zespoły i grupy użytkowników, lub czy został usunięty z wybranego zespołu lub grupy użytkowników.
• „Musimy natychmiast wstrzymać użycie”
  • Wyłącz MCP w Ustawienia administratora > Aplikacje i integracje > MCP.
• „Klient użytkownika jest zablokowany / zwraca błąd dostępu”
  • Potwierdź, że klient jest włączony w sekcji Kontrola dostępu, lub dodaj go jako niestandardowego klienta.