Skonfiguruj zarządzaną autoryzację korporacyjną dla Miro MCP – Centrum pomocy Miro

Kto może to zrobić: administratorzy firmy
Które plany: Enterprise
Które platformy: Przeglądarka, Desktop

Zarządzana autoryzacja korporacyjna (EMA) pozwala Twojemu dostawcy tożsamości przyznać dostęp do Miro MCP, dzięki czemu użytkownicy nie muszą logować się do Miro oddzielnie od klienta MCP. W pierwszym wydaniu EMA dotyczy Claude. Inne klienty MCP nadal logują się przez OAuth.

Zanim zaczniesz

Włącz Miro MCP dla swojej organizacji. Zobacz Miro MCP Server (admin guide).
Utwórz lub wybierz domyślny zespół dla EMA. Najlepiej użyć ograniczonego zespołu, który zawiera tylko użytkowników potrzebujących dostępu przez MCP w ten sposób, a następnie dodaj tych użytkowników do zespołu.
Miej dostęp administratora do swojego dostawcy tożsamości. Okta jest obsługiwanym dostawcą tożsamości w tym wydaniu. Zobacz Set up AI agent token exchange w dokumentacji Okta.
Miej dostęp administratora do konsoli administracyjnej Anthropic, aby móc włączyć zarządzaną autoryzację korporacyjną dla konektora Miro.

Użytkownicy korzystający z EMA potrzebują dostępu w dwóch miejscach: członkostwa w domyślnym zespole Miro oraz ról lub uprawnień, które przyznasz w Okta. Wykonanie tylko jednego z tych kroków nie wystarczy.

Jak działa zarządzana autoryzacja korporacyjna

Po włączeniu EMA:

Twój dostawca tożsamości decyduje, kto może żądać dostępu do Miro MCP.
Claude może łączyć się z Miro MCP bez konieczności, by każdy użytkownik przechodził oddzielny przepływ zgody OAuth w Miro.
Miro otwiera tablice w domyślnym zespole, który wybierzesz dla EMA.
Inne klienty MCP (na przykład Cursor lub ChatGPT) nadal używają standardowego OAuth i zwykłych kontroli zespołów i grup użytkowników.

EMA jest niezależne od pojedynczego logowania (SSO) Miro. Dodanie połączenia SAML dla logowania do Miro nie ufa temu wystawcy dla MCP. Musisz dodać wystawcę specjalnie w sekcji Zaufani wystawcy na stronie MCP.

Dla kontekstu branżowego zobacz Enterprise-Managed Authorization na blogu Model Context Protocol.

Skonfiguruj zarządzaną autoryzację korporacyjną

Za pierwszym razem, gdy włączysz tę funkcję, Miro otworzy panel kreatora. Wykonaj wszystkie trzy kroki, a następnie kliknij Zakończ konfigurację. EMA nie jest włączone, dopóki nie zakończysz konfiguracji.

Przejdź do konsola administracyjna > Apps and integrations > MCP.
W sekcji Enterprise-Managed Authorization włącz Enable enterprise-managed authorization for Claude.
Otworzy się panel Skonfiguruj zarządzaną autoryzację korporacyjną.
Wykonaj trzy kroki w panelu (opisane poniżej).
Kliknij Zakończ konfigurację.
Strona MCP pokaże Twój domyślny zespół i zaufanych wystawców.

Krok 1: Wybierz domyślny zespół

Wszyscy, którzy logują się przez zarządzaną autoryzację korporacyjną, otrzymują dostęp w tym zespole. Dodaj użytkowników potrzebujących dostępu do niego przed lub po zakończeniu konfiguracji.

W panelu konfiguracji wyszukaj zespół.
Wybierz zespół, który chcesz ustawić jako domyślny.
Kliknij Kontynuuj.

Użyj dedykowanego, ograniczonego zespołu dla EMA, jeśli to możliwe. Dzięki temu dostęp do tablic przez EMA będzie ograniczony do wyraźnie określonego grona członków.

Jeśli wybrany zespół nie ma jeszcze włączonego MCP, Miro poprosi Cię o włączenie MCP dla tego zespołu. Kliknij Włącz MCP, aby sesje EMA mogły tam otwierać tablice. Miro doda zespół do zespołów wybranych w sekcji Teams and user groups.

Krok 2: Dodaj zaufanego wystawcę

Skopiuj wartości Miro do swojego dostawcy tożsamości, a następnie potwierdź URL wystawcy z powrotem w Miro.

W tym kroku widoczne są dwa pola o nazwie Issuer URL. Pierwsze, pod nagłówkiem Copy these values into your identity provider, to wartość Miro: skopiuj ją do Okta. Drugie, pod Confirm the issuer, to miejsce, gdzie wpisujesz URL wystawcy swojego dostawcy tożsamości.

