> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Collegare una Data App a Codex

> Scegli una Data App fissa, aggiungila a Codex con il prompt di installazione generato e completa una chiamata reale con un piccolo test.

Questo tutorial è per chi **sa già quale Data App usare**. Scegli e provi prima l'app nel catalogo, poi copi il prompt di installazione di quell'app e lasci che Codex la usi come strumento fisso.

<Note>
  Questa pagina segue lo schema «scegli prima l'app, poi collega». Se non sai ancora quale app scegliere e vuoi collegare prima l'MCP e lasciare che l'agente cerchi, usa invece <a href="/docs/it/datahub/quick-start/agent-connection/general" target="_blank" rel="noopener noreferrer">Connessione generale: scegliere un'app dentro l'agente</a>.
</Note>

<Note>
  Questa pagina usa come esempio una Data App di arricchimento aziendale, che restituisce settore, numero di dipendenti e sede a partire dal nome di un'azienda. Se scegli un'altra Data App, il nome della pagina, i parametri di input e i campi restituiti saranno diversi, ma il metodo di connessione è lo stesso.
</Note>

## Cosa potrai fare dopo

Dopo questo tutorial, potrai descrivere un'esigenza di dati direttamente in Codex, far richiamare a Codex la Data App su Data Hub e ottenere risultati strutturati. Non scrivi mai la configurazione MCP a mano.

## Prima di iniziare

Prepara quanto segue:

* Un account Octoparse con cui puoi accedere.
* Codex installato e con accesso effettuato.
* Un obiettivo di test chiaro e piccolo, come «arricchisci tre nomi di aziende con settore, numero di dipendenti e sede».

<Warning>
  Una chiave API è una credenziale dell'account. Non inserire mai una chiave reale in file di progetto, repository di codice, screenshot pubblici o chat di gruppo. Forniscila solo quando Codex chiede esplicitamente una credenziale.
</Warning>

## Passo 1: scegliere e provare la Data App

Prima di collegare l'agente, conferma nel browser che la Data App soddisfi le tue esigenze. Se una chiamata successiva fallisce, potrai capire rapidamente se il problema riguarda i parametri dei dati o la configurazione di Codex.

<Steps>
  <Step title="Aprire Octoparse Data Hub e accedere">
    Vai al <a href="https://www.octoparse.it/data-hub" target="_blank" rel="noopener noreferrer">Octoparse Data Hub</a> e accedi tramite l'accesso all'account in alto a destra.
  </Step>

  <Step title="Trovare la Data App di cui hai bisogno">
    Usa la ricerca o i filtri per categoria per trovare l'app target. Nella pagina di dettaglio, leggi prima la descrizione della capacità, i parametri di input, i campi di output e il prezzo. Non giudicare l'idoneità solo dal nome dell'app.
  </Step>

  <Step title="Eseguire online con una piccola quantità di dati">
    Fai clic su **Try It Now** e compila i parametri obbligatori. Richiedi solo una piccola quantità di dati la prima volta. Al termine dell'esecuzione, controlla stato, numero di record e campi chiave.
  </Step>
</Steps>

Se l'esecuzione nel browser non restituisce risultati, regola prima i parametri di input o passa a un'altra Data App. Non affrettarti a collegare Codex.

## Passo 2: copiare il prompt di installazione di Codex

Nella pagina di dettaglio della Data App, apri **Integration**, scegli MCP e fai clic su **Copy install prompt**. Copia il contenuto completo generato dalla pagina. **Copy MCP URL** fornisce solo l'indirizzo del server, sufficiente se preferisci aggiungere il server a mano. Non riscrivere a mano l'indirizzo del server.

<Tip>
  Quando ti serve una sola capacità, collega una singola Data App. Codex sceglie più facilmente lo strumento giusto e la risoluzione dei problemi è più semplice.
</Tip>

## Passo 3: creare una chiave API Octoparse

<Steps>
  <Step title="Aprire la pagina delle chiavi API">
    Vai al <a href="https://www.octoparse.it/console/open-platform/api-keys" target="_blank" rel="noopener noreferrer">centro account Octoparse</a> e crea una nuova chiave.
  </Step>

  <Step title="Conservare temporaneamente la nuova chiave">
    Una chiave viene di solito mostrata per intero solo al momento della creazione. Salvala in un gestore di password affidabile. Dopo la configurazione, non conservarla in un file di testo in chiaro.
  </Step>
</Steps>

La configurazione per app specifica generata nella pagina di dettaglio della Data App usa una chiave API. La riga `Authorization: Bearer <API_KEY>` nella configurazione è semplicemente il formato dell'header per la chiave API. La connessione generale supporta anche OAuth. Non mescolare frammenti di configurazione dei due tutorial.

## Passo 4: lasciare che Codex completi la connessione

<Steps>
  <Step title="Inviare il prompt di installazione a Codex">
    Avvia una nuova conversazione Codex, incolla il prompt di installazione completo che hai copiato e invialo. Codex legge l'indirizzo del server e i requisiti di configurazione, poi ti dice di cosa ha bisogno.
  </Step>

  <Step title="Fornire la chiave API quando richiesta">
    Fornisci la chiave appena creata solo quando Codex chiede esplicitamente una credenziale. Conferma che Codex stia modificando la configurazione MCP dell'utente corrente, non un file condiviso nel progetto.
  </Step>

  <Step title="Confermare il risultato della configurazione">
    Quando Codex ha finito, indica quale file di configurazione ha scritto e il nome del nuovo server. Normalmente modifica il `config.toml` a livello utente e ti chiede di ricaricare MCP o riavviare Codex.
  </Step>

  <Step title="Ricaricare Codex">
    Ricarica MCP come suggerisce Codex. Se l'interfaccia non ha un'opzione di ricarica, chiudi e riapri Codex. Poi prosegui con la verifica qui sotto.
  </Step>
