AI-VERBINDINGEN · MCP

Verbind je AI-assistent.

Vind betalingen, controleer saldi en maak facturen via je eigen Wholly Crypto-installatie.

Jouw server. Eén MCP-URL.

Inbegrepen in merchant 5.0.0+. Geen extra daemon, Node.js-runtime of gehoste relay. Gebruik het ingestelde API-domein van de installatie, bijvoorbeeld https://api.example.com/mcp.

Open Instellingen → API-toegang. Maak een afzonderlijke API-referentie en wijs de projecten toe die je assistent nodig heeft. Begin met alleen-lezen.
Bekijk in AI-verbindingen · MCP, schakel MCP in. Selecteer je API-referentie en kies Alleen-lezen en sla op.
Voeg de getoonde URL toe aan de instellingen voor externe HTTP/MCP-verbindingen van je assistent.
Log voor OAuth in op je handelaarsconsole. Controleer de clientnaam, het terugkeeradres en de rechten van de API-referentie en geef daarna toestemming. Je bestaande Basic Auth en TOTP blijven gelden.

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

Vervang het voorbeelddomein. Configuratieformaten verschillen per client; kies Streamable HTTP, geen lokale opdracht of verouderde SSE-URL.

Stel vragen over je betalingen.

“Toon de laatste onbetaalde facturen van mijn winkel.”
“Welke activa kan deze winkel accepteren?”
“Controleer walletsaldi en mislukte webhookbezorgingen.”
“Maak een factuur van 25 EUR voor bestelling 1042.” Vereist toestemming om facturen te maken.

Acht leeshulpmiddelen omvatten projecten, winkels, betaalmethoden, wallets, facturen, bezorggeschiedenis en gecachte omrekeningen. Een optioneel negende hulpmiddel maakt facturen volgens de bestaande API-regels.

Resultaten bevatten project- en winkel-ID's. Bedragen blijven decimale tekenreeksen. Gecachte koersen en saldi behouden informatie over hun actualiteit; een omrekening is geen gegarandeerde factuurprijsopgave.

Kies waartoe de assistent toegang krijgt.

MCP staat standaard uit, ook na een upgrade. Bestaande API-sleutels krijgen niet automatisch toegang. De assistent ziet alleen goedgekeurde projecten; IP-beperkingen en de REST-aanvraaglimiet van de API-referentie gelden ook voor MCP.

Selecteer om facturen te maken een API-referentie met lees-/schrijfrechten en Lezen + facturen maken. OAuth-clients moeten mcp:invoice:createaanvragen en jij moet Ook facturen maken toestaan aanvinken tijdens de goedkeuring.

Hergebruik dezelfde idempotency_key en factuurbody na een time-out. Een nieuwe sleutel maakt een nieuwe factuur. Normale regels voor opslag, tolerantie, betalingen en tegoed blijven gelden.

Geen sleutelexports of hulpmiddelen om geld te versturen. MCP kan geen herstelzinnen onthullen, geld versturen, sweeps uitvoeren, terugbetalen, callbacks opnieuw versturen of accounts, domeinen en facturering wijzigen.

OAuth, bearersleutels en intrekken

OAuth-toegangstokens zijn 15 minuten geldig. Vernieuwingstokens rouleren en de verbinding duurt maximaal 30 dagen. Hergebruik van een oud vernieuwingstoken trekt de verbinding in. Alleen geregistreerde HTTPS- of loopback-terugkeer-URL's worden geaccepteerd.

Gebruik Verbonden clients → Intrekken om toegang te verwijderen. MCP uitschakelen trekt OAuth-verbindingen in. Vernieuwing van API-referenties, wijzigingen in MCP-beleid en wijzigingen van het canonieke API-domein vereisen een nieuwe verbinding.

Clients met ondersteuning voor eigen headers kunnen een API-sleutel met ingeschakelde MCP gebruiken in Authorization: Bearer …. Die sleutel behoudt zijn afzonderlijke REST-rechten, dus gebruik bij voorkeur OAuth voor uitsluitend MCP-toegang. Plak geheimen nooit in chat, URL's of broncode.

Geef alleen toestemming aan een client die je herkent. Clientnamen worden niet geverifieerd. Je AI-provider ontvangt de informatie die je toestaat te lezen, inclusief klantgegevens die factuurhulpmiddelen teruggeven.

Als een verbinding mislukt.

404: schakel MCP in en gebruik de API-host, niet de console- of afrekenhost.
401: verbind opnieuw met OAuth of controleer of je bearerreferentie geldig is.
403: controleer de rechten van de API-referentie, goedgekeurde projecten, oorsprong en bron-IP-beperkingen.
405 bij GET: verwacht. Dit statusloze eindpunt gebruikt POST en eindige JSON-antwoorden, zonder afzonderlijke SSE-stream.
429: wacht op Retry-After. MCP en REST delen het quotum van de API-referentie.
Kan geen facturen maken: controleer alle schrijfrechten, project-/winkelstatus, betaalgereedheid en verificatie van het tegoedaccount.

Houd Cloudflare-caching en interactieve challenges uit voor /mcp, /mcp/oauth/* en OAuth-discoverypaden. IP-toelatingslijsten moeten de gedocumenteerde uitgaande adressen van de assistentdienst bevatten.

Ondersteunde protocolrevisies: 2025-11-25, 2025-06-18 en 2025-03-26. De client moet één hiervan ondersteunen. Zie de API-referentie voor elk hulpmiddel, eindpunt en foutformaat.

Kies betaalmethoden per factuur.

Gebruik invoice.payment_methods met chain_slug: "ethereum" en asset_tickers: ["USDC", "USDT"]. Vind slugs en tickersymbolen onder de betaalmethoden van de winkel of met list_payment_methods.

Merchant 5.4.0+ negeert inactieve of niet-geaccepteerde keuzes. Als geen keuze overeenkomt, gelden de winkelstandaarden. Alleen een blockchain kiezen omvat alle actieve geaccepteerde activa. Gedeelde tickersymbolen vereisen exacte asset_ids. Gereedheids- en koerscontroles blijven gelden, met blockchainspecifieke fouten. Lightning staat afzonderlijk; een lege selectiearray is ongeldig. Verzoekformaat →