Configurar MCP (Model Context Protocol)

Opcionalmente conecta un endpoint MCP para que AI Companion pueda obtener contexto adicional (p. ej. datos de usuario, información de cuenta) al generar sugerencias de respuesta. Proporcionas una URL, un secreto para autenticación y un esquema JSON que describe el cuerpo que espera tu endpoint.

¿Qué es MCP?

MCP (Model Context Protocol) te permite exponer un endpoint HTTPS que devuelve datos para la IA. Cuando se procesa un mensaje del cliente, SupportRetriever puede llamar a tu endpoint con un cuerpo JSON (con la forma de tu esquema) y usar la respuesta para enriquecer las sugerencias. Usos típicos:

Consultar datos de cliente o cuenta por correo o ID
Obtener información de suscripción o uso
Incorporar datos de tu propio backend o CRM

Tu clave secreta se almacena cifrada y no se devuelve nunca. Solo la URL, el esquema (cuerpo) y las asignaciones de campos se almacenan en texto plano.

Cuándo usar MCP

Usa MCP cuando:

Quieras que la IA tenga acceso a datos que no están en tu base de conocimiento (p. ej. datos por usuario o por cuenta).
Esos datos estén detrás de una API que controlas y puedes exponer por HTTPS con un secreto compartido.

Puedes usar a la vez una URL de base de conocimiento y MCP: la base de conocimiento aporta documentación general y MCP aporta contexto específico de cada petición.

Configurar MCP

Ve a la configuración de AI Companion y expande la sección MCP (haz clic en Editarar junto a MCP si está colapsada).
Introduce tu URL (debe ser HTTPS), p. ej. https://api.ejemplo.com/mcp.
Introduce tu Clave secreta (se usa para autenticar las peticiones a tu endpoint). Se cifra antes de almacenarse. Deja el campo en blanco al editar si no quieres cambiar el secreto existente.
Introduce el Cuerpo como un esquema JSON que describa el payload que espera tu endpoint (p. ej. JSON Schema con un objeto properties de nivel superior).
Si el esquema tiene properties, aparece una tabla de Asignación de campos. Para cada propiedad, elige de dónde viene el valor:
- Nombre del cliente – del campo nombre del envío
- Correo del cliente – del campo correo del envío
- Clave de metadatos – de los metadatos del envío del formulario (p. ej. parámetros URL como ?userId=123); introduce el nombre de la clave de metadatos (p. ej. userId).
Haz clic en Guardar para almacenar la configuración, o Quitar MCP para borrarla.

URL y secreto

URL: Debe ser una URL HTTPS válida. SupportRetriever enviará una petición a esta URL cuando se necesite contexto (la implementación real de la llamada la gestiona el producto; este artículo solo describe la configuración).
Clave secreta: Se almacena cifrada. Úsala en tu servidor para verificar que las peticiones son de SupportRetriever (p. ej. mediante cabecera o firma). No la compartas; rótala si se compromete.

Cuerpo (esquema JSON)

El Cuerpo debe ser un esquema JSON que defina la estructura del cuerpo de la petición enviado a tu endpoint. Por ejemplo:

{
  "type": "object",
  "properties": {
    "uid": { "type": "string", "description": "Firebase UID" },
    "emails": {
      "type": "array",
      "items": { "type": "string", "format": "email" },
      "maxItems": 10,
      "description": "Look up by email(s)"
    }
  }
}

Una vez pegues un esquema válido con un objeto properties de nivel superior, la interfaz muestra una tabla de Asignación de campos para mapear cada propiedad a una fuente de datos (nombre del cliente, correo del cliente o una clave de metadatos).

Asignación de campos

La asignación conecta cada propiedad del esquema con el origen del valor en el momento de la petición:

Nombre del cliente – valor del campo nombre del envío del formulario.
Correo del cliente – valor del campo correo del envío del formulario.
Clave de metadatos – valor de los metadatos del envío (p. ej. de parámetros URL cuando se abrió el formulario). Introduce el nombre exacto de la clave (p. ej. userId, campaign).

Para propiedades de tipo array u objeto, el valor mapeado sigue siendo una única fuente (p. ej. una clave de metadatos o el correo); cómo se construye el cuerpo final lo determina el producto cuando llama a tu endpoint.

Quitar MCP

En la sección MCP, haz clic en Quitar MCP. Esto borra la URL, el secreto, el cuerpo y las asignaciones. Tu configuración de AI Companion y de la base de conocimiento no cambia.

Temas relacionados

Gestionar la configuración de AI Companion – Editarar todas las opciones de AI Companion
Configurar la base de conocimiento – Añadir URL de la base de conocimiento
Seguridad y privacidad de AI Companion – Cómo almacenamos y usamos los secretos