Base di conoscenza

Colleghi Findrix al suo assistente AI

Una volta collegato, può chiedere al suo assistente AI come appare il suo brand nelle risposte AI, cosa correggere adesso o un report PDF: l’assistente recupera la risposta dal suo account Findrix. Con Claude o ChatGPT bastano pochi minuti e non servono né una chiave né un file di configurazione.

Prima di iniziare

  • Un account Findrix con almeno un sito su un piano a pagamento (Presence o superiore). Senza, l’assistente può solo dirle chi è in Findrix.
  • L’app dell’assistente che vuole usare, con accesso effettuato. Se il suo account Claude appartiene a un’azienda (Claude Team o Enterprise), un proprietario potrebbe dover prima aggiungere Findrix per tutta l’organizzazione.
  • Qualche minuto: circa due per Claude, circa tre per ChatGPT, circa cinque per Cursor o Codex.

Claude: claude.ai e app desktopConsigliato

Il modo più semplice. Acceda con il suo account Findrix, quindi non ci sono chiavi da copiare né programmi da installare. Funziona allo stesso modo su Mac e Windows, nel browser e nell’app desktop Claude.

Aggiunga Findrix a Claude

Apre claude.ai con il nome e l’indirizzo del server compilati. Indirizzo del server:

https://app.findrix.ai/api/mcp

  1. Faccia clic su Add Findrix to Claude qui sopra. Claude apre il modulo Add custom connector con il nome e l’indirizzo del server già compilati. Per aggiungerlo manualmente, apra Customize → Connectors → Add custom connector in Claude e incolli l’indirizzo del server https://app.findrix.ai/api/mcp.

  2. Se vede Request headers, lo lasci vuoto. La maggior parte degli account Claude non ha questa sezione; se non compare, salti questo passaggio.

  3. In Authentication, scelga Sign in when needed.

  4. In OAuth client, scelga Use Claude’s published identity. Non scelga Register automatically: Findrix non lo supporta e la connessione non riesce.

  5. Faccia clic su Add.

    Il modulo Add custom connector di Claude: Request headers, presente solo in alcuni account, lasciato vuoto; Sign in when needed; Use Claude’s published identity; poi Add. Illustrazione — la sua schermata potrebbe essere leggermente diversa.

  6. Apra una nuova chat e chieda: Who am I in Findrix, and which sites do I have? Claude le chiede di collegare Findrix. Faccia clic su Connect, acceda a Findrix e, nella schermata Autorizzare l’accesso, faccia clic su Consentire.

    La schermata Findrix che si apre quando Claude si collega: lasci Apportare modifiche per Suo conto: aggiungere prompt, registrare il lavoro, annullare le proprie modifiche selezionato per consentire a Claude di apportare modifiche, poi faccia clic su Allow. Illustrazione — la sua schermata potrebbe essere leggermente diversa.

Lasci selezionato Apportare modifiche per Suo conto: aggiungere prompt, registrare il lavoro, annullare le proprie modifiche se vuole che Claude approvi correzioni, aggiunga prompt o registri il lavoro per Lei. Deselezionalo per consentire a Claude solo la lettura.

Il modulo di Claude non è uguale per tutti gli account. Se il suo mostra nome, indirizzo del server e Advanced settings nella stessa schermata, non deve scegliere nulla: lasci Advanced settings vuoto e faccia clic su Add.

Sul piano Free di Claude può aggiungere un solo connettore personalizzato. Se ne ha già un altro, lo rimuova in Customize → Connectors prima di aggiungere Findrix.

Usa l’app desktop Claude? Un connettore aggiunto su claude.ai compare automaticamente anche lì, con lo stesso account Claude. Può aggiungerlo anche dalle impostazioni dell’app desktop, in Connectors, con le stesse opzioni.

È proprietario di un’organizzazione Claude Team o Enterprise? Aggiunga Findrix per tutti in Organization settings → Connectors.

ChatGPT

Come Claude, ChatGPT accede con il suo account Findrix: nessuna chiave da copiare e nulla da installare. Aggiunga Findrix una volta, su chatgpt.com nel browser.

  1. Apra ChatGPT Plugins, faccia clic su Add e scelga Add custom MCP server.

  2. Assegni il nome Findrix. In Connection, incolli l’indirizzo del server https://app.findrix.ai/api/mcp nel campo Server URL.

  3. Per l’autenticazione, scelga OAuth. Lasci vuoti ID client e segreto: ChatGPT accede a Findrix autonomamente.

  4. Faccia clic su I understand and want to continue, poi su Create as a plugin, quindi installi il plugin.

  5. Quando ChatGPT lo richiede, acceda a Findrix e, nella schermata Autorizzare l’accesso, faccia clic su Consentire.

  6. Apra una nuova chat, digiti @, selezioni Findrix e chieda: Who am I in Findrix, and which sites do I have?