W sekcji Copy these values into your identity provider skopiuj każdą wartość pokazaną przez Miro:
- Issuer URL (na przykład, https://mcp.miro.com/)
- Audience or tenant ID (unikalne dla Twojej organizacji)
- Resource indicator (na przykład, https://mcp.miro.com/)
W Okta utwórz konfigurację agenta dla Miro i wklej te wartości dokładnie tak, jak pokazano. Następnie przyznaj role w Okta użytkownikom, którzy potrzebują dostępu. Szczegółowe kroki dla Okta znajdziesz w Set up AI agent token exchange.
Wracając do Miro, w sekcji Confirm the issuer wpisz URL wystawcy od swojego dostawcy tożsamości.
URL jest rejestrowany względem identyfikatora audience pokazanego przez Miro dla Twojej organizacji.
Kliknij Dodaj wystawcę.
Miro sprawdza odkrywanie i klucze. Powinieneś zobaczyć Discovery resolved i Keys reachable.
Kliknij Kontynuuj.

Jeśli odkrywanie się nie powiedzie lub klucze są niedostępne, potwierdź, że Twój dostawca tożsamości publikuje jwks_uri pod /.well-known/openid-configuration lub /.well-known/oauth-authorization-server. Kliknij Sprawdź ponownie po naprawieniu konfiguracji. Jeśli problem nadal występuje, skontaktuj się z pomocą Miro.

Możesz dodać więcej niż jednego zaufanego wystawcę. Usuń wystawcę za pomocą ikony kosza, jeśli dodałeś go przez pomyłkę.

Krok 3: Włącz w Claude

Otwórz konsolę administracyjną Anthropic (użyj Open the Anthropic admin console w panelu konfiguracji).
Włącz zarządzaną autoryzację korporacyjną dla konektora Miro.
Wróć do Miro i kliknij Zakończ konfigurację.

Inne klienty MCP nadal logują się przez OAuth.

Zarządzaj ustawieniami zarządzanej autoryzacji korporacyjnej

Po pierwszym pomyślnym skonfigurowaniu ponowne wyłączenie i włączenie funkcji nie otwiera ponownie panelu kreatora. Ustawieniami zarządzasz na stronie MCP.

Zmień domyślny zespół

Przejdź do konsola administracyjna > Apps and integrations > MCP.
W sekcji Enterprise-Managed Authorization otwórz Default team.
Wybierz inny zespół.
Jeśli ten zespół nie ma włączonego MCP, potwierdź Włącz MCP, gdy pojawi się monit. Miro doda zespół do zespołów wybranych w sekcji Teams and user groups.

Dodaj lub zarządzaj zaufanymi wystawcami

Przejdź do konsola administracyjna > Apps and integrations > MCP.
W sekcji Trusted issuers przejrzyj stan i szczegóły dla każdego wystawcy:
- Enabled lub wyłączony
- Discovery resolved / Discovery failed
- Keys reachable / Keys unreachable
Aby dodać kolejnego wystawcę, kliknij + Add trusted issuer, wpisz URL wystawcy i potwierdź, że odkrywanie zakończy się powodzeniem.
Użyj przełącznika w wierszu, aby włączyć lub wyłączyć wystawcę bez jego usuwania.
Użyj ikony kosza, aby usunąć wystawcę, któremu już nie ufasz.

Tylko wystawcy wymienieni tutaj mogą żądać dostępu do MCP przez EMA. Twoje istniejące połączenie SAML lub OIDC SSO w Miro samo w sobie nie wystarczy.

Wyłącz zarządzaną autoryzację korporacyjną

Przejdź do konsola administracyjna > Apps and integrations > MCP.
W sekcji Enterprise-Managed Authorization wyłącz Enable enterprise-managed authorization for Claude.

Claude wraca do zwykłego przepływu OAuth. Twój zapisany domyślny zespół i zaufani wystawcy pozostaną dostępni, jeśli później ponownie włączysz funkcję.

Ograniczenia

EMA obecnie dotyczy Claude. Inne klienty MCP nadal używają OAuth.
Sesje EMA używają jednego domyślnego zespołu. Użytkownicy potrzebujący tablic w innych zespołach nadal korzystają z klientów OAuth dla tych zespołów.
W tym wydaniu przyznajesz dostęp zarówno w Miro (członkostwo w domyślnym zespole), jak i w Okta (role lub dostęp dla konfiguracji agenta Miro).
Odkrywanie zaufanych wystawców zależy od tego, czy Twój dostawca tożsamości publikuje osiągalny punkt końcowy JWKS.