</Steps>

## Passo 5: fare la prima chiamata reale

Dì a Codex in linguaggio naturale cosa vuoi interrogare e dagli un ambito chiaro. Limita la quantità alla prima chiamata. Ad esempio:

```text theme={null} theme={null}
Usa lo strumento di arricchimento aziendale appena collegato per arricchire questi tre lead con settore, numero di dipendenti e sede: Satispay, Scalapay, Bending Spoons.
```

<Steps>
  <Step title="Confermare che Codex ha richiamato la Data App">
    Osserva le chiamate agli strumenti nella conversazione. Solo quando compare una chiamata a uno strumento Data Hub, Codex ha davvero usato la Data App invece di rispondere con le proprie conoscenze.
  </Step>

  <Step title="Controllare i risultati restituiti">
    Verifica se numero di record, campi e contenuto corrispondono al test nel browser. Un campo vuoto non significa sempre un errore. Verifica prima se i dati di origine forniscono quel campo per il record.
  </Step>
</Steps>

## Facoltativo: lasciare che Codex usi più Data App

Crea un set di strumenti multi-app solo quando un flusso di lavoro ha davvero bisogno di più capacità dati.

<Steps>
  <Step title="Aprire MCP connection nell'Open Platform">
    Da Data Hub, apri l'Open Platform, fai clic su **MCP connection** e poi apri la sezione dei set di strumenti personalizzati.
  </Step>

  <Step title="Scegliere le Data App necessarie">
    Aggiungi solo le app di cui il flusso di lavoro attuale ha davvero bisogno. Alcune pagine di dettaglio offrono anche un pacchetto **Related Data Apps**.
  </Step>

  <Step title="Copiare e inviare il prompt di installazione multi-app">
    Salva il set di strumenti, copia il prompt di installazione generato dalla pagina, invialo a Codex e ricarica MCP quando richiesto.
  </Step>

  <Step title="Verificare gli strumenti uno per uno">
    Chiedi prima a Codex di elencare le capacità dati disponibili, poi prova un'app alla volta. Quando tutte funzionano, lascia che più app lavorino insieme su un'attività complessa.
  </Step>
</Steps>

## Domande frequenti

<AccordionGroup>
  <Accordion title="Codex dice che la configurazione è riuscita, ma non compare alcuno strumento">
    Ricarica MCP o riavvia Codex. Se gli strumenti continuano a non comparire, fai controllare a Codex che indirizzo del server e header nel `config.toml` a livello utente siano completi, e conferma che stia leggendo la stessa configurazione utente.
  </Accordion>

  <Accordion title="Non autorizzato o chiave API non valida">
    Assicurati che alla chiave non manchino caratteri, che non contenga spazi o interruzioni di riga e che sia ancora valida. Questa pagina usa la configurazione con chiave API generata nella pagina dell'app specifica. Se ti serve OAuth, usa invece la configurazione generata nella pagina della connessione generale.
  </Accordion>

  <Accordion title="Codex non ha richiamato lo strumento e ha risposto con testo semplice">
    Scrivi esplicitamente «usa lo strumento Data Hub appena collegato» nella domanda e fornisci i parametri supportati dall'app. Puoi anche chiedere a Codex di elencare prima gli strumenti disponibili per confermare che il server sia caricato.
  </Accordion>

  <Accordion title="Il browser restituisce risultati, ma la chiamata di Codex fallisce">
    Confronta con i parametri che hanno funzionato nel browser. Controlla uno per uno indirizzo del server, chiave API, formato dei parametri e log di Codex. Mantieni un ambito di richiesta ridotto per la prima verifica, così un timeout non viene scambiato per un errore di connessione.
  </Accordion>

  <Accordion title="Dopo aver modificato il set di strumenti, Codex mostra ancora i vecchi strumenti">
    Dopo aver salvato il nuovo set di strumenti, copia di nuovo il prompt di installazione attuale, fai aggiornare la configurazione a Codex e poi ricarica MCP. I client non sincronizzano automaticamente le modifiche al set di strumenti.
  </Accordion>
</AccordionGroup>

## Lista di controllo

* Hai eseguito con successo la Data App nel browser con una piccola quantità di dati.
* Hai copiato il prompt di installazione dalla sezione **Integration** attuale dell'app.
* La chiave API è conservata solo in una configurazione locale affidabile o in uno strumento per le credenziali.
* Codex ha ricaricato MCP e lo strumento Data Hub compare.
* Hai completato una chiamata reale allo strumento e controllato numero di record e campi chiave.

<CardGroup cols={2}>
  <Card title="Connessione generale" href="/docs/it/datahub/quick-start/agent-connection/general">
    Non scegliere un'app in anticipo. Connettiti, poi lascia che l'agente cerchi ed esegua la capacità dati giusta.
  </Card>

  <Card title="Claude Code: collegare un'app specifica" href="/docs/it/datahub/quick-start/agent-connection/claude-code">
    Se usi Claude Code, consulta il flusso completo per app specifica di quel client.
  </Card>
</CardGroup>