Conectar o servidor MCP do Read AI ao Microsoft Copilot Studio – Central de Suporte

O servidor MCP do Read AI é um servidor remoto do Model Context Protocol que fornece aos assistentes de IA acesso padronizado aos dados e recursos das suas reuniões no Read AI. Este artigo explica como adicioná-lo a um agente no Microsoft Copilot Studio como uma conexão MCP personalizada.

Depois de conectado, seu agente do Copilot Studio poderá navegar pelas reuniões recentes, acessar suas transcrições e outros detalhes das reuniões, pesquisar reuniões por tópico, implantar um agente de reuniões do Read AI para gravar uma chamada de vídeo do Teams, Zoom ou Meet, organizar reuniões em pastas e compartilhar seus relatórios de reuniões com outras pessoas.

Reuniões do Zoom: o Read só poderá entrar em uma reunião do Zoom se você tiver conectado sua conta do Zoom ao Read e estiver na reunião, conectado a essa mesma conta do Zoom. Consulte Próximas mudanças nas reuniões do Zoom.

Antes de começar

Você precisará de:

Uma conta do Read AI. Você fará login com ela durante a configuração, e o agente só poderá acessar reuniões e relatórios que sua conta já tenha permissão para visualizar.
Acesso ao Microsoft Copilot Studio, com um agente já criado (ou permissão para criar um).
Permissão para adicionar ferramentas a esse agente. Em muitas organizações, adicionar um novo conector exige uma função de criador do ambiente ou de administrador. Se a opção Adicionar uma ferramenta não estiver disponível para você, consulte o administrador do Power Platform.

Detalhes do servidor MCP do Read AI

Você inserirá estes valores no assistente de configuração do Copilot Studio:

Campo	Valor
URL do servidor	https://api.read.ai/mcp
Transporte	Streamable HTTP
Autenticação	OAuth 2.0

Usuários da UE: use https://prod-eu-api.read.ai/mcp como a URL do servidor.

O Copilot Studio é compatível com o tipo de transporte Streamable, usado pelo servidor MCP do Read AI.

O servidor do Read AI é compatível com o Registro dinâmico de clientes OAuth (DCR) com descoberta, portanto, você não precisará criar um ID de cliente, um segredo de cliente nem inserir URLs de autorização ou de token. A opção OAuth 2.0 → Descoberta dinâmica do Copilot Studio encontra e registra tudo automaticamente. O Copilot Studio identifica essa opção como "OAuth 2.0"; ela funciona com a implementação OAuth 2.1 do servidor do Read AI.

Adicionar o servidor MCP do Read AI ao seu agente

Recomendamos usar o assistente de integração MCP do Copilot Studio. É o caminho mais rápido e não exige um arquivo de esquema OpenAPI.

Etapa 1: abrir o assistente de integração MCP

No Microsoft Copilot Studio, abra o agente que você deseja conectar ao Read AI.
Acesse a página Ferramentas desse agente.
Selecione Adicionar uma ferramenta.
Selecione Nova ferramenta.
Selecione Model Context Protocol, que abrirá o assistente de integração MCP.

Etapa 2: inserir os detalhes do servidor

Preencha os três campos obrigatórios:

Nome do servidor: por exemplo, Read AI.
Descrição do servidor: uma descrição breve e clara do que o servidor faz. O orquestrador do seu agente usa essa informação em tempo de execução para decidir quando chamar o Read AI, portanto, seja específico. Por exemplo: Fornece acesso a gravações, transcrições, resumos, itens de ação e relatórios de reuniões do Read AI. Também pode implantar um agente de reuniões do Read AI em uma reunião agendada e compartilhar relatórios de reuniões com outras pessoas.
URL do servidor: https://api.read.ai/mcp (usuários da UE: https://prod-eu-api.read.ai/mcp)

Etapa 3: escolher o tipo de autenticação

Em Autenticação, selecione OAuth 2.0.
Para o tipo OAuth 2.0, selecione Descoberta dinâmica.

Você não precisa inserir um ID de cliente, um segredo de cliente, uma URL de autorização ou uma URL de token. Com a descoberta dinâmica, o Copilot Studio encontra automaticamente os endpoints necessários e se registra no provedor de identidade do Read AI.

