> ## Documentation Index
> Fetch the complete documentation index at: https://revolai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ChatGPT, Claude y Gemini mediante MCP

> Conecta ChatGPT, Claude o Gemini CLI con Revol: OAuth, selección de empresas y herramientas, comprobación y revocación del acceso

Revol MCP permite trabajar con los datos de la empresa directamente desde ChatGPT, Claude o Gemini CLI. El asistente puede leer datos y realizar las operaciones a las que tienes acceso sobre conversaciones, leads, productos, agentes IA y analítica.

## Antes de conectar

* Inicia sesión en tu cuenta de Revol y comprueba el acceso a la empresa que necesitas.
* La suscripción de la empresa debe permitir el acceso al módulo MCP.
* Tu cuenta o espacio de trabajo de ChatGPT/Claude debe permitir conectores MCP personalizados. Si no aparece la opción, revisa los ajustes de acceso con tu administrador.

## Ajustes de conexión

| Campo | Valor |
| - | - |
| Nombre | `Revol` |
| URL del servidor / Connection | `https://revol-ai.app/mcp` |
| Authentication | **OAuth** |
| Registro del cliente OAuth, si se puede elegir | Automático / **DCR** |
| Client ID y Client Secret | Déjalos vacíos para el registro automático |
| Transporte, si se puede elegir | **Streamable HTTP** |

<Note>
  Revol exige autenticación al establecer la conexión. En ChatGPT elige **OAuth**: **No authentication** provoca el error **The MCP server denied access**.
</Note>

## ChatGPT

1. Abre **Add custom MCP server** en la sección de aplicaciones, conectores o plugins de tu interfaz.
2. Introduce los ajustes de la tabla y selecciona **OAuth**. No necesitas introducir Client ID ni Client Secret manualmente.
3. Confirma la creación de la conexión. En la página de Revol, inicia sesión y concede acceso como se explica a continuación.
4. Vuelve a ChatGPT y termina de instalar el plugin. Abre un chat nuevo, selecciona **@Revol** en el mensaje y pide una llamada de solo lectura a `revol_whoami`.