Lasci selezionato Apportare modifiche per Suo conto: aggiungere prompt, registrare il lavoro, annullare le proprie modifiche se vuole che ChatGPT approvi correzioni, aggiunga prompt o registri il lavoro per Lei. Deselezionalo per consentire a ChatGPT solo la lettura. In ogni caso, ChatGPT le chiede conferma prima di ogni modifica.

Usa ChatGPT al lavoro (Business o Enterprise)? Un amministratore potrebbe dover prima autorizzare i server MCP personalizzati nel suo spazio di lavoro.

Verifichi che funzioni

Chieda al suo assistente Who am I in Findrix, and which sites do I have? Dovrebbe rispondere con la sua email, il suo piano e l’elenco dei suoi siti. Se lo fa, Findrix è collegato.

Una prima domanda in una nuova chat e il tipo di risposta che indica che Findrix è collegato. Illustrazione — la sua schermata potrebbe essere leggermente diversa.

Poi provi una di queste richieste:

  • Come sta andando yourbrand.com nelle risposte AI questo mese?
  • Quali concorrenti citano i motori AI al posto nostro?
  • Cosa dovrei correggere per prima cosa nella mia homepage?
  • Cosa è cambiato questa settimana e cosa attende una mia decisione?
  • Crea un report PDF della nostra visibilità AI.
  • Mostrami le correzioni pronte per l’approvazione, poi approvale.

Indichi il sito con il suo dominio. Se ha più siti, specifica quale nel primo messaggio: l’assistente lo ricorderà per il resto della chat.

Cursor e Codex: si procuri prima una chiave

Cursor e Codex si collegano con una chiave Findrix, una password lunga creata per una sola app. La crei nel suo account Findrix e Findrix le fornisce l’intera configurazione da incollare, con la chiave già inserita.

  1. Apra MCP e connessioni nel suo account Findrix (Account → MCP e connessioni).

  2. Crei una chiave e assegnale il nome dell’app, ad esempio Cursor. Un account può avere fino a cinque chiavi.

  3. Findrix mostra la chiave una sola volta, insieme a una configurazione già pronta. In Configuri un client con questa chiave, scelga la sua app e il suo sistema (macOS / Linux o Windows) e faccia clic su Copi. Lasci aperta la pagina finché non l’ha incollata.

    Subito dopo la creazione di una chiave, Findrix la mostra una sola volta con una configurazione pronta: in Configuri un client con questa chiave, scelga la sua app e il suo sistema, poi faccia clic su Copy. Illustrazione — la sua schermata potrebbe essere leggermente diversa.

Tratti la chiave come una password: non la incolli in una chat con l’assistente e non la invii via email. Se viene divulgata, la revochi nella stessa pagina e ne crei una nuova.

