Conecta Vuelvy con tu asistente de IA
Utiliza el servidor MCP remoto desde un cliente compatible. No necesitas instalar un servidor local ni proporcionar una clave de OpenAI, Anthropic, Apple o Google. Necesitas una cuenta activa de Vuelvy y acceso al negocio que quieras conectar.
Datos de conexión
| Nombre | Vuelvy |
|---|---|
| URL del servidor | https://vuelvy.com/api/mcp |
| Transporte | HTTP remoto / Streamable HTTP |
| Autenticación | OAuth, con código de autorización y PKCE S256 |
| Permisos OAuth | mcp:read para consultas; añade mcp:write para cambios aprobados. offline_access permite renovar el acceso mientras la conexión y su sesión de Vuelvy sigan vigentes. |
Conexión desde la interfaz de tu IA
- Abre sus ajustes de herramientas, conectores o servidores MCP y añade un servidor remoto con la URL anterior. Selecciona OAuth si solicita un método de autenticación.
- Conecta e inicia sesión directamente en Vuelvy. Tu contraseña se introduce solo en Vuelvy, nunca en el chat ni en el archivo de configuración.
- Elige los negocios y los permisos concretos. Empieza con consulta del negocio y Wallet; añade solo las funciones que vayas a usar.
- Comprueba la conexión con: «¿Qué negocios tengo autorizados y qué permisos tengo en cada uno?». El resultado debe limitarse a tu selección.
Configuración JSON
Para clientes que utilizan el formato mcpServers. El formato puede variar en cada producto; activa HTTP remoto y OAuth en su interfaz si lo requiere.
{
"mcpServers": {
"vuelvy": {
"url": "https://vuelvy.com/api/mcp"
}
}
}
Descargar ejemplo JSON. No contiene credenciales ni selecciona negocios por ti. La autorización se completa en el navegador.
Codex: conexión manual
Si usas la CLI de Codex, añade el servidor y abre su autorización:
codex mcp add vuelvy --url https://vuelvy.com/api/mcp
codex mcp login vuelvy --scopes mcp:read,offline_access
codex mcp list
Para consultar y preparar cambios, solicita mcp:read,mcp:write,offline_access al iniciar sesión y concede los permisos concretos en Vuelvy. Añadir un scope no amplía por sí solo el acceso al negocio.
También puedes incorporar esta sección a tu configuración existente de Codex, conservando los demás ajustes:
[mcp_servers.vuelvy]
url = "https://vuelvy.com/api/mcp"
scopes = ["mcp:read", "offline_access"]
Descargar ejemplo para Codex · Documentación oficial de Codex
Tu autorización sigue siendo necesaria
El acceso efectivo combina tu rol actual, el negocio elegido, los permisos delegados y los scopes OAuth. Las herramientas disponibles cambian según esos permisos. Conectar otra IA no concede privilegios de administrador ni acceso a otros negocios.
Los cambios se preparan con una propuesta exacta antes de ejecutarse. Revisa negocio, contenido, audiencia y efectos y aprueba esa propuesta en el cliente. Caduca a los diez minutos y debe seguir coincidiendo con el estado actual. Si tu IA no puede pedir una aprobación explícita antes de ejecutar, configura la conexión solo con mcp:read y permisos de consulta.
Crear un borrador no publica un programa, emite pases ni envía campañas. Las compras de capacidad, los pagos, los contratos, las credenciales, los permisos de equipo, los borrados definitivos y las exportaciones masivas se completan en el panel de Vuelvy.
Apple y Google Wallet
Las promociones y actualizaciones ordinarias de Apple son silenciosas. Los avisos urgentes exigen eventos compatibles y verificados. Google limita las notificaciones a tres por pase en veinticuatro horas móviles. El texto y los enlaces deben estar relacionados con el pase; no se puede cambiar una etiqueta para eludir los controles. La aceptación del proveedor no garantiza la entrega al dispositivo.
Resolver errores y desconectar
- 401 o solicitud de acceso: vuelve a conectar mediante OAuth. Comprueba que tu sesión de Vuelvy sigue vigente.
- 403 o herramienta ausente: revisa negocio, rol, permisos y scopes. Solicitar más scopes no sustituye una nueva concesión autorizada.
- Error de CIMD, DCR o Client ID: comprueba la compatibilidad del cliente. No pegues un token de otro asistente ni desactives OAuth para resolverlo.
- 429: respeta la espera indicada por el servidor antes de repetir la petición.
- Solo consultas: no compartas todos tus permisos para hacer visible una herramienta; concede únicamente lo que necesites.
Puedes revocar el acceso en Mis conexiones de IA. La revocación bloquea nuevas operaciones; no retira los datos que el proveedor de IA ya haya recibido ni deshace efectos ya aceptados.