Miro MCP Server (guia do admin)

Quem pode fazer: admins da empresa e admins do time em planos Enterprise

Como Admin da empresa de uma assinatura Enterprise, você controla se o Miro MCP Server está disponível para sua organização. Essa configuração determina se seus times podem usar integrações de IA que se conectam à Miro.

{1}Use o MCP da Miro (Protocolo de Contexto de Modelo) para conectar seus boards da Miro a ferramentas de IA compatíveis com MCP. Quando ativados e autorizados, agentes de IA podem ler contextos de boards específicos e (quando permitido) realizar ações como resumir conteúdo ou criar diagramas através de um conjunto de ferramentas MCP da Miro. Este guia explica pré-requisitos, habilitação, governança e solução de problemas.

Antes de começar

• Ative o MCP para sua organização, depois use Controle de acesso para decidir quem pode usá‑lo.
• Você pode manter o acesso aberto a todos, ou limitá‑lo a times selecionados e, opcionalmente, a grupos de usuários. As permissões no nível do board ainda se aplicam.

Ativar ou desativar o MCP Server

Para ativar o MCP Server:

1. Vá para Configurações de admin > Aplicativos e integrações > MCP.
2. Em Ativar MCP, ative Permitir que usuários da sua organização conectem a Miro a clientes compatíveis com MCP.

As alterações entram em vigor imediatamente.

Para interromper temporariamente o uso, desative o mesmo botão (impede novas chamadas de ferramenta).

Se você não vir as configurações do MCP, entre em contato com o gerente de conta.

Controle o acesso com times e grupos de usuários

Em Controle de acesso > Times e grupos de usuários, escolha quem pode usar o MCP da Miro depois de ativá‑lo.

Configuração	Quem pode usar o MCP
Todos (padrão)	Todos os usuários que são membros de times habilitados
Times e grupos de usuários específicos	Apenas usuários que estejam tanto nos times quanto nos grupos de usuários que você selecionar

Restringir o acesso a times e grupos de usuários específicos

1. No console de admin, vá para Aplicativos e integrações > MCP.
2. Em Controle de acesso, abra o menu suspenso Times e grupos de usuários, então selecione Times e grupos de usuários específicos.
   O painel Adicionar acesso ao MCP abre.
3. Selecionar times:
   1. Escolha Todos os times na sua organização, ou Times específicos.
   2. Se você escolher Times específicos, abra o seletor de times, pesquise e selecione os times, clique em Adicionar times, e então retorne ao painel.
   3. Clique em Avançar.
4. Filtrar por grupos de usuários:
   1. Escolha Todos os usuários nos times selecionados, ou Apenas usuários que também estejam em grupos de usuários específicos.
   2. Se você escolher grupos de usuários específicos, abra o seletor de grupos, pesquise e selecione os grupos, clique em Adicionar grupos de usuários, em seguida retorne ao painel.
   3. Clique em Avançar.
5. Revisar e confirmar o resumo (por exemplo, usuários em 6 times que também estejam em 1 grupo de usuários terão acesso ao MCP da Miro). Você pode clicar em Editar para alterar os times ou grupos de usuários.
6. Clique em Adicionar acesso.

Como o acesso por times e grupos de usuários funciona

Quando você usa Times e grupos de usuários específicos, um usuário só pode autorizar o MCP da Miro se atender a ambas as condições que você configurou:

1. O usuário pertence a um time selecionado (ou a qualquer time, se você escolheu Todos os times).
2. Se você selecionou grupos de usuários, o usuário também pertence a pelo menos um desses grupos de usuários.

Se você escolher Todos os usuários nos times selecionados, aplica‑se apenas o requisito do time.

A filiação a um grupo de usuários por si só não é suficiente. O usuário também deve estar em um time selecionado.

Quando você seleciona mais de um grupo de usuários, o usuário precisa corresponder a qualquer um deles (não a todos).

Exemplos

• Todos: Qualquer usuário em um time habilitado pode autorizar o MCP.
• Times específicos (por exemplo, A e B), todos os usuários nos times selecionados: Usuários no Time A ou Time B podem autorizar o MCP. Usuários apenas no Time C não podem.
• Times específicos (Time A) e grupos de usuários específicos (Grupo de Usuários 1): Apenas usuários que estão no Time A e no Grupo de Usuários 1 podem autorizar o MCP. Por exemplo, se o Time A tiver 100 membros e o Grupo de Usuários 1 incluir 20 deles, apenas esses 20 podem usar o MCP.
• Todos os times e grupos de usuários específicos: Usuários em qualquer time que também estejam em um grupo de usuários selecionado podem autorizar o MCP.
• Voltar para Todos: O acesso não fica mais limitado aos times e grupos de usuários que você selecionou no painel.

Como o acesso e as permissões funcionam

Quando você ativa o MCP, permite:

• Permitir que agentes de IA externos leiam o conteúdo do board quando autorizados pelos usuários.
• Permitir que ferramentas de IA criem ou modifiquem conteúdo em boards da Miro.
• Permitir troca segura de dados entre a Miro e aplicações de terceiros.

Considerações importantes de segurança:

