Panoramica
Scout ti dà accesso all'intelligence di visibilità attraverso due modelli di consegna complementari in aggiunta alla UI: un'API e un MCP.
L'API di Scout fornisce endpoint HTTP strutturati che restituiscono dati di visibilità di Scout. Usala quando vuoi integrare i dati di Scout direttamente nel tuo prodotto: per alimentare dashboard personalizzate, automatizzare le esportazioni in un data warehouse o in un CRM, creare report white label o attivare flussi di lavoro di raccomandazione basati su segnali di visibilità.
L'MCP di Scout elimina la fatica della creazione, permettendoti di collegare i dati di Scout a Claude o OpenAI e porre domande in linguaggio semplice. Utilizzalo quando l'obiettivo è l'esplorazione rapida, le sintesi su richiesta o la generazione di visualizzazioni personalizzate senza scrivere codice. L'MCP è disponibile su OpenAI, Claude, Perplexity, Gemini e Copilot.
Sia l'API di Scout che l'MCP sono di sola lettura per i dati di Scout. Nessuno dei due supporta l'attivazione di scansioni, l'aggiornamento delle parole chiave o altre azioni di scrittura all'interno di Scout. Per le capacità di scrittura, utilizza il più generale Yext MCP (di cui fa parte l'MCP di Scout) o l'API di gestione di Yext, entrambi supportano azioni come l'aggiornamento dei listing, la risposta alle recensioni e la gestione di altre funzionalità di Yext.
Avviso: verifica prima di condividere
Scout MCP attinge a endpoint di dati reali, ma i modelli di IA possono produrre contenuti che sembrano affidabili ma non sono accurati. Prima di condividere qualsiasi cosa con una parte interessata, mantieni lo stesso standard che applicheresti a qualsiasi analisi che porta il tuo nome.
Verifica ogni numero, data ed entità nominata rispetto all'API o alla UI di Scout e verifica dove termina la copertura di Scout. I prompt che esulano dall'insieme di metriche supportate potrebbero restituire risposte inventate. Al di là dei numeri, verifica che la narrazione si adatti effettivamente al cliente. Le cause più comuni di insuccesso non sono sempre evidenti: dati invertiti, un concorrente sbagliato, una metrica obsoleta o una citazione inventata.
Nulla di ciò che l'MCP genera dovrebbe raggiungere un cliente senza una seconda revisione. È la persona che presenta a essere responsabile dell'accuratezza, non il modello.
Come API e MCP funzionano insieme
Il Scout MCP e l'API attingono agli stessi dati sottostanti. La differenza sta nel modo in cui vi si accede.
L'API Scout ti offre un accesso strutturato e programmatico in modo da controllare come i dati vengono presentati e collegati alla logica del tuo prodotto. L'MCP di Scout ti offre l'accesso in linguaggio naturale tramite un LLM, senza necessità di configurazione.
In pratica, molti partner e clienti utilizzano entrambi: l'MCP per l'esplorazione rapida e la creazione di UI personalizzate, l'API per prodotti scalabili e integrati.
Come ottenere l'accesso
Le istruzioni dipendono dal modello che stai usando. Passa alla sezione corrispondente qui sotto per le istruzioni su come contattare ciascun fornitore.
Puoi accedere alla documentazione dell'API di Scout direttamente dal tuo account facendo clic sull'icona delle impostazioni nell'angolo in alto a destra di qualsiasi pagina Scout e cliccando Visualizza riferimento API.
È inoltre possibile accedere direttamente alla documentazione dell'API visitando i seguenti link:
Nota: per accedere a questi documenti devi aver effettuato l'accesso al tuo account.
Claude
Cosa ti servirà:
- Credenziali di accesso per il tuo account Yext
- Accesso a Claude con autorizzazioni sufficienti per aggiungere un connettore personalizzato. Visualizza la documentazione Aggiungi un connettore personalizzato di Claude per ulteriori informazioni sui requisiti di autorizzazione.
Come collegarsi a Yext MCP
- Su Claude, fai clic su Aggiungi connettore personalizzato. Questa opzione si trova tipicamente nella sezione Connettori del menu Impostazioni.
- Inserisci un nome e un URL remoto del server MCP.
- Consigliamo di aggiungere Yext MCP come nome del connettore.
- L'URL del server MCP remoto è https://api.yext.com/mcp per gli account dell'area di origine USA e https://api.eu.yextapis.com/mcp per account provenienti dall'area UE.
- Fai clic su Aggiungi.
- Dopo aver aggiunto l'URL, fai clic su Connetti. Claude ti chiederà di accedere a Yext.
- Accedi al tuo account Yext utilizzando le tue credenziali.
- Ti verrà chiesto di autorizzare la connessione con accesso in lettura/scrittura all'MCP di Scout. Fai clic su Autorizza.
- Una volta effettuata l'autorizzazione, verrai reindirizzato nuovamente a Claude e la connessione sarà attiva.
- Clicca sul connettore personalizzato Yext MCP nella barra laterale per visualizzare l'elenco completo degli strumenti dell'MCP di Scout disponibili.
Ce l'hai fatta! Ora puoi usare questi strumenti direttamente nelle conversazioni con Claude per accedere ai tuoi dati Yext.
OpenAI
Cosa ti servirà:
- Credenziali di accesso per il tuo account Yext
- Accesso a OpenAI con permessi sufficienti per aggiungere un'app personalizzata
Come collegare l'MCP di Scout a OpenAI
- In ChatGPT, vai alla pagina delle Impostazioni e clicca su App.
- Fai clic su Impostazioni avanzate.
- Fai clic per attivare la Modalità sviluppatore. Poi fai clic su Crea app.
- Inserisci i dettagli dell'app.
- Nome: consigliamo di aggiungere Yext MCP come nome del connettore.
- Connessione: assicurati che l'URL del server sia selezionato (questo è il valore predefinito) e inserisci https://api.yext.com/mcp per gli account dell'area di origine USA, o https://api.eu.yextapis.com/mcp per gli account dell'area di origine UE.
- Autenticazione: seleziona OAuth.
- Seleziona la casella per confermare la connessione a un server MCP personalizzato.
- Fai clic su Crea.
- Ti verrà chiesto di accedere a Yext per autorizzare la connessione all'MCP di Scout. Fai clic su Accedi. Quindi, dopo aver effettuato l'accesso al tuo account Yext, fai clic su Autorizza. Una volta autorizzata correttamente la connessione, verrai reindirizzato alla tua lista di app.
Ce l'hai fatta! Ora puoi usare questi strumenti direttamente nelle conversazioni di ChatGPT per accedere ai tuoi dati Yext.
Copilot
Istruzioni ufficiali in arrivo. Nel frattempo, puoi visitare l'articolo di assistenza Collega il tuo agente a un server Model Context Protocol (MCP) esistente nel sito di assistenza Microsoft Copilot e utilizzare l'URL OAuth https://api.yext.com/mcp per gli account dell'area di origine USA, o https://api.eu.yextapis.com/mcp per gli account dell'area di origine UE per iniziare.