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 Connessione generale: scegliere un’app dentro l’agente.
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.
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».
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.1
Aprire Octoparse Data Hub e accedere
Vai al Octoparse Data Hub e accedi tramite l’accesso all’account in alto a destra.
2
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.
3
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.
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.Passo 3: creare una chiave API Octoparse
1
Aprire la pagina delle chiavi API
Vai al centro account Octoparse e crea una nuova chiave.
2
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.
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
1
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.
2
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.
3
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.4
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.
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:1
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.
2
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.
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.1
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.
2
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.
3
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.
4
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.
Domande frequenti
Codex dice che la configurazione è riuscita, ma non compare alcuno strumento
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.Non autorizzato o chiave API non valida
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.
Codex non ha richiamato lo strumento e ha risposto con testo semplice
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.
Il browser restituisce risultati, ma la chiamata di Codex fallisce
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.
Dopo aver modificato il set di strumenti, Codex mostra ancora i vecchi strumenti
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.
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.
Connessione generale
Non scegliere un’app in anticipo. Connettiti, poi lascia che l’agente cerchi ed esegua la capacità dati giusta.
Claude Code: collegare un'app specifica
Se usi Claude Code, consulta il flusso completo per app specifica di quel client.