Verbinden Sie einen Assistenten für die Buchsuche und Kaufvorbereitung. Katalogexport und das Durchprobieren von Kennungen werden nicht unterstützt.
Verbindung
Streamable HTTP, MCP 2025-06-18; HTTP POST JSON und OAuth Authorization Code mit PKCE S256. Server: https://server.exlibrus.net/api/v1/mcp/customer/. OAuth-Metadaten: https://server.exlibrus.net/.well-known/oauth-authorization-server. Senden Sie initialize, notifications/initialized und tools/list. Registrieren Sie einen öffentlichen OAuth-Client. Anmeldung, Registrierung und E-Mail-Bestätigung erfolgen auf der Website. Für ein bestehendes bestätigtes Konto sendet recover_customer_access einen speziellen MCP-Code als reine SMTP-Textnachricht ohne HTML oder Links. Nur diesen angeforderten MCP-Code dürfen Sie dem Agenten für complete_customer_access mit dem ursprünglichen PKCE-Verifier und state geben. Alternativ können Sie die Freigabe im bestehenden Kundenkonto erteilen. Passwörter, Anmelde-, Passwortzurücksetzungs- und 2FA-Codes sowie Zahlungsdaten gehören nicht in Tools.
Suche und Buchanfragen
search_books unterstützt query, publisher_ids, series_ids, periodical_series_ids und category_path. Höchstens 10 Bücher pro Antwort und 30 pro Suchfenster. Bei cursor müssen Suchanfrage und Seitengröße gleich bleiben. book_details ist auf bereits gefundene Bücher begrenzt. resolve_filters löst Filternamen auf.
create_book_request kann mehrere Bücher enthalten. get_book_request, die Positions-Tools und send_request_message verwenden einen gemeinsamen Dialog. Eine anonyme Anfrageberechtigung gilt nur für diese Anfrage. Bestätigte Eigentümer können sie ihrem Kundenkonto zuordnen.
Bestellungen und Geschenke
Warenkorb-Tools, checkout_quote und prepare_gift_purchase liefern die genauen Bedingungen als quote_summary sowie quote_hash und version. Der Assistent zeigt alle Bestellbedingungen einschließlich bestehender Periodika-Bestellungen, Geschenkgestaltung und Empfänger. Nach ausdrücklicher Zustimmung des Nutzers im Gespräch ruft er confirm_purchase mit quote_id und expected_quote_hash auf. Eine gesonderte Kaufbestätigung im Browser ist nicht erforderlich. create_order, purchase_gift und purchase_status lesen nur den wiederholbaren Beleg. Geänderte oder abgelaufene Bedingungen benötigen ein neues Angebot und Zustimmung. Der Mensch zahlt über payment_url, sobald die Rechnung zahlbar ist. Eine Tool-Antwort bestätigt keine Zahlung.
list_orders, order_status und gift_status zeigen ausschließlich eigene Käufe. gift_config und gift_quote zeigen aktuelle Designs und Preise. gift_human_download führt zum geschützten Geschenkbereich des Kundenkontos. PDF und Einlösewörter erscheinen nicht im allgemeinen Status.
Freigaben und Wiederherstellung
Scopes: catalog:read, requests:read, requests:write, cart:read, cart:write, orders:read, orders:create, gifts:read, gifts:purchase. Freigaben sind an einen Client gebunden. Einzelne oder alle Freigaben können im Bereich KI-Zugriff des Kundenkontos widerrufen werden. Refresh und Wiederherstellung über bestätigte E-Mail behalten Limits bei; neue Geheimnisse erfordern menschliche Zustimmung und einen einmaligen PKCE-Austausch.
Fehler und Hilfe
Bei 429 gilt Retry-After; Tokenwechsel umgehen keine Limits. Bei invalid_token Zugriff erneuern, bei stale_quote neue Berechnung und Zustimmung einholen. Nach Zeitüberschreitung dieselbe Änderung mit identischem idempotency_key und unverändertem Inhalt wiederholen. Hilfe: [email protected]. Datenschutz und Nutzungsbedingungen sind über die Website-Navigation erreichbar.
Semantische Suche und Anfragekosten
mode kann text, vector oder hybrid sein. Vector/hybrid erfordert einen bestätigten Kunden mit catalog:read; öffentliche Filter gelten weiterhin. vector_used zeigt an, ob Vektorergebnisse zur Antwort beigetragen haben. Ist der Vektordienst nicht verfügbar, folgt 503; für Textsuche muss text ausdrücklich gewählt werden. Standardmäßig gelten je Kunde 5 semantische Anfragen und 10 vorbereitete Kaufberechnungen pro Minute, höchstens zwei gleichzeitige Vorgänge je Art. Das Kandidatenfenster ist begrenzt und beansprucht keine Vollständigkeit des Katalogs.
Beispiel ohne Kontozugriff
Senden Sie die Nachrichten nacheinander per HTTP POST mit Content-Type: application/json und Accept: application/json, text/event-stream. Nach initialize gilt MCP-Protocol-Version: 2025-06-18. notifications/initialized liefert eine leere202-Antwort; SSE GET wird nicht angeboten. Das Beispiel führt nur eine anonyme Textsuche aus.
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"shopping-client","version":"1.0.0"}}}{"jsonrpc":"2.0","method":"notifications/initialized"}{"jsonrpc":"2.0","id":2,"method":"tools/list"}{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_books","arguments":{"query":"rare books","locale":"en","limit":10,"mode":"text"}}}