O servidor MCP do Read AI é um servidor MCP remoto (Model Context Protocol) que permite que assistentes de IA acessem os recursos do Read AI por meio de uma interface padronizada. Atualmente, ele está disponível como uma versão beta aberta.
⚠️ Antes de começar, certifique-se de revisar os pré-requisitos em Visão geral da API e do MCP do Read AI.
Detalhes do servidor
Você precisará destes detalhes se estiver configurando uma conexão personalizada com o servidor MCP. Você não precisa deles se estiver se conectando com o plugin do ChatGPT ou o conector do Claude.
-
URI do servidor:
https://api.read.ai/mcp - Autenticação: OAuth 2.1 (faça login usando sua conta do Read AI)
- Tipo: servidor MCP remoto
- Transporte: HTTP transmitível
Se você for um usuário da UE, precisará configurar um conector personalizado para o Claude ou um servidor MCP personalizado para o ChatGPT usando estes detalhes:
-
URI do servidor:
https://prod-eu-api.read.ai/mcp - Autenticação: OAuth 2.1 (faça login usando sua conta do Read AI)
- Tipo: servidor MCP remoto
- Transporte: HTTP transmitível
Clientes MCP compatíveis
O servidor MCP do Read AI é compatível com vários clientes MCP, incluindo:
- ChatGPT e Codex
- Claude (Desktop, Web e Code)
- Microsoft Copilot Studio
- Gamma
- Outros clientes compatíveis com MCP (por exemplo, VS Code ou Cursor). No Read, o cartão MCP na página Integrações (em Produtividade) contém um link para a documentação de configuração por meio de Ver documentação.
Ferramentas disponíveis
Para ver exemplos do que você pode fazer com estas ferramentas, consulte O que você pode fazer com o servidor MCP do Read AI?
Depois de conectado, o servidor MCP do Read AI fornece as seguintes ferramentas para encontrar, analisar, organizar e compartilhar os dados das suas reuniões. O nome oficial de cada ferramenta, que seu assistente de IA usa para chamá-la, está listado abaixo do respectivo título.
Ferramentas de reuniões
Listar reuniões
Nome da ferramenta: list_meetings
Explore e filtre seu histórico de reuniões com filtragem por intervalo de datas e suporte à paginação.
O que você pode fazer:
- Explorar reuniões recentes (até 10 por página)
- Filtrar reuniões por intervalo de datas
- Paginar grandes coleções de reuniões
- Inclui as mesmas informações detalhadas que Obter reunião por ID (metadados básicos, resumo, resumos de capítulos, itens de ação, perguntas principais, tópicos, transcrição, métricas e download da gravação) para cada reunião da lista
Pesquisar reuniões
Nome da ferramenta: search_meeting_agent
Encontre reuniões pelo que foi discutido nelas, e não por quando aconteceram. Descreva o que você está procurando em linguagem simples, e um agente de pesquisa encontrará as reuniões mais relevantes e explicará por que cada uma corresponde à pesquisa.
Para pesquisar, forneça:
- Consulta: o que você deseja encontrar, por exemplo, "discussões nas quais a mudança de preços do terceiro trimestre foi decidida"
Opcional:
- Intervalo de datas: considerar apenas reuniões iniciadas dentro de um período específico
- Limite: o número máximo de reuniões a retornar (o padrão é 5, até 10)
- Tempo disponível: por quanto tempo a pesquisa pode ser executada, de 20 a 90 segundos (o padrão é 45)
O que você recebe:
- O título, o horário de início e a URL do relatório de cada reunião correspondente
- Uma explicação de uma frase sobre por que a reunião é relevante
- Um trecho de apoio da transcrição da reunião
É bom saber:
- A pesquisa é detalhada, mas mais lenta do que outras ferramentas, normalmente levando de 20 a 60 segundos.
- A pesquisa encontra reuniões; ela não responde a perguntas sobre elas. Seu assistente de IA pode usar Obter reunião por ID nos resultados para ler resumos, itens de ação ou transcrições completas.
- Apenas reuniões dos últimos 12 meses, aproximadamente, podem ser pesquisadas.
- Como a pesquisa é realizada por um agente, executar a mesma consulta duas vezes pode retornar resultados ligeiramente diferentes.
Obter reunião por ID
Nome da ferramenta: get_meeting_by_id
Recupere informações abrangentes sobre uma reunião específica usando o ID da reunião.
O que você pode recuperar:
- Metadados básicos (título, horários de início e término, plataforma, URL do relatório)
- Participantes com status de presença
- Resumo
- Resumos de capítulos
- Itens de ação
- Perguntas principais
- Tópicos
- Transcrição completa com identificação dos participantes
- Métricas
- URL para baixar a gravação da reunião como arquivo MP4
Compartilhar relatório da reunião
Nome da ferramenta: share_meeting_report
Conceda a outra pessoa acesso a um relatório de reunião específico e, opcionalmente, envie um convite por e-mail.
Para compartilhar um relatório, forneça:
- ID da reunião: o ID do relatório que você deseja compartilhar
- Endereço de e-mail: o e-mail do destinatário. Se ele já tiver uma conta do Read AI, o acesso será concedido diretamente; caso contrário, um convite por e-mail será criado para ele.
Opcional:
-
Nível de acesso: controla o que o destinatário pode ver e fazer:
- Visualizador (apenas recapitulação): apenas resumo/recapitulação
- Visualizador (completo): acesso completo de leitura ao relatório
- Editor: acesso de leitura, além da possibilidade de editar e compartilhar novamente
- O padrão é acesso completo de visualizador, se não for especificado.
- Mensagem: uma observação pessoal incluída no e-mail de convite
- Notificar: se deve enviar um e-mail notificando o destinatário (o padrão é sim; defina como não para conceder acesso sem enviar notificação)
É bom saber:
- Somente editores e proprietários de uma reunião podem compartilhá-la. Os visualizadores não podem compartilhar relatórios, e a ação falhará se for tentada.
- A propriedade em si não pode ser transferida por meio desta ferramenta; apenas o acesso de visualizador ou editor pode ser concedido.
- Compartilhar novamente com a mesma pessoa no mesmo nível de acesso é seguro; isso não enviará um convite duplicado nem criará uma concessão duplicada.
Criar agente de reunião
Nome da ferramenta: create_meeting_agent
Envie um agente de reunião do Read AI (bot) para uma reunião por videoconferência em seu nome. Ele funciona com Zoom, Google Meet e Microsoft Teams.
Reuniões do Zoom: o Read só pode participar de uma reunião do Zoom se você tiver conectado sua conta do Zoom ao Read e estiver na reunião, conectado à mesma conta do Zoom. Consulte Próximas mudanças nas reuniões do Zoom.
Para enviar um agente, forneça:
- URL da reunião: o link completo para participar (por exemplo, um link do Zoom ou uma URL do Google Meet). A plataforma, o ID da reunião e a senha (se incluída no link) são analisados automaticamente.
Ou, se preferir especificar manualmente:
- Plataforma: Zoom, Google Meet ou Microsoft Teams
- ID da reunião: o ID específico da plataforma (número da reunião do Zoom, código do Meet etc.)
- Senha: somente se a reunião exigir uma
Opcional:
- Horário de início: agende o agente para participar em um horário futuro. Se omitido, ele participará imediatamente.
- Título: um nome personalizado para o relatório da reunião. Se omitido, tentaremos gerar um título descritivo com base na transcrição.
É bom saber:
- Se um agente já tiver sido enviado para a mesma reunião, solicitá-lo novamente não criará uma duplicata; você receberá o registro de reunião existente.
- Quando a reunião estiver em andamento ou concluída, os dados dela (resumo, transcrição, itens de ação etc.) ficarão disponíveis no relatório da reunião.
- Os agentes só podem ser enviados para reuniões que você especificou explicitamente, e não para IDs de reuniões presumidos ou inferidos.
Ferramentas de pastas
Listar pastas
Nome da ferramenta: list_folders
Veja todas as pastas às quais você tem acesso, incluindo suas pastas pessoais (chamadas de "privadas" pelo servidor MCP), pastas compartilhadas com você e Pastas inteligentes que o Read AI cria para você (chamadas de pastas "automáticas" pelo servidor MCP).
O que você pode fazer:
- Encontrar uma pasta pelo nome
- Filtrar por tipo de pasta: privada, compartilhada ou automática
- Ordenar por sua ordem personalizada, nome, data de criação, data de atualização ou atividade mais recente de reunião
- Ver o nome, a cor, o ícone, a descrição, o número de reuniões e seu nível de acesso de cada pasta
É bom saber:
- Todas as suas pastas são retornadas de uma só vez; não há paginação.
- Para ver as reuniões dentro de uma pasta, use Listar itens da pasta.
Obter pasta
Nome da ferramenta: get_folder
Recupere os detalhes de uma pasta específica usando o ID da pasta.
O que você pode recuperar:
- Nome, cor, ícone e descrição
- Tipo de pasta (privada, compartilhada ou automática)
- Número de reuniões na pasta
- Seu nível de acesso à pasta
- Para pastas compartilhadas, o nível de acesso que os membros têm às reuniões na pasta
- Datas de criação, atualização e última atividade
É bom saber:
- Para ver as reuniões dentro da pasta, use Listar itens da pasta.
Listar itens da pasta
Nome da ferramenta: list_folder_items
Explore as reuniões em uma pasta específica, com suporte à paginação.
O que você pode fazer:
- Ver as reuniões em uma pasta (até 10 por página)
- Paginar pastas com muitas reuniões
- Inclui as mesmas informações detalhadas que Obter reunião por ID (metadados básicos, resumo, resumos de capítulos, itens de ação, perguntas principais, tópicos, transcrição, métricas e download da gravação) para cada reunião da lista
É bom saber:
- Você precisa ter acesso para visualizar a pasta.
Criar pasta
Nome da ferramenta: create_folder
Crie uma nova pasta pessoal (privada) ou compartilhada para organizar suas reuniões.
Para criar uma pasta, forneça:
- Nome: até 100 caracteres
- Cor: cinza, rosa, vermelho-alaranjado, verde, verde-amarelado, azul-petróleo, azul ou índigo
Opcional:
- Ícone: pasta, raio, lâmpada, estrela, pintura, código, pasta, prédio, troféu, béquer, marcador, bandeira, coração, foguete, balão de fala ou tendência de alta
- Descrição: até 1.000 caracteres
- Tipo de pasta: privada (o padrão) ou compartilhada
- Nível de acesso dos membros: somente para pastas compartilhadas. Controla se os membros da pasta terão acesso de visualizador ou editor às reuniões adicionadas à pasta (o padrão é visualizador).
É bom saber:
- Você é o proprietário de qualquer pasta que criar. Para convidar outras pessoas para uma pasta compartilhada, use Compartilhar pasta.
- Cada solicitação cria uma nova pasta, mesmo que já exista uma com o mesmo nome.
- As Pastas inteligentes (pastas automáticas) são criadas pelo Read AI e não podem ser criadas manualmente.
Atualizar pasta
Nome da ferramenta: update_folder
Altere o nome, a cor, o ícone ou a descrição de uma pasta existente.
Para atualizar uma pasta, forneça:
- ID da pasta: a pasta que você deseja alterar
- Qualquer um dos seguintes: nome, cor, ícone, descrição ou (para pastas compartilhadas) nível de acesso dos membros
É bom saber:
- Somente os campos fornecidos são alterados; todo o restante permanece igual.
- Um ícone ou uma descrição pode ser alterado, mas não removido.
- Você precisa ter acesso de edição à pasta: ser proprietário para pastas privadas, ou proprietário ou editor para pastas compartilhadas.
- As Pastas inteligentes (pastas automáticas) não podem ser editadas.
- Você não pode alternar uma pasta entre privada e compartilhada por meio do servidor MCP. Para converter uma pasta pessoal em uma pasta compartilhada, use o aplicativo Read (consulte Converter uma pasta pessoal em uma pasta compartilhada).
Adicionar reuniões à pasta
Nome da ferramenta: add_folder_items
Adicione uma ou mais reuniões a uma pasta existente.
Para adicionar reuniões, forneça:
- ID da pasta: a pasta à qual adicionar reuniões
- IDs das reuniões: uma ou mais reuniões para adicionar
Opcional:
- Incluir série recorrente: para qualquer reunião que faça parte de uma série recorrente, adicionar também todas as outras reuniões da série. Isso é definido por reunião, portanto, você pode combinar reuniões recorrentes e únicas em uma única solicitação.
É bom saber:
- Você precisa ter acesso de edição à pasta: ser proprietário para pastas privadas, ou proprietário ou editor para pastas compartilhadas.
- Você precisa ter pelo menos acesso de visualizador a cada reunião adicionada, ou acesso de editor se a pasta for compartilhada.
- Se você não tiver acesso suficiente a qualquer uma das reuniões, toda a solicitação falhará.
- As reuniões que não existem mais são ignoradas.
- Adicionar uma reunião que já esteja na pasta não causa nenhum efeito.
Remover reuniões da pasta
Nome da ferramenta: remove_folder_items
Remova uma ou mais reuniões de uma pasta.
Para remover reuniões, forneça:
- ID da pasta: a pasta da qual remover reuniões
- IDs das reuniões: uma ou mais reuniões para remover
Opcional:
- Incluir série recorrente: para qualquer reunião que faça parte de uma série recorrente, remover também todas as outras reuniões da série. Isso é definido por reunião.
É bom saber:
- As reuniões são apenas removidas da pasta; elas não são excluídas.
- Você precisa ter acesso de edição à pasta. Para pastas compartilhadas, também funciona ser proprietário de todas as reuniões que você está removendo.
- As reuniões que não estão na pasta são ignoradas.
Compartilhar pasta
Nome da ferramenta: share_folder
Conceda a outra pessoa acesso a uma de suas pastas compartilhadas e, opcionalmente, envie um convite por e-mail.
Para compartilhar uma pasta, forneça:
- ID da pasta: a pasta compartilhada que você deseja compartilhar
- Endereço de e-mail: o e-mail do destinatário
Opcional:
-
Nível de acesso: controla o que o destinatário pode fazer:
- Visualizador: pode ver a pasta e suas reuniões
- Editor: também pode adicionar e remover reuniões
- O padrão é visualizador, se não for especificado.
- Mensagem: uma observação pessoal incluída no e-mail de convite
- Notificar: se deve enviar um e-mail notificando o destinatário (o padrão é sim; defina como não para conceder acesso sem enviar notificação)
É bom saber:
- Somente pastas compartilhadas podem ser compartilhadas. Você não pode converter uma pasta pessoal (privada) em uma pasta compartilhada por meio do servidor MCP. Converta-a no aplicativo Read (consulte Converter uma pasta pessoal em uma pasta compartilhada) ou crie uma nova pasta compartilhada e adicione as mesmas reuniões a ela.
- Você precisa ter acesso de edição à pasta (ser proprietário ou editor) para compartilhá-la.
- A propriedade não pode ser transferida; apenas o acesso de visualizador ou editor pode ser concedido.
- Compartilhar novamente com a mesma pessoa no mesmo nível de acesso não criará uma concessão duplicada. No entanto, se o destinatário já tiver uma conta do Read AI e as notificações estiverem ativadas, ele poderá receber outro e-mail de notificação.
Excluir pasta
Nome da ferramenta: delete_folder
Exclua permanentemente uma pasta.
Para excluir uma pasta, forneça:
- ID da pasta: a pasta que você deseja excluir
É bom saber:
- A exclusão de uma pasta não pode ser desfeita.
- Somente a pasta é excluída. As reuniões nela não são afetadas e continuam totalmente acessíveis.
- Excluir uma pasta compartilhada a remove para todas as pessoas com quem ela é compartilhada, não apenas para você.
- Somente o proprietário da pasta pode excluí-la.