Saltar al contenido principal

Conectar Claude, ChatGPT u otras herramientas de IA

Añade el conector MCP de VIVIN a Claude, ChatGPT, Gemini o a cualquier otra herramienta de IA que admita servidores MCP, y pregunta después a esa herramienta por tus reservas, inquilinos y finanzas sin salir de ella. MCP, el Model Context Protocol, es el estándar que usan las herramientas de IA para conectarse a otras aplicaciones.

Esta página trata de las herramientas de IA que usáis tú y tu equipo. El asistente virtual para inquilinos es un producto aparte.

Dónde encontrarlo: Configuración → IA / MCP, subpestaña Conexión MCP (https://platform.vivin.app/settings/mcp). El banner Ir a MCP en Configuración → Integraciones abre el mismo sitio. Necesitas el permiso de rol Mcp (la fila Mcp bajo Account Settings en Configuración → Usuarios → Permisos por rol), que Super administrador y Administrador tienen por defecto. Los demás roles con este permiso ven en su lugar una tarjeta Conecta tu cliente de IA con los pasos de Claude y ChatGPT. Solo los Super administradores y los Administradores pueden crear claves de API.

Antes de conectar​

  • Acceso: tu rol tiene el permiso Mcp, y un administrador no ha desactivado tu Acceso a la IA.
  • Al menos un área activada: al menos un área debe estar en Solo lectura o Edición para ti. Los administradores lo ajustan en Configuración → IA / MCP → Permisos. Si todas las áreas están en Desactivado, la página de aprobación no te deja continuar.
  • La URL de conexión: aparece arriba de cada guía de conexión, con un botón Copiar URL. Pégala exactamente como se muestra. No añadas /sse ni ninguna otra terminación.

La subpestaña Conexión MCP tiene una tarjeta para Claude, ChatGPT, Gemini y Otros clientes. Cada tarjeta tiene un botón Añadir que abre la guía de esa herramienta. Los pasos también están más abajo.

Conectar Claude​

Funciona en claude.ai y en la aplicación de escritorio de Claude. Inicias sesión con tu cuenta de VIVIN, así que no hace falta ninguna clave de API.

  1. Abre Claude y ve a Settings.
  2. Abre Connectors.
  3. Haz clic en Add custom connector.
  4. Escribe un nombre, por ejemplo "VIVIN", y pega la URL de conexión.
  5. Haz clic en Add. VIVIN abre la página de aprobación. Comprueba la cuenta y haz clic en Authorize.

Conectar ChatGPT​

Inicias sesión con tu cuenta de VIVIN, así que no hace falta ninguna clave de API.

  1. Abre ChatGPT y ve a Settings → Connectors. En algunos planes está en el menú lateral, bajo Plugins.
  2. Haz clic en + o New para crear un conector personalizado.
  3. Ponle un nombre, por ejemplo "VIVIN".
  4. En Connection, elige Server URL y pega la URL de conexión.
  5. En Authentication, elige OAuth.
  6. Marca I understand and want to continue y haz clic en Create.
  7. Inicia sesión con tu cuenta de VIVIN y haz clic en Authorize en la página de aprobación.

Conectar Gemini u otra herramienta de IA​

Iniciar sesión con tu cuenta de VIVIN funciona con Claude, ChatGPT y las aplicaciones de IA instaladas en tu ordenador que admiten el inicio de sesión. Las demás herramientas de IA web necesitan una clave de API.

  1. En tu herramienta de IA, abre los ajustes de servidores MCP. Cada herramienta lo llama servidor MCP, conector o herramienta personalizada.
  2. Añade un servidor nuevo y pega la URL de conexión.
  3. Si la herramienta ofrece iniciar sesión, inicia sesión con tu cuenta de VIVIN y aprueba.
  4. Si no puede iniciar sesión, crea una clave de API y envíala como token Bearer: Authorization: Bearer <your key>.

Para las herramientas que usan un archivo de configuración JSON, la guía Otros clientes muestra un Ejemplo de configuración del cliente MCP con tu URL ya rellenada, y un botón Copiar configuración:

{
  "mcpServers": {
    "vivin": {
      "url": "<your connection URL>",
      "headers": {
        "Authorization": "Bearer <your key>"
      }
    }
  }
}

Crear una clave de API​

Solo pueden hacerlo los Super administradores y los Administradores.

  1. Ve a Configuración → IA / MCP → Claves de API y haz clic en Generar clave.
  2. Escribe un Nombre de la clave que diga dónde la vas a usar, por ejemplo "Claude Desktop".
  3. Elige una Caducidad: 30 días, 90 días (la predeterminada), 180 días o Nunca caduca.
  4. Haz clic en Generar clave.
  5. Haz clic en Copiar clave y pégala en tu herramienta de IA enseguida. VIVIN muestra la clave una sola vez.

La tabla Claves de API lista todas las claves de tu cuenta, con la fecha de creación (Creada), el Último uso y cuándo Caduca. Estado es Activa, Revocada o Caducada.

Una clave actúa como la persona que la creó, con los permisos de IA de esa persona. Deja de funcionar si esa persona se desactiva o si se desactiva su Acceso a la IA.

La página de aprobación​

Cuando Claude, ChatGPT u otra herramienta se conecta con inicio de sesión, VIVIN abre para ella una página Authorize. La página muestra:

  • Signed in as: el correo de VIVIN y la empresa en nombre de los cuales actuará la conexión, con un enlace Sign out.
  • The following tools will be available: las áreas que vas a compartir. Cada una muestra Read-only o Edit y su número de herramientas. Despliega un área para ver las herramientas.
  • Authorize para conectar, o Cancel para rechazar. Si cancelas, se le dice a la herramienta de IA que se denegó el acceso.

La página nunca te pide la contraseña. Usa la sesión de VIVIN de tu navegador. Si no has iniciado sesión, haz clic en Sign in to VIVIN. Inicias sesión de la forma habitual (código por correo, inicio de sesión con Google) y vuelves a la página de aprobación.

Si la página dice No MCP tools are enabled for this user yet, Authorize queda en gris. Pide a un administrador que active al menos un área en Configuración → IA / MCP y empieza la conexión de nuevo.

Qué puede ver la IA conectada​

La herramienta conectada lee los mismos datos que Genius, el asistente integrado de VIVIN, así que puedes preguntarle, por ejemplo, "¿Qué unidades estarán vacías el mes que viene?". Puede leer pero no cambiar tus datos, salvo tus propios informes programados. Como Genius, recibe exactamente tus propios permisos de IA. Para cada área, es el más restrictivo de tres ajustes: el ajuste de la cuenta, el ajuste para ti en Permisos por usuario y el límite que marca tu rol. Los administradores fijan los dos primeros en Configuración → IA / MCP. Hasta que un administrador los cambie, todas las áreas están en Solo lectura y Informes programados está en Edición.

ÁreaQué puede leer la IA
ReservasReservas, vacantes, próximas entradas, planes de pago, resumen de ventas
AnunciosUnidades, calendarios, tablas de alquiler, bloqueos manuales
PropiedadesPropiedades, sus unidades, comentarios, cerraduras inteligentes
InquilinosInquilinos y sus reservas, solicitudes de servicio, encuestas
MantenimientoTickets, número de tickets y tiempo de cierre, check-ins y check-outs de hoy, progreso y pasos de check-in/out, resumen de operaciones, informes y configuración de inventario
PagosValores del contrato, transacciones, pagos emitidos, depósitos, descuentos, ajustes de facturación
FacturasFacturas de suministros, mapa de costes, flujos de caja
PropietariosPropietarios e informes de propietario
AnalíticaIngresos, ingresos por propiedad, resumen de finanzas, deuda, ocupación, costes, tasa de cierre de mantenimiento, objetivos de ingresos
CanalesEstado de los canales e integraciones conectadas
ComunicaciónReglas y mensajes automáticos, notificaciones, conversaciones de WhatsApp y correo, ajustes del asistente virtual, FAQs y monitorización, opiniones de los inquilinos sobre el asistente virtual
SoporteTus tickets de soporte de VIVIN y tu suscripción
EquipoMiembros del equipo y sus permisos
Informes programadosTus propios informes programados
  • Solo lectura: la IA no puede crear, cambiar ni eliminar reservas, tickets, pagos ni nada más. Edición solo está disponible en Informes programados. Ahí, tu herramienta de IA puede crear, pausar, reanudar, editar o cancelar tus propios informes periódicos ("envíame cada viernes cuántas habitaciones siguen vacías"). Los tipos de informe y el envío se describen en la página de Genius.
  • Exportaciones: en cada área, la IA también puede devolver las mismas listas que puedes exportar en VIVIN, como CSV, hasta 20.000 filas.
  • Los enlaces que funcionan como llaves nunca se envían: los enlaces del portal del inquilino, los enlaces a archivos privados y los feeds de calendario se retienen. La IA te dice que existe un archivo, y tú lo abres en VIVIN.
  • Ayuda del producto: un conjunto de herramientas VIVIN guide responde a preguntas del tipo "cómo hago…" sobre VIVIN. No contienen datos de la cuenta y no dependen de los ajustes de las áreas.
  • Tu proveedor de IA: los datos que devuelven estas herramientas se envían a la herramienta de IA que conectaste. Conecta solo herramientas que tu empresa permita para datos de negocio.

Mantener la conexión o quitar el acceso​

Una conexión con inicio de sesión se autoriza durante 60 días. El plazo se reinicia cada vez que la herramienta de IA renueva su acceso, así que una conexión que usas con regularidad sigue conectada. Si la herramienta no renueva en 60 días, te pide que vuelvas a iniciar sesión en VIVIN.

Cuando un administrador cambia los permisos de IA, las herramientas conectadas recogen el cambio poco después. No necesitas volver a conectar.

Para quitar el acceso:

Para detener…Haz esto
Una herramienta de IAQuita el conector de VIVIN en los ajustes de esa herramienta
Una herramienta que usa una clave de APIConfiguración → IA / MCP → Claves de API → haz clic en el icono de la papelera junto a la clave → Revocar. El acceso termina al instante y no se puede restaurar.
Todas las herramientas de IA que ha conectado un miembro del equipoConfiguración → IA / MCP → Permisos → Permisos por usuario → elige el Miembro del equipo → Acceso a la IA Desactivado → Guardar cambios
Todo, para alguien que se vaDesactívalo en Configuración → Usuarios. Sus conexiones con inicio de sesión y sus claves de API dejan de funcionar.

VIVIN no muestra una lista de las aplicaciones conectadas con inicio de sesión. Para cortar el acceso a un miembro del equipo, desactiva su Acceso a la IA.

Consejos​

  • ¿Navegador compartido? Comprueba Signed in as en la página de aprobación. Usa Sign out para cambiar a la cuenta de VIVIN correcta antes de hacer clic en Authorize.
  • No crees claves de API para tus compañeros. Una clave lleva los permisos de quien la creó. Los compañeros sin el rol de administrador pueden conectar Claude o ChatGPT iniciando sesión con su propia cuenta.
  • Ventana de historial (en Permisos por usuario) también se aplica a las herramientas de IA conectadas: el historial de dinero (transacciones, ingresos, flujos de caja, facturas, liquidaciones de propietarios y exportaciones) se corta en esa fecha, y la respuesta lo indica. Los registros individuales abiertos uno a uno y los datos actuales no tienen límite.
  • Actividad de Genius en la subpestaña Actividad no lista lo que hicieron Claude, ChatGPT u otras herramientas conectadas. La tabla Claves de API muestra cuándo se usó cada clave por última vez (Último uso).
  • Los títulos de herramientas que muestra tu herramienta de IA siguen el idioma de la interfaz de VIVIN (inglés, portugués, español o italiano) en el momento en que te conectaste. Los nombres técnicos de las herramientas siguen en inglés.