Revinho MCP server

Revinho da a los agentes de IA acceso de solo lectura a la inteligencia de negocio de un espacio de trabajo de Revinho. Combina Google Analytics 4, Stripe y, opcionalmente, Google Search Console para responder qué ha ido cambiando, qué importa, qué genera ingresos, qué tiene un rendimiento.

Este repositorio es el punto público de descubrimiento, conexión y soporte del servidor MCP alojado de Revinho. El servidor de producción está operado por Revinho y no se despliega desde este repositorio.

• Endpoint MCP: https://www.revinho.com/api/mcp

• Transporte: Streamable HTTP

• Autenticación: token bearer con ámbito de espacio de trabajo

• Documentación: revinho.com/docs

• Metadatos del registro: server.json

Qué expone

El servidor ofrece seis herramientas específicas:

Los clientes que admiten prompts de MCP también pueden invocar investigate_business. Este guía al agente a través de una investigación acotada y basada en evidencia, y se detiene cuando los datos disponibles responden la pregunta.

Todas las herramientas son de solo lectura, no destructivas, idempotentes y de mundo cerrado.

Related MCP server: Google Analytics MCP Server

Conexión

1. Inicia sesión en Revinho y abre Configura tu agente.

2. Crea un token de espacio de trabajo con nombre. Los tokens empiezan por rv_live_ y se muestran una sola vez.

3. Añade el endpoint alojado y agrega el token a un cliente compatible con MCP.

Configuración estándar:

{
  "mcpServers": {
    "revinho": {
      "type": "streamable-http",
      "url": "https://www.revinho.com/api/mcp",
      "headers": {
        "Authorization": "Bearer rv_live_REPLACE_WITH_YOUR_TOKEN"
      }
    }
  }
}

Los formatos de configuración de los clientes varían. Utiliza el mecanismo de secretos o de variables de entorno del cliente si este dispone de alguno. No subas el token a un repositorio.

Preguntas de ejemplo

• ¿Qué ha cambiado en el negocio en los últimos 30 días?

• ¿Qué canal de adquisición merece atención en primer lugar?

• ¿El crecimiento del MRR coincidió con un cambio en el tráfico o en la conversión?

• ¿En qué parte del embudo de compra se pierde más usuarios?

• ¿Qué páginas solicitan demanda pero tienen un rendimiento comercial inferior?

• ¿Cuál es la oportunidad de mayor confianza en este momento?

Límites de evidencia

Los agentes que utilicen Revinho deben respetar estas reglas del producto:

• Stripe es la fuente de verdad para los ingresos.

• Los ingresos asociados a la adquisición o al comportamiento conservan su etiqueta de atribución verified, modeled o associated.

• Las relaciones no deterministas se describen como asociadas o coincidentes, nunca causales.

• Los campos de frescura del proveedor determinan la frescura de los datos. El tiempo de generación de la respuesta no.

• Los datos que faltan o son parciales no se tratan silenciosamente como cero.

• Las oportunidades se crean mediante reglas deterministas y evidencia almacenada.

Seguridad de los tokens

Los tokens de la API de Revinho son de solo lectura, tienen ámbito de espacio de trabajo, se almacenan como hashes criptográficos y son revocables.

• Crea un token distinto para cada agente o entorno.

• Mantén los tokens en un administrador de secretos o en una configuración de cliente privada.

• Nunca coloques un token en una URL, un prompt, una captura de pantalla, una incidencia, un log o un repositorio.

• Revoca un token inmediatamente si puede haber quedado expuesto.

Consulta SECURITY.md para informar problemas de seguridad.

Soporte

• Ayuda sobre el producto y la conexión: support@revinho.com

• Informes de seguridad: security@revinho.com

• Documentación: revinho.com/docs

• Problemas del repositorio: usa GitHub Issues para problemas públicos y no sensibles de documentación o compatibilidad.

Licencia

La documentación y los metadatos de este repositorio están disponibles bajo la Licencia MIT. El servicio alojado de Revinho, el código del producto, su nombre y sus activos de marca no están cubiertos por esta licencia.