• O acesso é autenticado por OAuth 2.1, ou por autorização gerenciada pela empresa (EMA) para Claude quando você a habilita. Veja Configurar autorização gerenciada pela empresa para o MCP da Miro.
• Os usuários só podem conceder acesso a boards que tenham permissão para visualizar.
• A conformidade de segurança empresarial é mantida.
• Aplicam‑se limites padrão de taxa da API a todas as operações.
• Usuários em sua organização poderão autenticar‑se no MCP Server, permitindo que agentes de IA externos ou de terceiros leiam e criem conteúdo em um board em nome deles.
• Se você restringir o MCP por meio de times e grupos de usuários, usuários fora dessa seleção não poderão autorizar o MCP via OAuth. A EMA usa o time padrão e os emissores confiáveis que você configurar em vez disso.

Gerenciar o MCP na sua organização

Como admin, você deve considerar:

1. Comunicação: Informe seus times sobre a disponibilidade do MCP da Miro e os casos de uso.
2. Treinamento: Forneça orientações sobre como usar efetivamente o MCP com diferentes ferramentas de IA.
3. Governança: Estabeleça diretrizes para o uso adequado de conteúdo gerado por IA.
4. Monitoramento: Revise periodicamente o uso do MCP e ajuste as configurações conforme necessário.

Para mais informações sobre gerenciar aplicativos no seu ambiente da Miro, veja a documentação de gerenciamento de aplicativos.

Diretrizes de implantação

• Comece pequeno: em Controle de acesso, escolha Times e grupos de usuários específicos, selecione um ou dois times piloto e deixe os grupos de usuários como Todos os usuários nos times selecionados.
• Para um piloto mais restrito, escolha também Apenas usuários que também estejam em grupos de usuários específicos para que apenas esse grupo possa autorizar o MCP.
• Reforce a higiene de prompts: exija que os usuários incluam a URL completa do board em cada prompt do MCP.

Configurar autorização gerenciada pela empresa para Claude

A autorização gerenciada pela empresa (EMA) permite que seu provedor de identidade conceda acesso ao MCP da Miro para o Claude, para que as pessoas não precisem iniciar sessão via OAuth separadamente na Miro. Outros clientes MCP continuam usando OAuth.

Na página do MCP, em Autorização gerenciada pela empresa, selecione um time padrão, adicione emissores confiáveis do seu provedor de identidade (Okta no lançamento inicial) e conclua a configuração no console de admin da Anthropic.

Mais informações: Veja Configurar autorização gerenciada pela empresa para o MCP da Miro.

Controlar quais clientes MCP podem se conectar à Miro

Como admin da empresa, você pode permitir que todos os clientes acessem a Miro a partir da sua organização, ou gerenciar uma lista de permissão de clientes, incluindo seus próprios clientes MCP personalizados.

Siga estas etapas:

1. No console de admin, vá para Aplicativos e integrações > MCP. Se você ainda não ativou o MCP, veja Ativar ou desativar o MCP Server.
2. Em Controle de acesso, Todos os clientes é a configuração padrão. Para modificar, clique em Todos os clientes, depois clique em Clientes específicos.
   O painel Clientes MCP específicos abre.
3. Ative os clientes que você deseja permitir. Para permitir um cliente MCP personalizado, insira o nome do seu cliente na barra de busca (no topo), então clique em Adicionar. Para mais informações, veja a documentação de desenvolvedor do MCP da Miro.
4. Clique em Salvar.
   O painel se fecha, e os clientes especificados aparecem em uma linha sob Controle de acesso.

Para desabilitar qualquer cliente, volte para Aplicativos e integrações > MCP > Todos os clientes (em Controle de acesso) e desative o cliente.

Se você adicionar um cliente MCP personalizado e depois o desabilitar, o cliente é removido da lista. Para permitir novamente, será necessário adicionar o cliente novamente. Veja o passo 3 em Controlar quais clientes MCP podem se conectar à Miro.

Solução de problemas

• “Não consigo ver as ferramentas no MCP da Miro no meu cliente”
  • Confirme que o MCP está ativado para a organização.
  • Em Controle de acesso > Times e grupos de usuários, confirme que o usuário está incluído (em um time selecionado e, se você configurou um, em um grupo de usuários selecionado).
  • Execute novamente o fluxo OAuth e selecione um time que tenha acesso ao MCP.
  • Para o Claude com autorização gerenciada pela empresa, confirme que a EMA está habilitada, o usuário está no time EMA padrão, o emissor confiável mostra Discovery resolved e Keys reachable, e a EMA está ativada para o conector da Miro no console de admin da Anthropic.
  • Verifique se o cliente suporta MCP e está entre os clientes que estamos direcionando/documentando.
• “Acesso negado ao enviar prompt”
  • Certifique‑se de que o prompt inclua a URL completa do board; os agentes não descobrirão os boards automaticamente.
  • Confirme que o usuário já tem acesso a esse board na Miro.
  • Se o usuário anteriormente tinha acesso e isso parou de funcionar, verifique se o controle de acesso Times e grupos de usuários mudou, ou se ele foi removido de um time ou grupo de usuários selecionado.
• “Precisamos pausar o uso agora”
  • Desative o MCP em Configurações de admin > Aplicativos e integrações > MCP.
• “O cliente de um usuário está bloqueado / retorna um erro de acesso”
  • Confirme que o cliente está ativado em Controle de acesso, ou adicione‑o como um cliente personalizado.