CONNESSIONI AI · MCP

Collega il tuo assistente IA.

Trova pagamenti, controlla saldi e crea fatture tramite la tua installazione Wholly Crypto.

Il tuo server. Un URL MCP.

Incluso nel merchant 5.0.0+. Nessun demone aggiuntivo, runtime Node.js o relay ospitato. Usa il dominio API configurato nell'installazione, ad esempio https://api.example.com/mcp.

Apri Impostazioni → Accesso API. Crea una credenziale dedicata e assegna i progetti necessari all'assistente. Inizia in sola lettura.
In Connessioni IA · MCP, abilita MCP. Seleziona la credenziale, scegli Sola lettura e salva.
Aggiungi l'URL mostrato alle impostazioni HTTP/MCP remote del tuo assistente.
Per OAuth, accedi alla console merchant. Controlla nome del client, indirizzo di ritorno e permessi della credenziale, poi approva. Basic Auth e TOTP esistenti restano validi.

{
  "mcpServers": {
    "whollycrypto": {
      "url": "https://api.example.com/mcp"
    }
  }
}

Sostituisci il dominio d'esempio. I formati di configurazione variano per client; scegli Streamable HTTP, non un comando locale o un vecchio URL SSE.

Chiedi informazioni sui tuoi pagamenti.

«Mostra le ultime fatture non pagate del mio negozio.»
«Quali asset può accettare questo negozio?»
«Controlla i saldi dei wallet e le consegne webhook fallite.»
«Crea una fattura di 25 EUR per l'ordine 1042.» Richiede il permesso di creare fatture.

Otto strumenti di lettura coprono progetti, negozi, metodi di pagamento, wallet, fatture, cronologia delle consegne e conversioni in cache. Un nono strumento facoltativo crea fatture usando le regole API esistenti.

I risultati includono gli ID di progetto e negozio. Gli importi restano stringhe decimali. Tassi e saldi in cache conservano le informazioni sul loro aggiornamento; una conversione non è una quotazione garantita della fattura.

Scegli a cosa può accedere l'assistente.

MCP è disattivato per impostazione predefinita, anche dopo un aggiornamento. Le chiavi API esistenti non ottengono accesso automaticamente. L'assistente vede solo i progetti approvati; restrizioni IP e limite REST della credenziale si applicano anche a MCP.

Per creare fatture, seleziona una credenziale in lettura/scrittura e Lettura + creazione fatture. I client OAuth devono richiedere mcp:invoice:create, e devi selezionare Consenti anche la creazione di fatture durante l'approvazione.

Riutilizza la stessa idempotency_key e lo stesso corpo fattura dopo un timeout. Una nuova chiave crea una nuova fattura. Restano valide le normali regole di spread, tolleranza, pagamento e credito.

Nessuna esportazione di chiavi o strumento per inviare denaro. MCP non può rivelare frasi di recupero, inviare fondi, eseguire sweep, rimborsare, reinviare callback o modificare account, domini e fatturazione.

OAuth, chiavi bearer e revoca

I token di accesso OAuth durano 15 minuti. I token di aggiornamento ruotano e la connessione dura fino a 30 giorni. Riutilizzare un vecchio token di aggiornamento revoca la connessione. Sono accettati solo URL di ritorno HTTPS o loopback registrati.

Usa Client collegati → Revoca per rimuovere l'accesso. Disattivare MCP revoca le connessioni OAuth. Rotazione delle credenziali, modifiche alla politica MCP e al dominio API canonico richiedono una nuova connessione.

I client che supportano header personalizzati possono usare una chiave API abilitata a MCP in Authorization: Bearer …. Quella chiave mantiene i suoi permessi REST separati, quindi preferisci OAuth per l'accesso solo MCP. Non incollare mai segreti in chat, URL o codice sorgente.

Approva solo client che riconosci. I nomi dei client non sono verificati. Il tuo provider IA riceve le informazioni che lo autorizzi a leggere, inclusi i dati dei clienti restituiti dagli strumenti delle fatture.

Se una connessione fallisce.

404: abilita MCP e usa l'host API, non quello della console o del checkout.
401: ricollegati con OAuth o verifica che la credenziale bearer sia valida.
403: controlla accesso della credenziale, progetti approvati, origine e restrizioni IP di origine.
405 su GET: previsto. Questo endpoint senza stato usa POST e risposte JSON finite, senza un flusso SSE autonomo.
429: attendi Retry-After. MCP e REST condividono la quota della credenziale.
Impossibile creare fatture: controlla tutti i permessi di scrittura, lo stato di progetto e negozio, la disponibilità dei pagamenti e la verifica dell'account crediti.

Disattiva cache Cloudflare e verifiche interattive per /mcp, /mcp/oauth/* e i percorsi di discovery OAuth. Le liste di IP consentiti devono includere gli indirizzi di uscita documentati del servizio dell'assistente.

Revisioni del protocollo supportate: 2025-11-25, 2025-06-18 e 2025-03-26. Il client deve supportarne una. Consulta il Riferimento API per ogni strumento, endpoint e formato di errore.

Scegli i metodi di pagamento per ogni fattura.

Usa invoice.payment_methods con chain_slug: "ethereum" e asset_tickers: ["USDC", "USDT"]. Trovi slug e ticker nei Metodi di pagamento del negozio oppure con list_payment_methods.

Il merchant 5.4.0+ ignora le scelte inattive o non accettate. Se nessuna corrisponde, si applicano i valori predefiniti del negozio. La sola blockchain include tutti gli asset attivi accettati. I ticker condivisi richiedono l'esatto asset_ids. I controlli di disponibilità e tassi restano validi, con errori specifici della blockchain. Lightning è separato; un array di selezione vuoto non è valido. Formato della richiesta →