Saltar al contenido principal

Descripción general de la API y el MCP de Read AI

Actualización

Read AI ofrece tanto una API REST como un servidor MCP (Model Context Protocol), lo que te proporciona acceso mediante programación y mediante agentes a datos de reuniones, como transcripciones, resúmenes y tareas pendientes. Además de integrarte directamente con la API, puedes conectar aplicaciones y plataformas de IA de terceros (como ChatGPT, Claude y otras herramientas basadas en LLM) como clientes MCP, para que puedan consultar y trabajar con tus datos de reuniones de Read AI.

Requisitos previos

El servidor MCP y la API están disponibles en todos los planes, incluido el plan gratuito. La única restricción es que, si perteneces a un espacio de trabajo, la opción Descargas debe estar habilitada en Configuración del espacio de trabajo > Informes y uso compartido:

Primeros pasos

Para la mayoría de las personas, la forma más sencilla de comenzar es conectar una herramienta de IA que ya uses al servidor MCP de Read AI. A continuación, puedes acceder a tus notas y transcripciones de reuniones de Read AI y administrarlas directamente desde esa herramienta. Consulta la guía de configuración de tu herramienta:

También encontrarás Claude, ChatGPT, Gamma y MCP («Conectar Read AI a cualquier cliente compatible con MCP») en Productividad, en tu página de Integraciones. Para Claude, haz clic en Conectar en Claude o busca «Read AI» en el directorio de conectores de Claude. Para ChatGPT, haz clic en Conectar en ChatGPT o busca «Read AI» en el directorio de complementos de ChatGPT; después, haz clic en Instalar complemento y Permitir acceso. Para otros clientes compatibles con MCP (como VS Code, Cursor o Microsoft Copilot Studio), haz clic en Ver documentación en la tarjeta de MCP.

Para obtener ideas sobre qué hacer una vez que te hayas conectado, consulta ¿Qué puedes hacer con el servidor MCP de Read AI? Para consultar las herramientas disponibles y otras formas de conectarte, visita Servidor MCP.

Si eres desarrollador o quieres crear una integración de software más tradicional con Read AI, consulta Claves de API y autenticación para configurar el acceso OAuth a la API (Read AI utiliza tokens de acceso OAuth, no claves de API estáticas), y Referencia de la API para saber qué puede hacer la API y cómo llamarla.

Solución de problemas

Si tienes problemas, primero asegúrate de haber leído los artículos relevantes en Seguir leyendo. Los problemas y las limitaciones más comunes son:

  • Administración de tokens de acceso (solo API): Los tokens de acceso caducan después de 10 minutos. Los tokens de actualización duran aproximadamente 6 meses (182,5 días) y son de un solo uso: cada actualización devuelve un token de actualización nuevo, así que guarda siempre el más reciente y deja de usar el anterior. El token de actualización anterior sigue funcionando durante un breve período de gracia, de hasta 10 minutos después de emitir el token nuevo o 5 usos adicionales, lo que ocurra primero. Esto cubre las solicitudes simultáneas y las llamadas de actualización que fallan (por ejemplo, con un error 5xx o un tiempo de espera agotado). Después de eso, el token anterior se rechaza. Esta es una configuración estándar de OAuth 2.1, pero los desarrolladores acostumbrados a las claves de API estáticas de larga duración pueden encontrar estos tokens más difíciles de administrar. Sigue cuidadosamente los pasos de Claves de API y autenticación, incluidos los consejos para solucionar problemas que aparecen al final.
  • 401 No autorizado al actualizar tokens (solo API): El punto de conexión de tokens espera que el ID y el secreto de tu cliente estén en el formato que elegiste con token_endpoint_auth_method al registrar el cliente. Con client_secret_basic (que se utiliza en el ejemplo de registro de Claves de API y autenticación), envíalos en un encabezado de autenticación HTTP Basic. También se admite client_secret_post: registra el cliente con ese método y, después, envía client_id y client_secret como campos de formulario en el cuerpo de la solicitud. Para cambiar de método, registra un cliente nuevo y completa de nuevo el flujo de autorización, ya que los tokens de un cliente no funcionan con otro. Un error 401 también puede significar que el token de actualización fue reemplazado y que su período de gracia terminó, así que asegúrate de utilizar el más reciente.
  • Límites de velocidad: La API permite hasta 100 solicitudes por minuto por usuario. Superar este límite devuelve errores HTTP 429; presta atención a esta respuesta y reduce la velocidad de tus llamadas cuando la recibas.
  • Redirección de SSO: Puedes autenticarte mediante SSO, pero algunos usuarios han informado que no se les redirige de vuelta al flujo de OAuth después de iniciar sesión con el SSO de su organización (SAML). Si esto sucede, reinicia el proceso de OAuth después de iniciar sesión y debería funcionar.
  • Transcripción en directo: Los datos de reuniones en directo, incluida la transcripción en directo, están disponibles mediante la API y el servidor MCP, pero de forma predeterminada solo están disponibles para una reunión si alguien tiene abierto el panel de reuniones en directo durante la reunión. Si quieres que la transcripción en directo se active automáticamente para todas tus reuniones, contacta con el equipo de soporte.
  • Permisos: Solo puedes recuperar datos de los informes de reuniones a los que tienes acceso en la aplicación web de Read AI. Los administradores deben activar el acceso global a los informes para acceder a todos los informes de un espacio de trabajo.

Comentarios y mejoras

Si tienes sugerencias o necesitas ayuda, ponte en contacto con nuestro equipo de soporte. Siempre agradecemos los comentarios sobre la experiencia de los desarrolladores. Seguiremos añadiendo nuevas herramientas MCP y puntos de conexión de la API, y tus comentarios nos ayudan a decidir qué crear.

Seguir leyendo

Para consultar las instrucciones de configuración, la referencia de la API y las guías de MCP, visita:

Artículos relacionados