Come interrogare i dati di Stripe con Claude/Cursore tramite MCP (Configurazione del server Stripe MCP)

Scoprite tutto ciò che Query Streams può fare oltre questa guida Iniziare gratis

Supporti

+più

Dati in tempo reale

Sostituire le esportazioni con SQL on-demand

Excel Lenzuola

Analisi BI e AI

Chiedi a Nova, ottieni SQL + grafici

Incontrare Nova

API REST del database

Una chiave per ogni partner. Nessuna credenziale condivisa.

Creare un'API

+più

Automazione

Sincronizzazione programmata con oltre 6 piattaforme

Esplorare

+più

Da API a SQL

Interrogare le API con SQL, senza codice

Esplorare

+più

Database AI MCP

Claude, Cursor, ChatGPT e Grok interagiscono con i tuoi dati

Connetti l'IA

Query Streams è una piattaforma di integrazione dati sicura e in tempo reale che integra tutti i database e le API SaaS del tuo account in Claude, Cursor, ChatGPT e Grok, tramite un'unica chiave MCP e senza modifiche al firewall. Questa guida illustra il striscia mcp percorso specifico, in modo che il tuo strumento AI possa rispondere a domande in linguaggio naturale su clienti, abbonamenti, addebiti, fatture e rimborsi senza che tu debba esportare file CSV dalla dashboard di Stripe o concatenare chiamate di paginazione API REST in uno script. L'agente di rete preleva i dati API di Stripe in una cache DuckDB locale, in modo che l'LLM veda superfici SQL pulite (clienti, abbonamenti, addebiti, fatture, rimborsi, pagamenti) invece di endpoint REST grezzi, con colonne di denaro contrassegnate come valuta_unità_minore_USD quindi l'IA divide automaticamente gli importi per 100 e non segnala mai un addebito di $ 1.234,56 come "$ 123.456". Per saperne di più, visita QueryStreams.com e iscriviti gratuitamente per iniziare a porre al tuo strumento di intelligenza artificiale domande reali su Stripe.

Cosa ti offre il server Query Streams Stripe MCP

Stripe fornisce un'eccellente superficie AI proprietaria: Kit di strumenti per agenti Stripe — che fornisce agli agenti AI wrapper di chiamate di funzione di lettura e scrittura attorno all'API REST di Stripe per azioni come la creazione di clienti, la generazione di sessioni di Checkout, l'emissione di rimborsi e l'annullamento degli abbonamenti. Questo è lo strumento giusto quando l'IA ha bisogno di Fare cose dal lato di Stripe. Il server Query Streams stripe mcp risolve un problema completamente diverso: un superficie di analisi in sola lettura sui tuoi dati Stripe, esposti come SQL, con la stessa traccia di controllo e la stessa portata multi-connettore di ogni altro connettore Query Streams MCP. Esistono anche altri wrapper Stripe MCP open source che vediamo su GitHub, la maggior parte dei quali invia REST Stripe grezzi o cursori di paginazione al LLM, senza interfaccia SQL, senza semantica che tenga conto dei centesimi, senza imposizione della sola lettura. Query Streams ti offre una chiave, ogni connettore, una traccia di controllo completa, l'agente normalizza le risposte API di Stripe in interfacce SQL e lo strumento di intelligenza artificiale non conserva mai le tue chiavi API di Stripe.

Come funziona senza aprire le porte del firewall

L'agente di rete Query Streams si installa una sola volta su qualsiasi macchina con accesso a Internet (l'API di Stripe è raggiungibile da qualsiasi luogo) e mantiene un singolo collegamento cloud TLS in uscita: niente in entrata, niente esposto. La particolarità di Stripe è che, quando arriva una domanda, l'agente impagina gli endpoint REST di Stripe e memorizza nella cache le risposte in un DuckDB locale, in modo che LLM veda superfici SQL pulite. clienti, abbonamenti, articoli_in_abbonamento, oneri, fatture, rimborsi, pagamenti, prezzi, prodotti — invece delle buste REST. Lo strumento di intelligenza artificiale non visualizza mai la chiave API con restrizioni di Stripe, l'ID del tuo account Stripe Connect o alcun dato di pagamento del cliente. Come funziona il collegamento agente solo in uscita →

