Configurar autorização gerenciada pela empresa para Miro MCP

Quem pode fazer isso: Admin da empresa
Quais planos: Enterprise
Quais plataformas: Navegador, Desktop

A autorização gerenciada pela empresa (EMA) permite que seu provedor de identidade conceda acesso ao Miro MCP, para que os usuários não precisem iniciar sessão na Miro separadamente do cliente MCP. Na primeira versão, a EMA aplica-se ao Claude. Outros clientes MCP continuam iniciando sessão com OAuth.

Antes de começar

• Habilite o Miro MCP para sua organização. Consulte Servidor Miro MCP (guia do admin).
• Crie ou escolha um time padrão para a EMA. Prefira um time restrito que contenha apenas os usuários que precisam de acesso ao MCP dessa forma e adicione esses usuários ao time.
• Tenha acesso de admin ao seu provedor de identidade. O Okta é o provedor de identidade compatível para esta versão. Consulte Configurar a troca de token do agente de IA na documentação da Okta.
• Tenha acesso de admin ao console de admin da Anthropic para ativar a autorização gerenciada pela empresa para o conector da Miro.

Usuários que usam a EMA precisam de acesso em dois lugares: ser membros do time padrão da Miro e ter as funções ou o acesso que você concede no Okta. Concluir apenas uma dessas etapas não é suficiente.

Como funciona a autorização gerenciada pela empresa

Com a EMA ativada:

• Seu provedor de identidade determina quem pode solicitar acesso ao Miro MCP.
• O Claude pode conectar-se ao Miro MCP sem que cada usuário conclua um fluxo separado de consentimento OAuth do Miro.
• A Miro abre os boards no time padrão que você selecionar para a EMA.
• Outros clientes MCP (por exemplo Cursor ou ChatGPT) continuam a usar o OAuth padrão e os controles usuais de times e grupos de usuários.

A EMA é independente do logon único da Miro. Adicionar uma conexão SAML para o login web da Miro não confere confiança a esse emissor para o MCP. Você deve adicionar o emissor especificamente em Emissores confiáveis na página do MCP.

Para mais informações sobre a extensão do setor, consulte Autorização gerenciada pela empresa no blog do Model Context Protocol.

Configurar autorização gerenciada pela empresa

Na primeira vez que você ativar a funcionalidade, a Miro abre um painel de configuração guiada. Conclua todas as três etapas e clique em Concluir configuração. A EMA não é ativada até que você conclua.

1. Vá para Console de administração > Apps e integrações > MCP.
2. Sob Autorização gerenciada pela empresa, ative Ativar autorização gerenciada pela empresa para o Claude.
   O painel Configurar autorização gerenciada pela empresa abre.
3. Complete os três passos no painel (descritos abaixo).
4. Clique em Concluir configuração.
   A página do MCP mostra seu time padrão e os emissores confiáveis.

Passo 1: Selecione um time padrão

Todas as pessoas que iniciam sessão por meio da autorização gerenciada pela empresa recebem acesso a este time. Adicione os usuários que precisam de acesso a ele antes ou depois de concluir a configuração.

1. No painel de configuração, pesquise um time.
2. Selecione o time que deseja definir como padrão.
3. Clique em Continuar.

Prefira um time dedicado e restrito para EMA sempre que possível. Isso mantém o acesso aos boards do EMA restrito a um conjunto claro de membros.

Se o time selecionado ainda não tiver o MCP ativado, a Miro solicitará que você ative o MCP para esse time. Clique em Ativar MCP para que as sessões EMA possam abrir boards lá. A Miro adiciona o time aos times selecionados em Times e grupos de usuários.

Passo 2: Adicionar um emissor confiável

Copie os valores da Miro para o seu provedor de identidade e, em seguida, confirme a URL do emissor na Miro.

Esta etapa mostra dois campos chamados URL do emissor. O primeiro, em Copie estes valores para o seu provedor de identidade, é o valor da Miro: copie-o para o Okta. O segundo, em Confirmar o emissor, é onde você insere a URL do emissor do seu provedor de identidade.

