Come usare Claude per il debug delle tue API

Published: 2026-07-14 | Jan Procházka

Il debug di un’API di solito significa destreggiarsi tra collezioni Postman, scrivere script usa e getta o creare a mano query solo per rispondere a una domanda semplice come “perché questo campo è null?” o “quale ordine è bloccato?”. E se potessi semplicemente chiedere?

DbGate Central include un server MCP (Model Context Protocol) integrato che espone le tue connessioni API agli assistenti AI come Claude. Una volta collegato, Claude può esplorare e interrogare le tue connessioni GraphQL, Business Central (oData) e Shopify dal vivo, esattamente come faresti tu - direttamente dalla chat, con un accesso che resta sotto il tuo controllo.

Questa guida ti mostra come configurarlo in pochi minuti e poi come usare Claude per fare il debug di tutte e tre.

Apri DbGate Central →

Perché fare il debug delle API con Claude?

Poiché le letture e le scritture riutilizzano lo stesso motore della griglia di DbGate Central, Claude vede esattamente gli stessi dati e le stesse funzionalità che vedi tu - mai più dell’accesso che concedi. Questo lo rende un naturale compagno di debug:

“Come è fatto davvero lo schema di questa entità?”
“Trova i record in cui questo campo è null e mostrami cosa hanno in comune.”
“Quale ordine manca di un evasione, e perché?”

Descrivi il problema in linguaggio naturale; Claude analizza lo schema, esegue le query e ragiona sui risultati - senza che tu debba uscire dalla conversazione.

Cosa ti serve

Un workspace DbGate Central con le connessioni che vuoi debuggare già aggiunte - un endpoint GraphQL, un endpoint oData (useremo Microsoft Dynamics 365 Business Central come esempio), e/o un negozio Shopify. Consulta Connetti agli endpoint API se non li hai ancora aggiunti.
Un account Claude che supporti i connettori personalizzati.

Passo 1 - Crea un profilo MCP in DbGate Central

Apri la scheda Impostazioni (l’icona a forma di ingranaggio in fondo alla barra delle attività) e crea un nuovo profilo MCP. Il profilo ti fornisce tre valori che ti serviranno tra poco:

URL del server - nella forma https://central.dbgate.cloud/mcp/{profileId}
Client ID
Client Secret

Copia tutti e tre. Ogni workspace può avere più profili MCP, ciascuno con il proprio URL, le proprie credenziali e le proprie autorizzazioni per connessione - così puoi distribuire accessi con ambito ristretto (ad esempio, un profilo che vede solo una singola connessione in sola lettura).

Passo 2 - Aggiungi il connettore personalizzato in claude.ai

In claude.ai, aggiungi un connettore personalizzato usando l’URL del server del passo precedente, insieme a Client ID e Client Secret come credenziali OAuth.

Claude esegue quindi l’handshake OAuth 2.1 con PKCE: ti viene chiesto di accedere a DbGate e di dare il consenso, il che collega il connettore a quello specifico profilo MCP e workspace. I client secret sono cifrati a riposo, e nulla dei tuoi dati viene condiviso finché non completi questo passaggio.

Configuring the DbGate Central custom connector in claude.ai
Aggiunta del connettore personalizzato DbGate Central in claude.ai

Passo 3 - Concedi l’accesso per connessione

Per impostazione predefinita, un profilo MCP ha Nessun accesso a tutto - quindi collegare il solo profilo non condivide nulla. Per ogni connessione a cui vuoi che Claude possa accedere, apri il suo editor e imposta il livello di accesso MCP:

Nessun accesso (predefinito) - la connessione è invisibile all’agente.
Sola lettura - l’agente può elencare, ispezionare e interrogare, ma non modificare nulla.
Scrivibile - l’agente può anche aggiornare le righe (solo Shopify, vedi sotto).

Un buon punto di partenza per il debug è Sola lettura per le connessioni GraphQL e Business Central, e Scrivibile per Shopify solo se vuoi davvero che Claude apporti modifiche.

Cosa può fare Claude

Una volta condivisa una connessione, Claude ottiene questi strumenti per le connessioni oData, GraphQL e Shopify:

