Español (España) Čeština Deutsch English (United States) Français (France) Italiano 日本語

Más información

Visión general y configuración de la API de Scout y MCP

¿A quién se aplica este artículo?

  • Cuentas de clientes empresariales, socios y pequeñas empresas.
  • Cuentas en todas las regiones.

Resumen

Scout le da acceso a inteligencia de visibilidad a través de dos modelos complementarios de entrega además de la interfaz: una API y un MCP.

La API de Scout proporciona puntos de conexión HTTP estructurados que devuelven datos de visibilidad de Scout. Úselo cuando quiera integrar datos de Scout directamente en su propio producto: impulsando paneles personalizados, automatizando exportaciones a un almacén de datos o CRM, creando informes de marca blanca o activando flujos de trabajo de recomendación basados en señales de visibilidad.

El MCP de Scout elimina la carga que supone la compilación, lo que le permite conectar los datos de Scout con Claude u OpenAI y formular preguntas en lenguaje natural. Úselo cuando el objetivo sea explorar rápidamente, hacer resúmenes bajo demanda o generar vistas personalizadas sin necesidad de escribir código. El MCP está disponible en OpenAI, Claude, Perplexity, Gemini y Copilot. 

Tanto la API de Scout como el MCP son de solo lectura para los datos de Scout. Tampoco admite activar escaneos, actualizar palabras clave u otras acciones de escritura en Scout. Para capacidades de escritura, utilice el MCP más amplio de Yext (del que forma parte el MCP de Scout) o la API de gestión de Yext, ambos compatibles con acciones como actualizar un listing, responder a reseñas y gestionar otras funcionalidades de Yext.

Aviso legal: Compruebe la información antes de compartirla

El MCP de Scout extrae datos reales de los endpoints, pero los modelos de IA pueden producir contenido que suena seguro pero no es preciso. Antes de compartir algo con una parte interesada, mantenga el mismo estándar que aplicaría a cualquier análisis con su nombre.

Verifique cada número, fecha y entidad nombrada contra la API o la interfaz de usuario de Scout, y sepa dónde termina la cobertura de Scout. Los mensajes que van más allá del conjunto de métricas admitido pueden devolver respuestas inventadas. Más allá de las cifras, compruebe que la descripción se ajuste realmente al cliente. Los modos de fallo más comunes no siempre son obvios: cifras transpuestas, el competidor equivocado, una métrica obsoleta, una cotización inventada.

Nada generado por MCP debería llegar a un cliente sin que un segundo par de ojos lo revise. La responsabilidad de la exactitud recae en la persona que realiza la presentación, y no en el modelo.

Cómo funcionan juntos la API y el MCP 

El MCP y la API de Scout se basan en los mismos datos subyacentes. La diferencia está en cómo usted accede a ella.

El API de Scout le da acceso estructurado y programático para que usted controle cómo se presentan los datos y cómo se conectan con la lógica de su producto. El MCP de Scout le brinda acceso en lenguaje natural a través de un LLM, sin necesidad de desarrollo.

En la práctica, muchos socios y clientes utilizan ambos: MCP para la exploración rápida y la creación de interfaces de usuario personalizadas, y la API para productos integrados y escalables.

Cómo obtener acceso

Las instrucciones dependerán del modelo que usted use. Vaya a la sección correspondiente a continuación para ver los pasos para conectar con cada proveedor.

Puede acceder a la documentación de la API de Scout directamente desde su cuenta haciendo clic en el icono de configuración en la esquina superior derecha de cualquier página de Scout y haciendo clic en Ver referencia de la API. 

También puede acceder directamente a la documentación de la API a través de los siguientes enlaces:

Nota: Necesita iniciar sesión en su cuenta para acceder a estos documentos.

 

Claude

Lo que necesitará: 

Cómo conectarse al MCP de Yext

  1. En Claude, busque y haga clic en Añadir conector personalizado. Esta opción suele encontrarse en la sección Conectores del menú de ajustes.
  2. Introduzca un nombre y la URL del servidor MCP remoto.
  1. Haga clic en Añadir.
  2. Después de añadir la URL, haga clic en Conectar. Claude le pedirá que inicie sesión en Yext.
  3. Inicie sesión en su cuenta de Yext con sus credenciales de cuenta. 
  4. Se le pedirá que autorice la conexión con acceso de lectura/escritura al MCP de Scout. Haga clic en Autorizar.
  5. Será redirigido de nuevo a Claude una vez que autorice, y la conexión ya está activa.
  6. Haga clic en el conector personalizado de MCP de Yext en la barra lateral para ver la lista completa de herramientas de MCP de Scout disponibles para usar.

¡Listo! Ahora puede usar estas herramientas directamente dentro de sus conversaciones de Claude para acceder a sus datos de Yext.

OpenAI

Lo que necesitará: 

  • Credenciales de inicio de sesión para su cuenta de Yext 
  • Acceso a OpenAI con permisos suficientes para que usted pueda añadir una aplicación personalizada

Cómo conectar el MCP Scout a OpenAI

  1. En ChatGPT, vaya a la página de Configuración y haga clic en Aplicaciones.
  2. Haga clic en Configuración avanzada.

  1. Haga clic para activar el modo desarrollador. Luego haga clic en Crear Aplicación.

  1. Introduzca los datos de la app.
  • Nombre: Recomendamos añadir Yext MCP como el nombre del conector.
  • Conexión: Asegúrese de que la URL del servidor esté seleccionada (esto es el predeterminado) e introduzca https://api.yext.com/mcp para las cuentas de la región de origen estadounidense, o https://api.eu.yextapis.com/mcp para cuentas de la región de origen de la UE.
  • Autenticación: Seleccione OAuth.
  1. Marque la casilla para confirmar la conexión a un servidor MCP personalizado. 
  2. Haga clic en Crear.

  1. Se le pedirá que inicie sesión en Yext para autorizar la conexión al MCP de Scout. Haga clic en Iniciar sesión. Luego haga clic en Autorizar después de haber iniciado sesión en su cuenta de Yext. Una vez que autorice con éxito la conexión, será redirigido de nuevo a su lista de aplicaciones.

¡Listo! Ahora puede usar estas herramientas directamente en sus conversaciones de ChatGPT para acceder a sus datos de Yext.

 

CoPilot

Las instrucciones oficiales estarán disponibles en breve. Mientras tanto, puede consultar "Conectar su agente a un servidor Model Context Protocol (MCP) existente" en el sitio de ayuda de Microsoft Copilot y utilizar la URL de OAuth https://api.yext.com/mcp para empezar con cuentas con región de origen en EE. UU., o bien https://api.eu.yextapis.com/mcp para cuentas de la región de origen de la UE.