Como habilitar o MCP Server da Miro (guia do usuário) – Central de ajuda da Miro

Para contas Enterprise, ativar o MCP exige aprovação de um admin. Se você faz parte de um time Enterprise, consulte o Guia de admin para o Miro MCP.

É necessário que o Miro MCP esteja ativado e autorizado no seu time e na sua organização antes de conectar-se a qualquer MCP Client.

Ativar o Servidor MCP

Siga os passos conforme seu tipo de plano para começar rapidamente.

Planos Free, Starter, Business e Educational

O MCP está ativado por padrão, não é necessário cadastro nem aprovação.
Instale e autentique-se diretamente pelo seu MCP Client.

Planos Enterprise

Entre em contato com seu admin para ativar o Miro MCP para sua organização.
Seu admin também pode limitar o MCP a times específicos e grupos de usuários. Se isso acontecer, você precisa estar em um time selecionado e (quando grupos de usuários estiverem definidos) em um grupo de usuários permitido.
Depois que for ativado para você, você pode se conectar pelo seu MCP Client.
Se seu admin ativou a autorização gerenciada pela empresa para Claude, Claude se conecta por meio do provedor de identidade da sua empresa em vez do fluxo de autenticação OAuth usual da Miro. Você ainda precisa ser membro do time padrão que seu admin selecionou para a autorização gerenciada pela empresa.

Em planos Enterprise, a conexão pode falhar se o admin não habilitou o MCP, não incluiu você no controle de acesso Times e grupos de usuários ou não permitiu esse cliente específico. Entre em contato com seu admin se não conseguir se conectar.

Autorizando o Servidor MCP da Miro

A maioria dos clientes MCP autoriza via OAuth:

Abra sua ferramenta de IA. Por exemplo, no Lovable: Configurações > Integrações > Servidor MCP da Miro > Conectar.
Siga o fluxo de autenticação OAuth.
Selecione o time onde seus boards estão localizados.

O MCP Server da Miro só poderá ler os boards do time que você selecionar durante o fluxo OAuth.

Em planos Enterprise, se seu admin configurou autorização gerenciada pela empresa para o Claude, os usuários do Claude não completam esse fluxo OAuth da Miro. O acesso vem do seu provedor de identidade e do time padrão configurado no console de admin. Veja Configurar autorização gerenciada pela empresa para Miro MCP.

Conectando o MCP Server da Miro à sua ferramenta de IA

Depois que o MCP Server da Miro for ativado para sua organização ou time, você pode configurá-lo no cliente MCP de sua preferência.

Instalação em um passo

A maioria dos MCP Clients oferece um processo de instalação simplificado:

Abra sua ferramenta de IA (como Cursor, VSCode ou Lovable).
Acesse as configurações de MCP ou de integração.
Localize e selecione "Miro" ou "Add MCP Server."
Digite https://mcp.miro.com quando solicitado.
Conclua o fluxo de autenticação OAuth.
Selecione o time em que deseja usar o Miro MCP.

Certifique-se de selecionar o mesmo time onde seus boards estão localizados.

Instalação manual

Algumas ferramentas exigem configuração manual:

Abra as configurações ou a área de configuração do seu MCP Client.
Encontre a seção de configuração do MCP.
Adicione a seguinte configuração JSON:

{
  "mcpServers": {
    "miro-mcp": {
      "url": "https://mcp.miro.com/",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Salve as alterações e conclua a autenticação pelo fluxo OAuth.

Verificando se o MCP está ativo

Após habilitar o MCP, verifique se está funcionando:

Tentar conectar uma ferramenta compatível com MCP, como Cursor ou VSCode.
Seguir o fluxo de autenticação OAuth.
Testar um prompt simples que use a funcionalidade do Miro MCP.

Alguns clientes MCP podem exigir autenticação adicional com seus respectivos serviços.

Guias específicos por ferramenta

Para instruções detalhadas de instalação para ferramentas específicas, consulte nossa documentação para desenvolvedores: