MCP, o Protocolo de Contexto de Modelo, es un estándar abierto que permite a las aplicaciones de IA conectarse a herramientas externas y orígenes de datos a través de un protocolo común. El servidor MCP de Revizto le permite conectar de forma segura sus herramientas de IA a los datos de su proyecto de Revizto. Una vez conectado, puede hacer preguntas, obtener información del proyecto y realizar acciones guiadas directamente desde el asistente de IA que elija.

• Requisitos
• Parámetros de conexión
• URLs del servidor MCP de Revizto
• Configuración de la conexión MCP
• Limitaciones
• Prácticas recomendadas
• Resolución de problemas

Ver también:

• Portal para desarrolladores de Revizto

Requisitos

Antes de conectarse al servidor MCP de Revizto, confirme que dispone de lo siguiente:

• Acceso a la región de Revizto donde se almacenan los datos de su proyecto.
• Acceso a una herramienta de IA compatible que pueda conectarse a servidores MCP remotos.
• La URL del servidor MCP de Revizto de su región.

También deberá asegurarse de que la aplicación Revizto MCP Server esté habilitada para su cuenta de la organización antes de añadir el servidor a su herramienta de IA. Para comprobar si la aplicación Revizto MCP Server está activa para su cuenta:

• Propietarios de la cuenta y administradores: Vaya a Gestionar información de la cuenta > Portal para desarrolladores.
• Usuarios estándar: Vaya a Información de la cuenta > Integraciones de la aplicación.

Si la aplicación Revizto MCP Server no está activa, pídale al propietario de la cuenta o al administrador que la active. Los propietarios de la cuenta y los administradores pueden habilitar la aplicación Revizto MCP Server desde el portal para desarrolladores siguiendo los pasos del ºPortal para desarrolladores de Revizto.

Para garantizar la seguridad de sus datos de Revizto, respete siempre las políticas internas de seguridad de su organización.

• Conéctese al servidor MCP de Revizto solo con herramientas de IA de confianza.
• Use la URL regional correcta del servidor MCP de Revizto.
• Mantenga las acciones de escritura sujetas a revisión. Pida al asistente de IA que muestre los cambios planificados antes de aplicarlos.
• El servidor MCP de Revizto utiliza sus derechos de acceso de Revizto. Las acciones administrativas requieren acceso a Revizto de nivel administrativo.
• Siga las políticas de uso de IA de su organización. Confirme qué herramientas de IA están aprobadas antes de conectar datos de Revizto.

Parámetros de conexión

El servidor MCP de Revizto utiliza Streamable HTTP para la conexión. Si bien los nombres de campos específicos pueden variar entre distintas plataformas de IA, los principales requisitos de conexión siguen siendo los mismos. Además, algunas herramientas de IA en la nube configuran servidores MCP como conectores personalizados. Para facilitar el proceso de autenticación, Revizto MCP utiliza el ID de cliente de OAuth. 

Consulte los valores de los parámetros en la tabla al configurar su conexión. 

Para los archivos de configuración, use esta estructura estándar de Streamable HTTP con la URL de su región:

{
  "mcpServers": {
    "<nombre de su servidor>": {
      "tipo": "http",
      "url": "https://api.<región del servidor>.revizto.com/mcp",
      "oauth": {
        "clientID": "revizto-mcp"
      }
    }
  }
}

URLs del servidor MCP de Revizto

Al conectar su herramienta de IA al servidor MCP de Revizto, deberá usar la URL del servidor MCP de la región donde están alojados sus datos de Revizto.

Si tiene cuentas de Revizto alojadas en distintas regiones, puede añadir más de un servidor MCP de Revizto a la misma herramienta de IA. Añada la URL del servidor MCP para cada región que use y luego autorice cada conexión. Después de eso, puede pedir al asistente de IA que trabaje en las regiones conectadas para realizar tareas como comparar recuentos de incidencias, resumir riesgos del proyecto o preparar un informe de coordinación entre regiones.

Esto permite que la herramienta de IA combine datos de múltiples conexiones regionales autorizadas en una sola conversación. Los datos de Revizto permanecen en su región original, y el asistente solo puede acceder a las cuentas, licencias y proyectos a los que su usuario de Revizto tiene permiso de acceso.

Configuración de la conexión MCP

Revizto MCP Server es un servidor MCP remoto que usa HTTPS. En las herramientas que piden un tipo de transporte, use Streamable HTTP o servidor MCP remoto.

Los pasos de configuración varían según la herramienta, pero el proceso típico es:

1. Abra la configuración de la herramienta.
2. En la configuración, busque conectores, aplicaciones, MCP, herramientas o integraciones.
3. Añada un nuevo conector personalizado, una aplicación personalizada o un servidor MCP.
4. Ubique la configuración de URL y proporcione la URL del servidor MCP de Revizto de su región.
5. Localice el campo ID de cliente de OAuth y proporcione el ID de cliente del MCP de Revizto.
6. Deje en blanco el secreto del cliente de OAuth.
7. Guarde la conexión.
8. Cuando se le pida autenticarse, inicie sesión en su cuenta de Revizto.
9. Pida al asistente de IA que enumere las herramientas de Revizto disponibles o confirme la conexión.

Según la herramienta de IA, es posible que se le pida iniciar sesión en su cuenta de Revizto inmediatamente después de añadir el servidor MCP o después de la primera petición que requiera datos de Revizto. Cuando comience la autenticación, su herramienta de IA abrirá una ventana de inicio de sesión de Revizto. Inicie sesión usando el método de autenticación requerido para su cuenta de Revizto, como correo electrónico y contraseña o SSO.

Tras la autorización, la herramienta de IA recibe acceso solo para el usuario de Revizto autenticado. Esto significa que seguirá la cuenta, la licencia y los derechos de acceso al proyecto de ese usuario y solo funcionará con los datos y las acciones permitidos para ese usuario.

Las secciones siguientes proporcionan detalles de configuración adicionales para herramientas de IA populares.

{
  "servers": {
    "<nombre de su servidor>": {
      "type": "http",
      "url": "https://api.<región del servidor>.revizto.com/mcp",
      "oauth": {
        "clientId": "MCP de Revizto"
      }
    }
  }
}

Para confirmar que la configuración funcionó correctamente, use el siguiente prompt: 

Comprueba mi conexión MCP de Revizto. Dígame a qué cuenta de Revizto y a qué región puede acceder, luego enumere las herramientas de Revizto disponibles en un lenguaje sencillo.

Si el asistente de IA indica que no puede acceder a Revizto, verifique lo siguiente:

• El servidor MCP de Revizto está activo para su cuenta. Los miembros de la cuenta estándar pueden consultar Integraciones de la aplicación. Los propietarios de la cuenta y los administradores pueden consultar el Portal para desarrolladores.
• Usted ha usado la URL regional correcta.
• Ha realizado el inicio de sesión de OAuth de Revizto.
• Su herramienta de IA es compatible con servidores MCP remotos.
• Su usuario de Revizto tiene acceso a la cuenta, la licencia y los proyectos sobre los que está consultando.

Limitaciones

Si bien el servidor MCP de Revizto cubre muchos flujos de trabajo de coordinación, existen algunos límites actuales a tener en cuenta.

• Las propiedades de modelos y objetos no se exponen a través de MCP, incluyendo la búsqueda de objetos, elementos modificados, lecturas de propiedades de objetos y el razonamiento incidencia-objeto. (¡Próximamente!)
• Las capturas de pantalla e imágenes no se exponen a través de MCP.
• Las suscripciones a eventos y los webhooks no se exponen a través de MCP.
• Los registros de proyectos, licencias y cuentas no se exponen a través de MCP.
• La importación y exportación de modelos no se exponen a través de MCP.
• Los proyectos grandes pueden requerir un filtrado cuidadoso para evitar respuestas de IA lentas o costosas.
• Algunas herramientas de IA tienen límites para el número de herramientas MCP que se pueden usar a la vez. Si faltan herramientas, deshabilite los servidores MCP no utilizados o las herramientas no utilizadas en su herramienta de IA.

Prácticas recomendadas