Para el campo del icono, descarga el [logotipo PNG de Revol](https://revol-ai.app/favicon.png): **256 × 256 px, 2,7 KB**. Cumple el límite de 10 KB del formulario.

Consulta la ubicación actual de las opciones en la [guía de OpenAI](https://developers.openai.com/api/docs/guides/custom-mcp-server).

## Claude

En **Connectors**, añade un conector personalizado con los ajustes anteriores. Si se solicita, elige **Sign in now** y **Register automatically** para el cliente OAuth. Concede acceso en Revol y activa el conector en el chat.

Ubicación del menú y permisos de administración: [guía de Claude](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp).

## Gemini CLI

En Gemini CLI instalado, añade el mismo endpoint Streamable HTTP:

```bash theme={null}
gemini mcp add --transport http Revol https://revol-ai.app/mcp
```

Inicia Gemini CLI y ejecuta `/mcp auth Revol` para completar OAuth en el navegador. Comprueba la conexión con `/mcp`. El descubrimiento automático y el registro del cliente utilizan el mismo flujo de autorización de Revol.

Estos pasos son para **Gemini CLI**. El sitio web de Gemini y otros productos de Google tienen sus propias opciones de integración; añadir el servidor a la CLI no lo activa allí.

[Documentación de Gemini CLI](https://geminicli.com/docs/tools/mcp-server/).

## Conceder acceso en Revol

En la pantalla de consentimiento:

1. Selecciona una o varias empresas con las que trabajará el asistente. Las listas largas se desplazan dentro del formulario.
2. Elige el conjunto de herramientas adecuado para tu tarea.
3. Haz clic en **Permitir** para volver a ChatGPT, Claude o Gemini CLI.

| Conjunto de herramientas | Uso |
| - | - |
| **Conversaciones y ventas** | Conversaciones, trabajo en equipo, leads, productos y guiones de departamentos |
| **Administración de agentes IA** | Agentes, workflows, base de conocimiento, archivos, canales y ajustes de la empresa |
| **Analítica, facturación y tracking** | KPI, métricas, facturación, diagnóstico y seguimiento del sitio |
| **Acceso completo** | Todas las herramientas disponibles según tus permisos y suscripción |

El perfil limita las herramientas, pero no amplía tu rol. El asistente actúa como la persona que autorizó la conexión; siguen aplicándose las restricciones de empresa, espacio de trabajo y suscripción. «Acceso completo» no concede permisos de administrador.

## Comprobar la conexión

Pide al asistente:

> Usa Revol para mostrar las empresas disponibles para esta conexión.

Si seleccionaste varias empresas, indica la empresa en cada tarea, por ejemplo: «Usa Revol para mostrar los productos de la empresa “Ejemplo”». Cada operación debe realizarse en el contexto de una sola empresa.

## Comparar métricas con el Dashboard

Compare la misma empresa, el mismo período y los mismos filtros. **24h** en el Dashboard significa las últimas 24 horas, incluida parte del día anterior. Una consulta de «hoy» o `date_from=date_to` selecciona un día natural y puede devolver cifras menores.

Para reproducir el Dashboard, pida: «Usa Revol para mostrar el seguimiento de la empresa seleccionada durante las últimas 24 horas (`period=24h`, sin `date_from` ni `date_to`) con los mismos filtros. Indica los límites exactos, la zona horaria y la hora de consulta». Para otro botón de período, use `7d`, `30d` o `90d`, según corresponda.

`revol_tracking_dashboard` devuelve estos datos en `context`, junto con la empresa y los filtros aplicados. Las fechas explícitas tienen prioridad sobre `period`; el día final se incluye por completo. Los visitantes únicos se cuentan para todo el período: sumar los valores diarios puede contar varias veces a los visitantes recurrentes.

## Gestionar y revocar el acceso

Abre la empresa correspondiente en Revol y ve a **Mi Asistente**. En la tarjeta de la conexión puedes desactivar herramientas individuales o pulsar **Desconectar**. Puede gestionarla su creador o el propietario de una empresa incluida en la conexión.

La desconexión revoca toda la conexión, incluidas todas las empresas seleccionadas para ella. Para elegir otras empresas u otro perfil, completa OAuth de nuevo. Si el cliente sigue mostrando una lista antigua de herramientas, actualízala o inicia un chat nuevo.

## Las herramientas están activadas en Revol pero faltan en el chat

Los interruptores de **Mi Asistente** determinan lo que Revol permite a esta conexión. El cliente también debe cargar el catálogo de herramientas y activar el plugin para el mensaje.

En ChatGPT abre la conexión y selecciona **Refresh**, o actualiza las acciones en los ajustes de aplicaciones del espacio de trabajo. Revisa las herramientas detectadas y sus permisos; después abre un chat nuevo con **@Revol** y prueba `revol_whoami`. Algunos planes, modos o políticas del espacio de trabajo solo permiten lectura. Consulta los [controles de conexión y acciones de OpenAI](https://help.openai.com/en/articles/12584461-connecting-custom-mcp-servers-in-chatgpt).

En cualquier cliente MCP, si un catálogo grande dificulta el descubrimiento, vuelve a conectar con el perfil de herramientas adecuado para la tarea. Una pantalla OAuth correcta o una respuesta «conectado» no sustituyen una llamada correcta a una herramienta.

El cliente gestiona la ficha de la aplicación: descripción, categoría, desarrollador, sitio web y logotipo. Los campos guardados pueden diferir de los metadatos del servidor; editar la ficha no corrige el descubrimiento de herramientas.

## Problemas frecuentes

| Síntoma | Qué comprobar |
| - | - |
| **The MCP server denied access** al añadir el servidor | Selecciona **Authentication → OAuth** y vuelve a conectar con `https://revol-ai.app/mcp` |
| `401` o `Missing bearer token` al abrir la URL en el navegador | La URL no es una página de inicio de sesión. Añádela en el cliente MCP y completa OAuth |
| Falta una empresa en la pantalla de consentimiento | Comprueba la cuenta de Revol utilizada y su acceso a esa empresa |
| Hay conexión, pero faltan herramientas o se deniega una operación | Revisa la suscripción de la empresa, tu rol, el perfil y las herramientas desactivadas en **Mi Asistente** |
| El asistente no sabe qué empresa usar | Indica una empresa autorizada durante la conexión |
| La conexión dejó de funcionar después de revocar el acceso | Autoriza Revol de nuevo mediante OAuth |
| Aparece un icono genérico en lugar del logotipo de Revol | Sube el logotipo PNG en el campo del icono del conector |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.