Elenca le connessioni - le connessioni che questo profilo è autorizzato a usare.
Elenca le entità - tabelle, viste o entità del catalogo.
Ispeziona lo schema - nomi e tipi delle colonne.
Interroga le righe - filtra, pagina e seleziona i dati.
Aggiorna le righe - solo Shopify, e solo quando concedi l’accesso Scrivibile.

Il debug di ogni tipo di API

Ecco come si presenta una vera sessione di debug per ciascun tipo di connessione. I prompt sono in linguaggio naturale - le chiamate agli strumenti in corsivo sono ciò che Claude esegue dietro le quinte.

GraphQL

La flessibilità di GraphQL è anche ciò che lo rende difficile da debuggare: una query restituisce silenziosamente null e ti ritrovi a chiederti se il problema sia lo schema, gli argomenti o i dati. Lascia che sia Claude a esplorare lo schema per te.

Tu: Nella mia connessione GraphQL, elenca le entità disponibili, mostrami lo schema di orders, poi trova eventuali ordini in cui total è null e dimmi cosa hanno in comune.

Claude esegue list_entities per scoprire le viste, get_schema su orders per confermare i campi e i tipi, poi query_rows per estrarre i record incriminati - e ragiona sul risultato per individuare lo schema ricorrente (ad esempio, tutti mancano di un nodo payment collegato).

oData - Business Central

Microsoft Dynamics 365 Business Central espone i suoi dati come servizio oData V4, che DbGate Central tratta come un normale insieme di tabelle. Questo rende i dati ERP - clienti, fatture, registrazioni contabili - interrogabili in linguaggio naturale.

Tu: Nella mia connessione Business Central, trova le fatture di vendita per il cliente “Contoso” del mese scorso, e somma i loro importi.

Claude usa query_rows, traducendo la tua richiesta nelle opzioni di query oData dietro le quinte - $filter per restringere al cliente e all’intervallo di date, $select per scegliere le colonne, e $top/$skip per la paginazione - poi somma i risultati per te.

Shopify

Per un negozio Shopify, DbGate Central si connette tramite la Shopify Admin API ed espone prodotti, ordini, clienti, metafield e altro ancora.

Tu: Trova l’ordine #1043 e dimmi perché la sua evasione è bloccata.

Claude esegue query_rows sulla tua connessione Shopify per individuare l’ordine e ispezionare lo stato dell’evasione e delle voci d’ordine.

Se - e solo se - hai concesso l’accesso Scrivibile, Claude può anche applicare la correzione:

Tu: Aggiungi il tag needs-review a quell’ordine.

Claude usa update_rows, che è disponibile solo per Shopify e richiede l’accesso Scrivibile. Trova il record tramite un target di corrispondenza e un valore, poi applica il tuo aggiornamento. Sulle connessioni in sola lettura questo strumento semplicemente non è disponibile, quindi un agente non può mai modificare dati che non intendevi esporre.

Il controllo resta a te

Il server MCP è costruito in modo che condividere il tuo workspace con un assistente AI non significhi mai rinunciare al controllo:

Niente è condiviso per impostazione predefinita - ogni connessione parte con Nessun accesso.
Autorizzazioni per connessione - decidi tu esattamente quali connessioni sono in sola lettura o scrivibili, per ogni profilo MCP.
Le scritture sono opzionali e limitate - update_rows esiste solo per Shopify e solo con accesso Scrivibile.
Sicuro per progettazione - l’autenticazione usa OAuth 2.1 con PKCE, e i client secret sono cifrati a riposo.
Mai più di te - l’agente usa lo stesso motore della griglia, quindi vede esattamente i dati e le funzionalità che vedi tu.

Conclusione

Con un profilo MCP di DbGate Central e un connettore personalizzato in claude.ai, Claude diventa un partner di debug operativo per le tue API GraphQL, Business Central (oData) e Shopify - ispezionando schemi, eseguendo query e, dove lo consenti, applicando correzioni. Configuralo una volta sola, concedi solo ciò che serve, e inizia a fare domande invece di scriverle.