Después de configurar el servidor MCP de Revizto, su asistente de IA puede usar herramientas de Revizto para leer datos de coordinación como incidencias, comentarios, conflictos, planos, informes, flujos de trabajo, plantillas de sellos, licencias, proyectos y usuarios. Según sus derechos de acceso y la configuración de la versión final, el asistente también podría ayudar a preparar o aplicar actualizaciones seleccionadas.

El MCP de Revizto es útil para tres tipos de flujos de trabajo.

Los proyectos grandes pueden contener muchos datos. Comience con una consulta específica y luego haga preguntas de seguimiento. Esto hace que las respuestas sean más rápidas, claras y económicas en herramientas de IA que cobran por uso de tokens.

Para obtener mejores resultados, siga estos consejos:

• Empiece con un proyecto, disciplina, zona o persona asignada.
• Pida recuentos y resúmenes antes de solicitar listas largas.
• Pida al asistente que muestre los filtros que utilizó.
• Pida primero los 10 primeros ejemplos y luego amplíe si es necesario.
• Para acciones de escritura, incluya “espera la aprobación antes de aplicar los cambios” en su mensaje.
• Para proyectos grandes, evite consultas que pidan todas las incidencias, comentarios, conflictos y planos a la vez.
• Si el resultado parece sorprendente, pida al asistente que muestre los registros de origen que utilizó.

Para comenzar, prueba los siguientes prompts recomendados: 

• ¿Cuántos planos hay en <nombre del proyecto>?
• ¿Cuántas incidencias en estado crítico y abierto hay en <nombre del proyecto>?
• Reasigna las incidencias abiertas de <usuario a> a <usuario b> y agrega el comentario “reasignado por <usuario a>” en <nombre del proyecto>. 
• Cierra las incidencias en estado resuelto de <usuario a> creadas hace más de 30 días en <nombre del proyecto>.
• Establece una fecha límite para el próximo viernes para las incidencias abiertas de <usuario a> en <nombre del proyecto>.
• Mueve las incidencias abiertas de <usuario a> a En curso en <nombre del proyecto>. 
• Establece las incidencias abiertas de Ductwork vs Structure de <usuario a> como críticas en <nombre del proyecto>.

Resolución de problemas

P: La herramienta de IA no puede conectarse al servidor MCP de Revizto. 

R: Confirme que la URL regional sea correcta y que la herramienta de IA admita servidores MCP remotos. 

P:  Tengo varias cuentas de Revizto que usan diferentes métodos de autenticación SSO y el servidor MCP no se conectó a todas ellas. ¿Cómo realizo la autenticación para estas cuentas?

R: El servidor MCP de Revizto solo puede acceder a cuentas utilizando los métodos de autenticación usados durante el flujo de autorización más reciente. Para autorizar cuentas que usan un método de autenticación diferente, vaya a su perfil en Revizto Workspace y luego a Sesiones activas > API y autorice las cuentas necesarias.

P: La herramienta de IA me pide iniciar sesión de nuevo. 

R: Inicie sesión en Revizto. Si tiene varias cuentas de Revizto que usan métodos de autenticación SSO diferentes, autorice la cuenta necesaria desde su perfil en Revizto Workspace y luego en Sesiones activas > API.

P: El asistente de IA no puede ver un proyecto.

R: Confirme que la aplicación Revizto MCP Server esté activa para su cuenta, que haya iniciado sesión en la región correcta para el proyecto y que el usuario de Revizto autenticado tenga acceso a ese proyecto. Si es necesario activar el servidor MCP de Revizto, vuelva a autenticarse en la herramienta de IA para asegurarse de que la cuenta sea accesible mediante MCP. 

P: Algunas herramientas no están disponibles.

R: Su herramienta de IA puede limitar las herramientas activas o es posible que no tenga los derechos apropiados en Revizto para usar esas herramientas. 

P: Una acción de escritura falló. 

R: Confirme que su rol de Revizto permita esa acción en la cuenta, la licencia o el proyecto al que está escribiendo. 

P: La respuesta es lenta o demasiado costosa. 

R: Ajuste el prompt por proyecto, fecha, estado, persona asignada, zona, prioridad o límite de recuento. Consulte las prácticas recomendadas para obtener consejos adicionales.