Il tasto MCP che assegni al cursore o a Claude è vincolato a un ambito specifico (Leggere / analizzare / eseguire), revocabile in qualsiasi momento e con limitazione di frequenza per chiave. Lo strumento di intelligenza artificiale richiama questi strumenti MCP per svolgere il suo lavoro:

Perché Schema Intelligence rende Query Streams MCP diverso

La maggior parte dei server "MCP per Stripe" nel panorama open-source forniscono al tuo strumento di IA lo stesso riferimento alla risorsa REST che Stripe pubblica per gli sviluppatori, o peggio, il grezzo schema_informativo di qualsiasi cache mantengano. Nomi dei campi. Tipi di dati. Forse una chiave primaria. L'LLM è lasciato a indovinare che quantità deve essere diviso per 100 perché Stripe memorizza il denaro in centesimi, che livemode = falso le righe sono addebiti di prova che dovrebbero essere filtrati dalle entrate, che stato degli abbonamenti è un enum di prova / attivo / scaduto / annullato / non retribuito / incompleto, o quello creato È necessario convertire i dati tramite gli helper di timestamp di DuckDB. Ecco perché la prima query SQL che la maggior parte degli LLM scrive su uno schema Stripe di base è errata, non perché l'LLM sia inefficiente, ma perché non dispone dei dati necessari per essere corretto (e segnalare "1.234.567.890 dollari di MRR" perché nessuno ha diviso per 100 è il tipo di errore che finisce per essere uno screenshot nella chat di Slack del team finanziario).

Query Streams MCP restituisce lo stesso schema Stripe memorizzato nella cache arricchito con ciò che chiamiamo Schema Intelligence (SI) — Metadati curati dall'IA generati eseguendo query di profilazione sul tuo reale Dati Stripe prima ancora che il client AI li richieda. Quando SI è abilitato sul connettore Stripe, ogni strumento di schema che l'AI chiama (qs_get_connector_schema, qs_get_table_schema, qs_profile_table, qs_get_relationships) restituisce lo schema memorizzato nella cache più sei livelli di conoscenza curata. LLM smette di fare supposizioni.

Per rendere questo concreto, ecco cosa riceve il client AI da un singolo qs_get_table_schema chiamata contro il connettore Stripe oneri tabella — la tabella transazionale centrale che genera il 90% delle domande relative ai ricavi — prima senza Schema Intelligence, poi con essa.

I sei livelli Schema Intelligence aggiungono

Ogni livello affronta una specifica classe di domande a cui l'LLM altrimenti dovrebbe rispondere con delle supposizioni. SI è facoltativo per (connettore, database) Questo processo si associa e viene eseguito come una singola passata di profilazione sui dati: non modifica lo schema, non scrive nel database e si aggiorna in modo incrementale quando lo schema cambia.

Stesso prompt, SQL diverso

La prova sta nel codice SQL che lo strumento di intelligenza artificiale scrive effettivamente. Stessa sessione del cursore, stesso modello di Claude, stesso prompt — "Quali clienti hanno speso di più negli ultimi 30 giorni, considerando solo le spese di produzione andate a buon fine?" Senza Schema Intelligence, LLM deve procedere per tentativi. Con essa, LLM sa che l'importo è espresso in centesimi, che l'enumerazione dello stato necessita di un filtro, che livemode = true è il filtro di produzione e che la chiave esterna del cliente gli consente di unire i clienti per ottenere email leggibili dall'uomo.

Query Streams MCP vs Stripe Agent Toolkit