1. Em Copie estes valores para o seu provedor de identidade, copie cada um dos valores exibidos pela Miro:
   • URL do emissor (por exemplo, https://mcp.miro.com/)
   • ID da audiência ou do locatário (único para sua organização)
   • Indicador de recurso (por exemplo, https://mcp.miro.com/)
2. No Okta, crie a configuração do agente para a Miro e cole estes valores exatamente como mostrados. Depois, atribua funções no Okta aos usuários que precisam de acesso. Para instruções detalhadas no Okta, consulte Configurar a troca de token do agente de IA.
3. De volta à Miro, em Confirmar o emissor, insira a URL do emissor do seu provedor de identidade.
   A URL é registrada com o ID da audiência que a Miro exibe para sua organização.
4. Clique em Adicionar emissor.
   A Miro verifica a descoberta e as chaves. Você deverá ver Descoberta resolvida e Chaves acessíveis.
5. Clique em Continuar.

Se a descoberta falhar ou as chaves estiverem inacessíveis, confirme que seu provedor de identidade publica jwks_uri em /.well-known/openid-configuration ou /.well-known/oauth-authorization-server. Clique em Verificar novamente depois de corrigir a configuração. Se ainda falhar, entre em contato com o Suporte da Miro.

Você pode adicionar mais de um emissor confiável. Remova um emissor clicando no ícone de lixeira se o adicionou por engano.

Passo 3: Ative no Claude

1. Abra o console de admin da Anthropic (use o Abrir o console de admin da Anthropic no painel de configuração).
2. Ative a autorização gerenciada pela empresa para o conector Miro.
3. Volte para a Miro e clique em Concluir configuração.

Outros clientes MCP continuam iniciando sessão com OAuth.

Gerenciar configurações da autorização gerenciada pela empresa

Após a primeira configuração bem-sucedida, desligar e ligar a funcionalidade novamente não reabre o painel guiado. Em vez disso, gerencie as configurações na página MCP.

Alterar time padrão

1. Vá para Console de administração > Apps e integrações > MCP.
2. Em Autorização gerenciada pela empresa, abra Time padrão.
3. Selecione outro time.
   Se esse time não tiver o MCP ativado, confirme Ativar MCP quando solicitado. A Miro adiciona o time aos times selecionados em Times e grupos de usuários.

Adicionar ou gerenciar emissores confiáveis

1. Vá para Console do administrador > Apps e integrações > MCP.
2. Em Emissores confiáveis, revise o status e os detalhes de cada emissor:
   • Ativado ou desativado
   • Descoberta resolvida / Descoberta falhou
   • Chaves acessíveis / Chaves inacessíveis
3. Para adicionar outro emissor, clique em + Adicionar emissor confiável, insira a URL do emissor e confirme que a descoberta foi concluída.
4. Use o botão de alternância da linha para ativar ou desabilitar um emissor sem excluí-lo.
5. Use o ícone de lixeira para remover um emissor em que você não confia mais.

Apenas emissores listados aqui podem solicitar acesso ao MCP por meio da autorização gerenciada pela empresa (EMA). Sua conexão SAML ou OIDC de logon único existente com a Miro não é suficiente por si só.

Desativar a autorização gerenciada pela empresa

1. Vá para Admin Console > Apps and integrations > MCP.
2. Em Enterprise-Managed Authorization, desative Enable enterprise-managed authorization for Claude.

Claude volta ao fluxo OAuth usual. Seu time padrão salvo e os emissores confiáveis permanecem disponíveis se você ativar a funcionalidade novamente mais tarde.

Restrições

• A EMA aplica-se atualmente ao Claude. Outros clientes MCP continuam a usar OAuth.
• As sessões EMA usam um único time padrão. Usuários que precisam de boards em outros times continuam a usar clientes OAuth para esses times.
• Nesta versão, é preciso conceder acesso tanto na Miro (filiação ao time padrão) quanto no Okta (funções ou permissões para a configuração do agente da Miro).
• A descoberta de emissores confiáveis depende do provedor de identidade publicar um endpoint JWKS acessível.

Artigos relacionados

• Servidor MCP da Miro (guia do admin)
• Visão geral do Servidor MCP da Miro
• Como ativar o Servidor MCP da Miro (guia do usuário)
• O que são clientes MCP