Skip to main content
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 la aggiungi a Claude Code come server MCP fisso.
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.
Claude Code e Codex usano le stesse capacità MCP di Data Hub. La differenza sta solo nel modo in cui ogni client salva la propria configurazione MCP e mostra lo stato del server. La Data App in sé non cambia.

​
Cosa potrai fare dopo

Dopo questo tutorial, potrai descrivere un’esigenza di dati direttamente in Claude Code e fargli richiamare la Data App su Data Hub per ottenere dati strutturati. Questa pagina copre anche il collegamento di una singola Data App e di più Data App.

​
Prima di iniziare

Prepara quanto segue:
  • Un account Octoparse con cui puoi accedere.
  • Claude Code installato e con accesso effettuato.
  • Un obiettivo di test chiaro e piccolo, come una piattaforma target, una parola chiave e un numero di record.
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 Claude Code chiede esplicitamente una credenziale.

​
Passo 1: scegliere e provare la Data App

Conferma prima input e output dell’app nel browser, poi collega Claude Code. Se in seguito compare un problema, potrai capire rapidamente se i parametri sono sbagliati o se il server non è configurato correttamente.
1

Aprire Octoparse Data Hub e accedere

Vai al Octoparse Data Hub e accedi tramite l’accesso all’account in alto a destra.
2

Scegliere la Data App target

Usa la ricerca o le categorie per trovare l’app target. Nella pagina di dettaglio, leggi con attenzione la descrizione della capacità, i parametri obbligatori, i campi restituiti e il prezzo, e conferma che sia adatta all’attività.
3

Eseguire online una volta

Fai clic su Try It Now e compila i parametri come indicato dalla pagina. Richiedi solo una piccola quantità di dati la prima volta. Al termine dell’esecuzione, controlla stato, numero di record e campi chiave.
Se l’esecuzione nel browser non restituisce risultati, regola prima i parametri o passa a un’altra Data App. Prosegui con Claude Code solo dopo che l’esecuzione nel browser è riuscita.

​
Passo 2: copiare il prompt di installazione di Claude Code

Nella pagina di dettaglio della Data App, apri Integration, scegli MCP e fai clic su Copy install prompt. Copy MCP URL fornisce solo l’indirizzo del server, sufficiente se preferisci eseguire claude mcp add a mano. Puoi raggiungerlo rapidamente anche tramite il link MCP nella barra laterale della pagina di dettaglio.
Per una prima connessione, scegli una sola Data App. Meno strumenti ci sono, più facilmente Claude Code sceglie la capacità giusta e più semplice diventa la risoluzione dei problemi.

​
Passo 3: creare una chiave API Octoparse

1

Aprire la pagina delle chiavi API

Vai al centro account Octoparse e crea una nuova chiave API.
2

Conservare la chiave API in modo sicuro

Una chiave viene di solito mostrata per intero solo al momento della creazione. Conservala temporaneamente in un gestore di password affidabile. Non salvarla nella directory del progetto o in un documento condiviso.
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 è il formato dell’header per la chiave API. La connessione generale supporta anche OAuth. Non mescolare frammenti di configurazione dei due tutorial.

​
Passo 4: aggiungere il server in Claude Code

1

Inviare il prompt di installazione a Claude Code

Avvia una nuova sessione di Claude Code, incolla il prompt di installazione completo che hai copiato e invialo. Claude Code legge l’indirizzo del server e i requisiti di configurazione e chiede la chiave API quando gli serve.
2

Fornire la chiave API quando richiesta

Fornisci la chiave solo quando Claude Code la chiede esplicitamente. Conferma che l’indirizzo del server provenga dalla sezione Integration attuale dell’app e non usare un indirizzo di origine sconosciuta.
3

Confermare la configurazione a livello utente

Claude Code normalmente aggiunge il server, chiamato octoparse_datahub per impostazione predefinita, con claude mcp add a livello utente, così è disponibile in ogni progetto. Se invece propone un file .mcp.json a livello di progetto, chiedi il livello utente così la chiave non viene inclusa nei commit del progetto.
4

Ricaricare il server

Se gli strumenti non compaiono subito, esegui /mcp in Claude Code per controllare lo stato del server, oppure avvia una nuova sessione. Se il server manca ancora, chiudi e riapri Claude Code.

​
Passo 5: fare la prima chiamata reale

Formula la richiesta in linguaggio naturale chiaro e specifico, idealmente con piattaforma, filtri e quantità. Ad esempio:
1

Confermare che Claude Code ha richiamato il server

Osserva le chiamate agli strumenti nella conversazione. Solo quando compare una chiamata a uno strumento Data Hub, Claude Code ha davvero acceduto alla Data App.
2

Controllare i risultati dei dati

Verifica se numero di record, campi principali e contenuto soddisfano le aspettative. Se ottieni solo una spiegazione in testo semplice, chiedi esplicitamente di «richiamare lo strumento Data Hub appena collegato».

​
Facoltativo: lasciare che Claude Code usi più Data App

Quando un flusso di lavoro ha davvero bisogno di più capacità, crea un set di strumenti personalizzato che raccolga più Data App in una sola connessione MCP.
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

Aggiungere le Data App necessarie

Scegli solo le app di cui il flusso attuale ha davvero bisogno. Troppi strumenti aumentano la probabilità che Claude Code scelga quello sbagliato.
3

Copiare il prompt di installazione multi-app

Salva il set di strumenti, poi copia il prompt di installazione completo che la pagina genera attualmente.
4

Inviarlo a Claude Code e ricaricare

Invia il prompt di installazione multi-app a Claude Code, aggiorna il server come indicato e ricarica. Poi chiedi a Claude Code di elencare prima le capacità disponibili e prova ogni app selezionata una alla volta.

​
Domande frequenti

Esegui /mcp per controllare se il server è connesso, poi avvia una nuova sessione o riavvia Claude Code. Se gli strumenti continuano a non comparire, esegui claude mcp list e confronta indirizzo del server e header con il prompt di installazione.
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.
Scrivi esplicitamente «usa lo strumento Data Hub appena collegato» nella richiesta e fornisci i parametri supportati dall’app. Puoi anche chiedere a Claude Code di elencare prima gli strumenti disponibili per confermare che il server sia caricato.
Confronta con i parametri che hanno funzionato nel browser. Controlla uno per uno indirizzo del server, chiave API e formato dei parametri, e leggi l’errore mostrato sotto /mcp. Mantieni un ambito di richiesta ridotto per la prima verifica, così un timeout non viene scambiato per un errore di connessione.
Dopo aver salvato il nuovo set di strumenti, copia di nuovo il prompt di installazione attuale, fai aggiornare il server a Claude Code e poi ricarica. 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 nella configurazione a livello utente di Claude Code o in uno strumento per le credenziali.
  • Il server Data Hub risulta connesso sotto /mcp e il suo strumento 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.

Codex: collegare un'app specifica

Se usi Codex, consulta il flusso completo per app specifica di quel client.