Stripe spedisce il Kit di strumenti per agenti Stripe — un set ufficiale di wrapper per chiamate di funzione attorno all'API REST di Stripe progettato per LangChain, l'SDK OpenAI Agents, l'SDK Vercel AI e framework di agenti simili. È di lettura e scrittura per impostazione predefinita: un agente AI con accesso ad Agent Toolkit può clienti creano, abbonamento annulla, rimborsi creare, checkout.sessions.createe così via. Questa è esattamente la forma giusta quando l'IA dovrebbe atto Su Stripe, un assistente virtuale gestisce i rimborsi, un bot di onboarding crea i link di pagamento e un agente di vendita aggiorna i metadati dei clienti. Query Streams MCP risolve un problema diverso: una superficie di analisi in sola lettura sui dati di Stripe esposti come SQL. I due strumenti rispondono a domande diverse. Ecco un confronto tra di loro in base agli aspetti che contano davvero quando uno strumento di intelligenza artificiale accede ai dati di Stripe.

MCP non fa per te? Prova Nova AI.

Salta completamente MCP e fai domande a Stripe come "Qual è stato l'andamento del nostro MRR negli ultimi 12 mesi?" O "Quali abbonamenti sono a rischio nei prossimi 30 giorni?Direttamente dal portale Query Streams: nessun file di configurazione, stesso Network Agent e Schema Intelligence sottostanti.

Scopri Nova AI

Prerequisiti

Prima di iniziare, assicurati di avere:

