O Read AI oferece uma API REST e um servidor MCP (Model Context Protocol), permitindo acesso programático e baseado em agentes a dados de reuniões, como transcrições, resumos e itens de ação. Além da integração direta com a API, os usuários podem conectar aplicativos e plataformas de IA de terceiros (como ChatGPT, Claude e outras ferramentas baseadas em LLM) como clientes MCP, permitindo que esses sistemas consultem e interajam perfeitamente com os dados de reuniões do Read AI.
Pré-requisitos
O servidor MCP e a API estão disponíveis para usuários de todos os planos, incluindo o plano gratuito. A única restrição é que, se você pertencer a um workspace, ele deverá ter a opção Downloads ativada em Configurações do workspace > Relatórios e compartilhamento:
Primeiros passos
Para a maioria dos usuários, a maneira mais fácil de começar é usar o servidor MCP por meio do plugin do ChatGPT oficial do Read AI ou do conector do Claude. Isso permitirá que você acesse e gerencie suas notas e transcrições de reuniões do Read AI diretamente pelo ChatGPT ou Claude. Para obter mais detalhes sobre as ferramentas disponíveis e outras maneiras de se conectar ao servidor MCP, consulte a documentação do servidor MCP.
Para desenvolvedores ou qualquer pessoa que queira criar uma integração de software mais tradicional com o Read AI, consulte Chaves de API e autenticação (para configurar e gerenciar seu acesso à API) e a Referência da API (para saber quais recursos estão disponíveis e como chamar a API).
Solução de problemas
Se você encontrar algum problema, certifique-se de ter lido toda a documentação apropriada em Continue lendo abaixo. Dito isso, as armadilhas e limitações mais comuns são:
- Gerenciamento de tokens de acesso (somente API): Os tokens de acesso expiram após 10 minutos, e os tokens de atualização são de uso único e alternam a cada atualização (com um curto período de tolerância). Embora essa seja uma implementação padrão do fluxo OAuth 2.1, os desenvolvedores acostumados a trabalhar com chaves de API estáticas de longa duração podem considerar esses tokens mais difíceis de gerenciar. Siga cuidadosamente as etapas em Chaves de API e autenticação e as dicas de solução de problemas apresentadas ao final.
- Limites de taxa: A API aplica um limite de 100 solicitações por minuto por usuário. Exceder esse limite resultará em erros HTTP 429; você deve aguardar essa resposta e diminuir a frequência das chamadas quando isso ocorrer.
- Redirecionamento de SSO: Os usuários podem se autenticar usando SSO; no entanto, alguns usuários relataram não serem redirecionados corretamente de volta ao fluxo OAuth após fazer login com o SSO da organização (SAML). Se isso ocorrer, basta reiniciar o processo OAuth após fazer login, e ele deverá funcionar.
- Transcrição ao vivo: Embora a transcrição ao vivo esteja disponível pela API e pelo servidor MCP, por padrão ela não é ativada para uma reunião, a menos que alguém abra o painel ao vivo. Se quiser ativar automaticamente a transcrição ao vivo para todas as suas reuniões, entre em contato com o suporte.
- Permissões: Os usuários só podem recuperar dados de relatórios de reuniões aos quais tenham acesso no aplicativo web do Read AI. Os administradores devem ativar o acesso global aos relatórios para acessar todos os relatórios dentro de um workspace.
Comentários e melhorias
Se você tiver sugestões ou precisar de assistência, entre em contato com nossa equipe de suporte. Estamos sempre abertos a comentários para melhorar a experiência dos desenvolvedores e ampliar os recursos. Continuaremos adicionando novas ferramentas MCP e endpoints de API, e suas contribuições nos ajudam a saber o que criar.
Continue lendo
Para obter instruções detalhadas de configuração, a referência da API e guias de uso do MCP, acesse: