O servidor MCP do Read AI é um servidor remoto do Model Context Protocol que fornece aos assistentes de IA acesso padronizado aos seus dados e recursos de reuniões do 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, implantar um agente de reuniões do Read AI para gravar uma chamada de vídeo do Teams, Zoom ou Meet e compartilhar seus relatórios de reuniões com outras pessoas.
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 | HTTP transmitível |
| Autenticação | OAuth 2.0 |
O Copilot Studio é compatível com o tipo de transporte transmitível, que é o utilizado pelo servidor MCP do Read AI.
O servidor do Read AI é compatível com o Registro Dinâmico de Clientes do 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 localiza e registra tudo para você. 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.
Adicione o servidor MCP do Read AI ao seu agente
Recomendamos usar o assistente de integração do MCP do Copilot Studio. É o caminho mais rápido e não exige um arquivo de esquema OpenAPI.
Etapa 1: Abra o assistente de integração do MCP
- No Microsoft Copilot Studio, abra o agente ao qual você deseja conectar o 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 do MCP.
Etapa 2: Insira 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 durante a 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
Etapa 3: Escolha o tipo de autenticação
- Em Autenticação, selecione OAuth 2.0.
- Para o tipo de 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 localiza automaticamente os endpoints necessários e registra-se com o 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: Crie o servidor e conecte-se
- 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, as seguintes ferramentas do Read AI estarão disponíveis para o seu agente:
| Ferramenta |
O que ela faz
|
|---|---|
| Obter reunião por ID | Recupera os detalhes completos da reunião — metadados, participantes, resumo, divisão por capítulos, itens de ação, perguntas principais, tópicos, transcrição completa com identificação dos oradores, métricas e URLs para download da gravação. |
| Listar reuniões | Navega pelas reuniões recentes (até 10 por página), com filtragem por intervalo de datas e paginação. |
| 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. |
| Compartilhar relatório da reunião | Concede a alguém acesso a um relatório de reunião específico no nível de permissão escolhido (Visualizador, somente recapitulação; Visualizador, completo; ou Editor), com um convite por e-mail e uma mensagem pessoal opcionais. |
Verifique 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 adequada.
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 reuniões
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 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.
Artigos relacionados
- Servidor MCP — detalhes do servidor, clientes compatíveis e a referência completa das ferramentas
- Adicionar um servidor MCP existente a um agente — documentação da Microsoft, incluindo a alternativa de conector personalizado
Ainda com dificuldades? Entre em contato com o suporte do Read AI e ajudaremos você a se conectar.