1. Un account Query Streams gratuito su my.querystreams.com.
2. L'agente di rete Query Streams installato su una macchina con accesso a Internet — vedere Scarica l'agente Query StreamsL'API di Stripe è accessibile da qualsiasi luogo, quindi l'agente non ha bisogno di trovarsi su una rete specifica.
3. Un connettore Stripe configurato contro l'agente — vedi quello esistente Impostazione del connettore API guide per l'abbinamento Stripe. Utilizzare un Chiave API di Stripe con restrizioni (consigliato) in modo da poter limitare l'accesso in lettura dell'agente a risorse specifiche (ad esempio, leggere su oneri / abbonamenti / clienti / fatturenessun accesso a bilancia / pagamenti / storie (se non ne hai bisogno). L'agente detiene la chiave API di Stripe; lo strumento di intelligenza artificiale non la tocca mai.
4. Qualsiasi client AI compatibile con MCP. In questa guida mostreremo Cursor, Claude Desktop, ChatGPT e Grok; se utilizzi Windsurf, Zed, Continue, Cline, VS Code Copilot, Codex o Goose, il blocco di configurazione è sostanzialmente lo stesso.
5. Cinque minuti.

Passaggio 1: Generare una chiave MCP in Query Streams

Accedi a Query Streams e apri il Pagina MCP (oppure accedi prima a my.querystreams.com e clicca MCP nella navigazione a sinistra). Fare clic Genera chiave, dare alla chiave un nome riconoscibile (qualcosa come cursore-laptop o claude-desktop), e seleziona gli ambiti che desideri assegnare a questa chiave:

• Leggere — L'IA può esplorare i connettori e leggere lo schema. Necessario per tutto il resto.
• analizzare — L'IA può profilare le tabelle e scoprire relazioni (valori campione, distribuzioni, tipi semantici). Opzionale ma fortemente consigliato per il lavoro in ambito finanziario, dove è fondamentale comprendere la struttura dei dati relativi a spese/abbonamenti/fatture e la semantica delle metriche (colonne monetarie con indicazione dei centesimi, enumerazioni di stato, segnalazione in tempo reale).
• eseguire — l'IA è effettivamente in grado di eseguire query SQL. Senza questa funzionalità, l'IA può accedere solo ai metadati dello schema in sola lettura.

Per un tipico flusso di lavoro "lascia che Claude analizzi i miei dati Stripe", tutti e tre gli ambiti sono appropriati. Per una chiave che stai consegnando a un collega o a un cliente meno affidabile, elimina eseguire e consentire loro solo di navigare. È possibile revocare qualsiasi chiave in qualsiasi momento dalla stessa pagina; il client AI vedrà MCP_KEY_REVOCATA alla sua prossima chiamata e smette di funzionare immediatamente. Non c'è ritardo di propagazione.

Copia la chiave ora: Query Streams la mostra una sola volta, poi memorizza solo un hash. Se la perdi, generane una nuova. La chiave ha questo aspetto: qsmcp_ seguito da 48 caratteri casuali ed è ciò che il tuo client AI invia nel Chiave X-MCP intestazione della richiesta.

Passaggio 2: Aggiungi Query Streams MCP al tuo client AI

La configurazione ha la stessa forma su ogni client compatibile con MCP: una voce del server MCP che punta a https://mcp.querystreams.com con la tua chiave nella Chiave X-MCP Intestazione. Seleziona il tuo cliente qui sotto.

Cursore ~/.cursor/mcp.json

// Modifica ~/.cursor/mcp.json
{
  "mcpServers": {
    "querystreams": {
      "url": "https://mcp.querystreams.com",
      "intestazioni": {
        "X-MCP-Key": "qsmcp_INSERISCI_QUI_LA_CHIAVE"
      }
    }
  }
}

Claude Desktop claude_desktop_config.json

// Impostazioni → Sviluppatore → Modifica configurazione
{
  "mcpServers": {
    "querystreams": {
      "url": "https://mcp.querystreams.com",
      "intestazioni": {
        "X-MCP-Key": "qsmcp_INSERISCI_QUI_LA_CHIAVE"
      }
    }
  }
}

ChatGPT App e connettori

// Impostazioni → App e connettori → Aggiungi MCP
URL del server  https://mcp.querystreams.com
Intestazione di autorizzazione Chiave X-MCP
Valore dell'intestazione qsmcp_INSERISCI_QUI_LA_CHIAVE

// Richiede un piano ChatGPT a pagamento
// (Plus / Pro / Team / Enterprise).

Grok Strumenti MCP remoti

// Grok → Impostazioni → Strumenti
{
  "mcp_servers": [{
    "nome": "querystreams",
    "url": "https://mcp.querystreams.com",
    "auth_header": "X-MCP-Key",
    "valore_di_autenticazione": "qsmcp_..."
  }]
}

Riavvia il tuo client AI. Al successivo avvio, rileverà gli otto strumenti Query Streams MCP elencati sopra e li renderà disponibili nella sua tavolozza degli strumenti. In Cursor e Claude Desktop puoi verificarlo digitando “connettori di elenco” — l'IA dovrebbe chiamare qs_list_connectors e restituisci il tuo connettore Stripe (insieme a tutto ciò che hai configurato, incluse eventuali piattaforme Stripe Connect aggiuntive se hai associato più account).

Passaggio 3: Poni una domanda a Stripe all'IA

Non devi scrivere query SQL, lo fa l'IA. Poni una domanda, l'IA seleziona lo strumento MCP più adatto, l'agente esegue la query sui dati Stripe memorizzati nella cache e la risposta viene restituita in formato testo e tabelle. Ecco tre esempi di domande da provare:

La prima volta che l'IA richiama uno strumento, il tuo client potrebbe visualizzare una richiesta di conferma per autorizzare la chiamata allo strumento: si tratta del flusso di consenso standard di MCP, non di una funzionalità aggiunta da Query Streams. Approva una volta e l'IA procederà liberamente con il resto della conversazione. Puoi rivedere il consenso in qualsiasi momento nelle impostazioni del tuo client.

Domande frequenti

Inizia

Guide correlate: Scarica l'agente Query Streams | Impostazione del connettore API | Tutte le guide del server MCP | Nova AI text-to-SQL

Categoria: Server MCP

Tag: mcp, claude, cursore, stripe, connettore API, pagamenti, metriche SaaS, mrr, toolkit agente Stripe, mcp di sola lettura

Meta Description: Interroga Stripe con Claude o Cursor tramite MCP. Interfaccia SQL di sola lettura, semantica sensibile ai centesimi, chiavi API con restrizioni, nessuna modifica al firewall. Gratuito.