Cursor

  1. Si procuri una chiave con la configurazione già pronta per Cursor (sopra) e faccia clic su Copi.

  2. Apra il file di configurazione MCP di Cursor, mcp.json.

    Su un Mac

    Apra Terminal (prema Cmd+Space, digiti Terminal, prema Invio), incolli questa riga e prema Invio. Il file si apre in Cursor.

    mkdir -p ~/.cursor && touch ~/.cursor/mcp.json && open -a Cursor ~/.cursor/mcp.json

    Su Windows

    Prema Win+R, incolli questa riga e prema Invio. Se Notepad chiede se creare il file, faccia clic su Yes. Se indica che il percorso non è stato trovato, apra Cursor una volta, lo chiuda e riprovi.

    notepad %USERPROFILE%\.cursor\mcp.json

  3. Se il file è vuoto o contiene solo {'}, selezioni tutto e incolli. Se elenca già altri server, incolli solo la parte "findrix": { … } all’interno di "mcpServers", con una virgola tra questa e il server precedente.

    Il file mcp.json di Cursor dopo aver incollato: una voce findrix con l’indirizzo del server e la sua chiave. Illustrazione — la sua schermata potrebbe essere leggermente diversa.

  4. Salvi il file.

    Su un Mac

    Prema Cmd+S.

    Su Windows

    Prema Ctrl+S.

  5. Esca completamente da Cursor e lo riapra. Faccia clic su Customize nella barra laterale, poi su MCPs (nelle versioni precedenti alla 3.9: Cursor Settings → Tools & MCP). Findrix è presente nell’elenco ed è attivo. Se non c’è o mostra un errore, apra il pannello Output e selezioni MCP Logs per scoprirne il motivo.

    Su un Mac

    Prema Cmd+Q per uscire. Cmd+Shift+U apre il pannello Output.

    Su Windows

    Chiuda tutte le finestre di Cursor per uscire. Ctrl+Shift+U apre il pannello Output.

  6. Apra una nuova chat e chieda: Who am I in Findrix, and which sites do I have?

Codex

L’app Codex, la riga di comando Codex e l’estensione Codex per VS Code o Cursor condividono un unico file di configurazione, quindi basta configurare Findrix una sola volta per tutti.

  1. Si procuri una chiave con la configurazione già pronta per Codex (sopra) e faccia clic su Copi.

  2. Apra il file di configurazione di Codex.

    Su un Mac

    Apra Terminal (prema Cmd+Space, digiti Terminal, prema Invio), incolli questa riga e prema Invio. Il file si apre in TextEdit.

    mkdir -p ~/.codex && touch ~/.codex/config.toml && open -e ~/.codex/config.toml

    Su Windows

    Prema Win+R, incolli questa riga e prema Invio. Se Notepad chiede se creare il file, faccia clic su Yes. Se indica che il percorso non è stato trovato, apra Codex una volta, lo chiuda e riprovi.

    notepad %USERPROFILE%\.codex\config.toml

  3. Incolli la configurazione alla fine del file e lo salvi.

    Il file config.toml di Codex dopo aver incollato: la configurazione inizia con [mcp_servers.findrix]. Illustrazione — la sua schermata potrebbe essere leggermente diversa.

  4. Esca completamente da Codex e riavvialo. Usa Codex in VS Code o Cursor? Riavvii quell’app.

    Su un Mac

    Prema Cmd+Q in Codex, poi lo riapra.

    Su Windows

    Chiuda Codex e, se la sua icona è presente nell’area di notifica, lo chiuda anche da lì. Poi lo riapra.

  5. Chieda: Who am I in Findrix, and which sites do I have?

Il file di configurazione ora contiene la sua chiave. Non lo condivida e non lo conservi in una cartella sincronizzata o condivisa.

Ha già collegato Codex a Findrix con una variabile FINDRIX_MCP_KEY? Sostituisca la vecchia sezione [mcp_servers.findrix] con la nuova configurazione, invece di aggiungerne una seconda.

Lettura e modifiche

Il suo assistente può sempre leggere. Per apportare modifiche (approvare correzioni, aggiungere prompt o concorrenti, registrare il lavoro) serve la sua autorizzazione:

  • Collegamento tramite accesso (Claude, ChatGPT): l’opzione è Apportare modifiche per Suo conto: aggiungere prompt, registrare il lavoro, annullare le proprie modifiche nella schermata Findrix che ha visto durante il collegamento. Per cambiarla, scolleghi e ricolleghi.
  • Collegamento con una chiave (Cursor, Codex): l’opzione è Consentire scritture accanto alla chiave in MCP e connessioni. Se è disattivata, l’assistente può comunque leggere, ma ogni modifica viene rifiutata con writes_disabled. La disattivi per una chiave che consegna a un’altra persona.
  • Ogni modifica effettuata in questo modo compare nel suo Registro attività con l’indicazione via MCP.
  • Per annullare, chieda Undo the last change entro 24 ore. Se in seguito ha modificato lo stesso elemento nella dashboard, l’annullamento viene rifiutato, così la sua modifica resta.
  • Alcune modifiche non possono essere annullate in questo modo: modificare il profilo del brand o la regione (mercati, lingue), riformulare un prompt, generare o importare prompt e ricercare argomenti per i prompt, preparare una lettera o una risposta Reddit (Ottenere visibilità, Correggere le informazioni errate), rimuovere un’affermazione vietata, chiedere a Findrix di preparare correzioni per le sue pagine, avviare un audit e aggiungere un sito o avviarlo dopo l’onboarding. Non si possono annullare neppure la rimozione di un concorrente (lo aggiunga di nuovo) o la generazione di un file (scade da solo). Findrix informa l’assistente ogni volta che una modifica non può essere annullata.
  • Se l’assistente ha creato un nuovo link pubblico al report per il cliente, annullare l’operazione produce un altro nuovo link, senza ripristinare quello vecchio.
  • Prima di un’operazione in blocco, come approvare tutte le correzioni, chieda all’assistente di mostrarle prima l’elenco.
  • L’assistente non può avviare una nuova misurazione della visibilità AI (Findrix le esegue secondo programma) e non effettua mai pagamenti: per cambiare piano le fornisce un link al checkout che deve aprire Lei.

Come scollegare

  • Claude: rimuova Findrix in Customize → Connectors in Claude. Poi, in MCP e connessioni in Findrix, faccia clic su Scollega accanto al collegamento in App collegate: l’accesso termina immediatamente.
  • ChatGPT: rimuova il plugin Findrix in ChatGPT Plugins, nella sezione Personal. Poi faccia clic su Scollega accanto al collegamento in App collegate in MCP e connessioni.
  • Cursor o Codex: elimini la sezione Findrix dal file di configurazione, poi revochi la chiave in MCP e connessioni. Una chiave revocata smette subito di funzionare.

Se qualcosa non funziona

L’assistente non vede Findrix
Avvii una nuova chat. Cursor, Codex e l’app desktop Claude rilevano un nuovo collegamento solo dopo un riavvio completo: esca dall’app, senza limitarsi a chiuderne la finestra, e la riapra. In Cursor, verifichi anche che Findrix sia attivo in Customize → MCPs. In Claude, verifichi che Findrix sia attivo nel menu degli strumenti della chat. In ChatGPT, digiti @ e selezioni Findrix nella chat.
Ogni richiesta fallisce con 401 o "Unauthorized"
La chiave è assente, errata o revocata. Crei una nuova chiave in MCP e connessioni e copi di nuovo la configurazione pronta; non riscriva la chiave a mano.
plan_required
Il sito, o il suo account, non ha un piano a pagamento. Attivi un abbonamento per il sito in Findrix oppure chieda all’assistente un link al checkout.
writes_disabled
Le modifiche sono disattivate per questo collegamento. Attivi Consentire scritture accanto alla chiave oppure scolleghi Claude o ChatGPT e lo ricolleghi con Apportare modifiche per Suo conto: aggiungere prompt, registrare il lavoro, annullare le proprie modifiche selezionato.
rate_limited
Troppe richieste in poco tempo: attenda il tempo indicato nel messaggio. Il suo account può effettuare 120 letture al minuto e 5,000 al giorno, e 60 modifiche al minuto e 1,000 al giorno, complessivamente su tutti i collegamenti. Se Claude e Cursor sono entrambi si colleghi, condividono questi limiti e un’altra chiave non li aumenta.
Claude non si collega dopo aver scelto Sign in now
Quell’opzione è ancora in fase di verifica. Rimuova il connettore e lo aggiunga di nuovo con Sign in when needed.
L’opzione Add custom connector non compare in Claude
Il suo piano Claude o le impostazioni dell’organizzazione potrebbero non consentire connettori personalizzati. In un account aziendale, chieda a un proprietario di aggiungere Findrix per l’organizzazione.
L’opzione Add custom MCP server non compare in ChatGPT
Il suo piano ChatGPT o le impostazioni dello spazio di lavoro potrebbero non consentire server MCP personalizzati. In un account di lavoro, chieda a un amministratore di autorizzarli.
In Codex, le risposte lunghe si interrompono a metà
Copi di nuovo da Findrix la configurazione pronta per Codex: contiene la riga che lo impedisce.

Per sviluppatori

Si collegano anche Claude Code, VS Code, n8n, MCP Inspector e le API Claude e OpenAI. Le configurazioni per ciascuno, tutti gli strumenti e le relative azioni, i limiti e il changelog sono nella documentazione del server MCP; le stesse configurazioni sono in MCP e connessioni nel suo account, in Connettere un client. L’indirizzo del server è https://app.findrix.ai/api/mcp; accetta l’accesso (OAuth) e le chiavi inviate come Authorization: Bearer.

← PrecedenteCome postare su Reddit senza farsi bannareSuccessivo →Come far correggere un’informazione errata su di Lei in un altro sito