Dica: se você vir campos solicitando uma URL de autorização ou credenciais do cliente, selecionou Dinâmico ou Manual em vez de Descoberta dinâmica. Volte e escolha Descoberta dinâmica.

Etapa 4: criar o servidor e conectar

Selecione Criar.
Selecione Avançar para continuar até a caixa de diálogo Adicionar ferramenta.
Escolha Criar uma nova conexão para o servidor MCP do Read AI.
Quando solicitado, faça login com sua conta do Read AI e revise o acesso solicitado. Aprove-o para concluir a conexão.
Selecione Adicionar ao agente.

O servidor MCP do Read AI agora aparece na página Ferramentas do seu agente.

O que seu agente pode fazer

Depois de conectado, seu agente poderá usar todas as ferramentas do servidor MCP do Read AI. Para obter todos os detalhes sobre cada ferramenta, consulte a referência de ferramentas do servidor MCP.

Ferramenta	O que ela faz
Obter reunião por ID	Recupera todos os detalhes da reunião: metadados, participantes, resumo, resumos dos capítulos, itens de ação, perguntas principais, tópicos, transcrição completa com identificação dos oradores, métricas e uma URL para baixar a gravação.
Listar reuniões	Navega pelas reuniões recentes (até 10 por página), com filtragem por intervalo de datas e paginação.
Pesquisar reuniões	Encontra reuniões pelo que foi discutido nelas, usando uma consulta em linguagem natural, e explica por que cada uma corresponde à pesquisa.
Criar agente de reunião	Implanta um bot do Read AI em uma reunião do Zoom, Google Meet ou Microsoft Teams. Aceita uma URL de reunião ou a plataforma, o ID da reunião e uma senha opcional. É compatível com agendamento opcional e um título personalizado. No caso do Zoom, o Read só poderá entrar se você tiver conectado sua conta do Zoom ao Read e estiver na reunião, conectado a essa mesma conta do Zoom.
Compartilhar relatório da reunião	Concede a alguém acesso a um relatório de reunião específico com um nível de permissão escolhido (Visualizador, somente resumo; Visualizador completo; ou Editor), com um convite por e-mail e uma mensagem pessoal opcionais.
Ferramentas de pastas	Lista pastas, obtém detalhes das pastas, lista as reuniões em uma pasta, cria, atualiza e exclui pastas, adiciona ou remove reuniões e compartilha pastas compartilhadas com outras pessoas.

Verificar a conexão

Teste o agente antes de disponibilizá-lo:

Abra o painel de teste do seu agente no Copilot Studio.
Faça uma pergunta que exija dados do Read AI, por exemplo, "Liste minhas reuniões mais recentes do Read AI."
Confirme se o agente chama a ferramenta do Read AI e retorna suas reuniões.

Se o agente responder sem chamar o Read AI, torne mais específica a descrição do servidor inserida na Etapa 2 para que o orquestrador consiga identificar quando o Read AI é a fonte apropriada.

Solução de problemas

"Adicionar uma ferramenta" ou "Model Context Protocol" não está disponível

Sua conta pode não ter permissão para adicionar ferramentas neste ambiente. Entre em contato com o administrador do Power Platform ou do Copilot Studio.

O login falha ou a conexão não é autorizada

Confirme se você está fazendo login com a conta do Read AI que tem acesso às reuniões esperadas e se os pop-ups não estão bloqueados no navegador. Em seguida, exclua a conexão e crie uma nova na caixa de diálogo Adicionar ferramenta.

A conexão é criada, mas o agente não retorna nenhuma reunião

O agente só pode ver o que sua conta do Read AI pode ver. Verifique se a conta conectada é participante das reuniões em questão ou se recebeu acesso a elas.

O agente não chama o Read AI quando deveria

Reescreva a Descrição do servidor para especificar melhor os tipos de perguntas que o Read AI pode responder. O orquestrador usa essa descrição para encaminhar as solicitações.

Sua organização bloqueia a conexão

O Copilot Studio acessa servidores MCP por meio de conectores do Power Platform, portanto, qualquer política de dados do Power Platform também rege o acesso ao servidor MCP do Read AI e às suas ferramentas. Se o conector estiver bloqueado, o administrador precisará ajustar a política de prevenção contra perda de dados aplicável.