whollycrypto.
Polski

POŁĄCZENIA AI · MCP

Podłącz swojego asystenta AI.

Wyszukuj płatności, sprawdzaj salda i twórz faktury przez własną instalację Wholly Crypto.

Twój serwer. Jeden adres URL MCP.

Wbudowane w oprogramowanie sprzedawcy 5.0.0+. Bez dodatkowego demona, środowiska Node.js ani hostowanego przekaźnika. Użyj skonfigurowanej domeny API instalacji, na przykład https://api.example.com/mcp.

  1. Otwórz Ustawienia → Dostęp API. Utwórz oddzielne dane dostępu i przypisz projekty potrzebne asystentowi. Zacznij od dostępu tylko do odczytu.
  2. W Połączenia AI · MCP, włącz MCP. Wybierz dane dostępu, a następnie Tylko odczyt i zapisz.
  3. Dodaj wyświetlony adres URL w ustawieniach zdalnego HTTP/MCP asystenta.
  4. W przypadku OAuth zaloguj się do panelu sprzedawcy. Sprawdź nazwę klienta, adres powrotny i uprawnienia danych dostępu, a następnie zatwierdź. Istniejące Basic Auth i TOTP nadal obowiązują.
{
  "mcpServers": {
    "whollycrypto": {
      "url": "https://api.example.com/mcp"
    }
  }
}

Zastąp przykładową domenę. Formaty konfiguracji różnią się między klientami; wybierz Streamable HTTP, a nie lokalne polecenie lub starszy adres SSE.

Zapytaj o swoje płatności.

  • „Pokaż najnowsze nieopłacone faktury mojego sklepu”.
  • „Jakie aktywa może przyjmować ten sklep?”
  • „Sprawdź salda portfeli i nieudane dostarczenia webhooków”.
  • „Utwórz fakturę na 25 EUR dla zamówienia 1042”. Wymaga uprawnienia do tworzenia faktur.

Osiem narzędzi odczytu obejmuje projekty, sklepy, metody płatności, portfele, faktury, historię dostarczania i buforowane przeliczenia. Opcjonalne dziewiąte narzędzie tworzy faktury zgodnie z istniejącymi zasadami API.

Wyniki zawierają identyfikatory projektów i sklepów. Kwoty pozostają ciągami dziesiętnymi. Buforowane kursy i salda zachowują informacje o aktualności; przeliczenie nie jest gwarantowaną wyceną faktury.

Wybierz, do czego asystent ma dostęp.

MCP jest domyślnie wyłączone, również po aktualizacji. Istniejące klucze API nie otrzymują dostępu automatycznie. Asystent widzi wyłącznie zatwierdzone projekty; ograniczenia IP i limit zapytań REST danych dostępu obowiązują także w MCP.

Aby tworzyć faktury, wybierz dane dostępu z prawem odczytu i zapisu oraz Odczyt + tworzenie faktur. Klienci OAuth muszą zażądać mcp:invoice:create, a Ty musisz zaznaczyć Zezwól także na tworzenie faktur podczas zatwierdzania.

Po przekroczeniu czasu oczekiwania użyj ponownie tego samego idempotency_key i treści faktury. Nowy klucz tworzy nową fakturę. Nadal obowiązują zwykłe zasady narzutu kursowego, tolerancji, płatności i salda.

Bez eksportu kluczy ani narzędzi do wysyłania środków. MCP nie może ujawniać fraz odzyskiwania, wysyłać środków, wykonywać operacji sweep, zwrotów ani ponownego wysyłania wywołań zwrotnych, ani zmieniać kont, domen i rozliczeń.

OAuth, klucze bearer i unieważnianie

Tokeny dostępu OAuth są ważne przez 15 minut. Tokeny odświeżania rotują, a połączenie trwa do 30 dni. Ponowne użycie starego tokena odświeżania unieważnia połączenie. Akceptowane są wyłącznie zarejestrowane adresy powrotne HTTPS lub pętli zwrotnej.

Użyj Podłączone aplikacje → Unieważnij aby odebrać dostęp. Wyłączenie MCP unieważnia połączenia OAuth. Rotacja danych dostępu, zmiany polityki MCP i zmiany kanonicznej domeny API wymagają nowego połączenia.

Klienci obsługujący własne nagłówki mogą używać klucza API z włączonym MCP w Authorization: Bearer …. Ten klucz zachowuje oddzielne uprawnienia REST, dlatego do dostępu wyłącznie MCP preferuj OAuth. Nigdy nie wklejaj sekretów do czatu, adresów URL ani kodu źródłowego.

Zatwierdzaj tylko klienta, którego rozpoznajesz. Nazwy klientów nie są weryfikowane. Dostawca AI otrzymuje informacje, których odczyt zatwierdzisz, w tym dane klientów zwracane przez narzędzia faktur.

Jeśli połączenie nie działa.

  • 404: włącz MCP i użyj hosta API, a nie hosta panelu lub strony płatności.
  • 401: połącz ponownie przez OAuth lub sprawdź ważność danych dostępu bearer.
  • 403: sprawdź uprawnienia danych dostępu, zatwierdzone projekty, origin i ograniczenia źródłowego adresu IP.
  • 405 przy GET: to oczekiwane zachowanie. Ten bezstanowy punkt końcowy używa POST i skończonych odpowiedzi JSON, bez samodzielnego strumienia SSE.
  • 429: odczekaj zgodnie z Retry-After. MCP i REST współdzielą limit danych dostępu.
  • Nie można tworzyć faktur: sprawdź wszystkie uprawnienia zapisu, stan projektu/sklepu, gotowość płatności i weryfikację konta salda przedpłaconego.

Wyłącz buforowanie Cloudflare i interaktywne wyzwania dla /mcp, /mcp/oauth/* oraz ścieżek wykrywania OAuth. Listy dozwolonych adresów IP muszą uwzględniać udokumentowane adresy wyjściowe usługi asystenta.

Obsługiwane wersje protokołu: 2025-11-25, 2025-06-18 i 2025-03-26. Klient musi obsługiwać jedną z nich. Zobacz Dokumentacja referencyjna API aby poznać wszystkie narzędzia, punkty końcowe i formaty błędów.

Wybieraj metody płatności dla każdej faktury.

Użyj invoice.payment_methods z chain_slug: "ethereum" i asset_tickers: ["USDC", "USDT"]. Slugi i symbole znajdziesz w metodach płatności sklepu lub przez list_payment_methods.

Merchant 5.4.0+ pomija nieaktywne lub nieakceptowane opcje. Jeśli żadna nie pasuje, stosowane są ustawienia domyślne sklepu. Wybór samego blockchaina obejmuje wszystkie aktywne akceptowane aktywa. Wspólne symbole wymagają dokładnego asset_ids. Nadal obowiązują kontrole gotowości i kursów, z błędami właściwymi dla blockchaina. Lightning jest oddzielne; pusta tablica wyboru jest nieprawidłowa. Format żądania →