Conectar Vyper con un cliente de IA por MCP

MCP permite que un cliente compatible, como Claude o Codex, consulte información de tu empresa en Vyper. El análisis lo genera el cliente de IA; Vyper proporciona datos y definiciones, no un chatbot propio.

Antes de conectar

El propietario de la empresa administra los tokens MCP. Confirma la empresa activa antes de generar una credencial.

El token queda vinculado a la empresa seleccionada al crearlo. No permite consultar otras empresas aunque tú también tengas acceso a ellas. Cambiar de empresa en Vyper no cambia el alcance de un token existente.

Crear y proteger un token

1. Confirma la empresa activa y abre MCP.
2. Pon un nombre que identifique al cliente, por ejemplo, Mi cliente de escritorio.
3. Selecciona una vigencia de 7, 30 o 90 días y genera el token.
4. Cópialo directamente al campo seguro de configuración de tu cliente. Solo se muestra al crearlo; no podrás recuperarlo después.
5. Confirma que lo guardaste. Puedes mantener hasta tres tokens activos por propietario y empresa.

Un token nuevo permite consultas de lectura. El permiso para proponer cambios en Meta se habilita por separado y no permite ejecutarlos sin aprobación humana.

No pegues el token en una conversación con la IA, capturas, documentos compartidos ni correos de soporte. No uses tu token de Meta como token MCP. Los dos accesos tienen propósitos distintos.

Conectar un cliente compatible

La dirección del servidor es:

https://vyper.digital/api/mcp

El cliente debe admitir un servidor HTTP MCP y enviar el token mediante la cabecera Authorization, con el valor Bearer seguido de un espacio y el token. No agregues el token a la URL.

Claude

En Personalizar → Conectores, agrega un conector personalizado con la URL anterior. En Request headers, configura Authorization con el valor indicado. Activa las herramientas de Vyper en la conversación. Si el flujo intenta iniciar sesión por OAuth, revisa la configuración: esta conexión usa un token fijo.

Usa un conector personal. En conectores compartidos de Team o Enterprise, una credencial fija puede dar a otros miembros el mismo acceso; no compartas allí tu token de empresa. Consulta la guía oficial de Claude.

Codex

Configura una variable de entorno llamada VYPER_MCP_TOKEN con tu token en el entorno que inicia Codex. Añade esta configuración a ~/.codex/config.toml, sin escribir el secreto dentro del archivo:

[mcp_servers.vyper]
url = "https://vyper.digital/api/mcp"
bearer_token_env_var = "VYPER_MCP_TOKEN"

Reinicia el cliente si es necesario para que lea la configuración y la variable. Si lo abres desde un icono, comprueba que ese proceso reciba la variable; definirla en otra terminal no garantiza que la aplicación la herede. La conexión se autentica con el token, no mediante un inicio de sesión OAuth. Consulta la configuración oficial de servidores HTTP MCP.

Qué puedes consultar

Ejemplos de preguntas, usando nombres ficticios:

• «Compara los últimos siete días de mi oferta Oferta ejemplo con los siete anteriores; indica las fechas y los datos incompletos».
• «Desglosa las ventas de ayer por país y webhook, separando los valores pendientes».
• «Muestra inversión y ventas atribuidas por anuncio de Oferta ejemplo, con evolución diaria».
• «Lista todas mis campañas activas importadas, aunque no hayan tenido gasto hoy».

Los reportes admiten períodos de hasta 31 días. El reporte de ventas admite hasta cuatro dimensiones de agrupación y 10.000 registros de origen por período; si supera ese límite, reduce fechas o selecciona oferta/fuente. Si hay más páginas, el cliente debe consultarlas antes de afirmar que mostró todo. No debe sumar otra vez los totales generales repetidos en cada página.

Interpretar los resultados

• Las métricas se consultan en los datos guardados en Vyper; el MCP no sincroniza Meta ni recupera ventas que nunca llegaron.
• Un listado importado de campañas activas no garantiza que Meta esté entregando anuncios ahora. La consulta de controles sí comprueba la configuración actual en Meta, no su entrega efectiva.
• La atribución y conversión de moneda siguen las mismas reglas del dashboard. Un identificador desconocido no se convierte por sí solo en una venta atribuida.
• Parcial, importe pendiente o dato no disponible no significan cero. Un resultado completo de los registros disponibles no demuestra que hayan llegado todas las ventas del software emisor.
• El día actual está abierto. Dos consultas separadas pueden diferir si entraron ventas o hubo una sincronización entre ellas.

Proponer un cambio en Meta

1. Habilita explícitamente las propuestas para el token deseado en Vyper.
2. Actualiza las herramientas disponibles en tu cliente de IA.
3. Solicita una propuesta para pausar, activar o ajustar un presupuesto diario de una campaña o conjunto de tu oferta.
4. Revisa la entidad, cuenta, moneda, importe anterior y nuevo. Abre el enlace de aprobación devuelto y confirma dentro de tu sesión de Vyper.

Una propuesta pendiente no modifica Meta. Decir «sí» en el chat no la ejecuta. Solo el mismo propietario que originó la propuesta puede aprobarla; vence a los diez minutos. Si cambió el estado de Meta desde la propuesta, puede ser necesario preparar una nueva.

Los cambios de presupuesto de este flujo se limitan a +50% o -90% por propuesta, usan la moneda de la cuenta publicitaria y respetan CBO en campaña/ABO en conjunto. No admiten convertir un presupuesto total en diario. Ese límite por propuesta no es un tope acumulado diario ni un límite duro al gasto real de Meta.

Si el resultado está verificándose o es incierto, no pidas otra propuesta para repetir el cambio. Vyper debe comprobar primero qué ocurrió. Deshabilitar propuestas o revocar el token impide aprobar sus propuestas pendientes. No hay reglas automáticas ni ejecuciones programadas disponibles mediante este MCP.

Revocar acceso y solucionar errores

En MCP puedes revisar vencimiento, último uso y estado de cada token. Revocar detiene nuevas consultas con esa credencial; quitarla del cliente no sustituye revocarla en Vyper. Si perdiste o compartiste el secreto, revócalo y genera otro. La revocación no elimina las respuestas que el cliente de IA ya recibió.

• No autorizado / 401: comprueba token, vencimiento, revocación y que el cliente envíe la cabecera correcta.
• Propuestas no disponibles: revisa el permiso específico del token y vuelve a descubrir las herramientas. No lo soluciones compartiendo una credencial más amplia.
• Demasiadas consultas / 429: espera y reduce las llamadas repetidas; no generes tokens para eludir el límite.
• Período inválido o reporte demasiado grande: utiliza hasta 31 días y acota oferta o fuente.
• Datos parciales: revisa calidad y actualiza las fuentes desde Vyper. La IA no puede completar hechos faltantes por deducción.

El MCP no entrega teléfonos ni nombres de compradores, credenciales de Meta o contraseñas de webhooks. Sí comparte con el cliente autorizado nombres operativos y métricas agregadas de tu empresa. Revisa la configuración y las condiciones de privacidad del cliente que elijas antes de conectarlo.

Consulta cómo leer los reportes y gestionar campañas y presupuestos.