BaseLinker MCP (read-only)

Serwer MCP do BaseLinkera dla Claude. Daje dostęp do całego API w trybie tylko-do-odczytu — zamówienia, produkty, stany, faktury, dziennik zdarzeń — prosto z rozmowy z Claude.

Powstał, bo gotowe konektory do BaseLinkera bywają płytkie albo zwracają błędne dane (np. ignorują paginację i filtry). Ten robi to poprawnie, bezpośrednio na API.

Autor: Norbert Sobala — Klevio — wdrażam AI i automatyzację w e-commerce: agenci AI, integracje Base (BaseLinker), dedykowane aplikacje dla sklepów.

Narzędzia

Narzędzie	Co robi
baselinker_call	wywołuje dowolną metodę odczytu BaseLinker API (getOrders, getInventories, getInvoices, getJournalList...)
list_methods	ściągawka najczęstszych metod odczytu, pogrupowana
get_orders_all	pobiera wszystkie zamówienia z poprawną paginacją (omija limit 100/stronę)
get_sales_summary	przychód z dokumentów (faktury + paragony) za rok: po miesiącu + top produkty

Bezpieczeństwo

• Tylko odczyt. Kod twardo blokuje każdą metodę zapisu (add/set/update/delete/run/...). Dozwolone wyłącznie get* / download*.
• Token zostaje na Twoim komputerze (podajesz go przy instalacji rozszerzenia).

Instalacja (Claude Desktop, rozszerzenie .mcpb)

1. Zainstaluj uv (jednorazowo) — dzięki niemu rozszerzenie działa na macOS, Windows i Linux bez ręcznego ogarniania zależności.
   • macOS / Linux: curl -LsSf https://astral.sh/uv/install.sh | sh
   • Windows (PowerShell): winget install astral-sh.uv
2. Pobierz baselinker-mcp.mcpb i przeciągnij do Claude Desktop → Settings → Extensions (albo otwórz plik).
3. W oknie konfiguracji wklej Token API BaseLinker.
4. Gotowe — Claude widzi narzędzia BaseLinkera.

Skąd wziąć token

BaseLinker → Moje konto → API → wygeneruj/skopiuj token.

Uwaga o limicie API

getOrders zwraca zwykle ostatnie ~3 miesiące zamówień (starsze są archiwizowane i niedostępne przez API). Dokumenty (faktury/paragony) sięgają głębiej — stąd get_sales_summary liczy przychód z dokumentów.

Licencja

MIT — patrz LICENSE.