MCP

Korzystaj z WAMA z AI (MCP)

WAMA może współpracować z popularnymi narzędziami AI przez MCP (Model Context Protocol). Po krótkiej konfiguracji możesz pytać asystenta o produkty, stany magazynowe i sprzedaż dla jednego punktu sprzedaży — tego, który wybierzesz przy połączeniu.

Adres serwera (ten sam we wszystkich narzędziach):

https://mcp.wama.cloud/mcp

Dwa sposoby połączenia

Zaloguj się przez WAMA

1. Dodaj adres serwera powyżej w narzędziu AI.
2. Gdy poprosi o client id, wpisz: wama-mcp
3. Dokończ logowanie w przeglądarce, wybierz punkt sprzedaży oraz zakres read lub read & write.
4. Wróć do narzędzia AI — jesteś połączony.

Dostęp możesz później unieważnić w aplikacji webowej: Ustawienia → Integracje.

Wklej klucz API

1. W aplikacji web WAMA: Ustawienia → Integracje → Utwórz klucz API.
2. Wybierz punkt sprzedaży i zakres, potem skopiuj klucz (pokazywany tylko raz).
3. W narzędziu AI dodaj ten sam adres serwera i umieść klucz w nagłówku Authorization tak:

Bearer wama_…twój_klucz…

Więcej: Integracje i przewodnik API.

Cursor

1. Otwórz Cursor Settings → MCP (lub plik konfiguracji MCP).
2. Dodaj serwer wama z URL https://mcp.wama.cloud/mcp.
3. Preferuj logowanie: client id wama-mcp i scope read (lub read_write, jeśli potrzeba).
4. Zatwierdź logowanie w przeglądarce i spróbuj prostego pytania, np. „Wypisz kilka produktów”.

Przykładowa konfiguracja (logowanie):

{
  "mcpServers": {
    "wama": {
      "url": "https://mcp.wama.cloud/mcp",
      "auth": {
        "CLIENT_ID": "wama-mcp",
        "scopes": ["read"]
      }
    }
  }
}

Alternatywa z kluczem: ten sam URL i nagłówek Authorization z Bearer wama_….

Claude Code

W terminalu:

claude mcp add --transport http --client-id wama-mcp wama https://mcp.wama.cloud/mcp

Następnie uruchom claude mcp login wama (lub /mcp w Claude Code) i dokończ logowanie w przeglądarce.

Claude.ai

1. Otwórz ustawienia Claude.ai dla connectors / własnego MCP.
2. Dodaj URL https://mcp.wama.cloud/mcp.
3. Jeśli pyta o client id, użyj wama-mcp.
4. Dokończ logowanie i zgodę WAMA w przeglądarce.

ChatGPT

1. Włącz Developer mode (lub własne MCP / connectors, zależnie od planu ChatGPT).
2. Dodaj serwer MCP z URL https://mcp.wama.cloud/mcp.
3. Preferuj client id wama-mcp (bez secret), jeśli interfejs na to pozwala.
4. Jeśli ChatGPT oferuje tylko automatyczną rejestrację klienta i ona się nie uda, użyj wklejenia klucza API.

VS Code / GitHub Copilot

1. Otwórz ustawienia MCP / Copilot MCP (JSON).
2. Dodaj serwer HTTP wskazujący na https://mcp.wama.cloud/mcp z OAuth client id wama-mcp.
3. Dokończ logowanie w przeglądarce, gdy zostaniesz o to poproszony.

Przykład:

{
  "servers": {
    "wama": {
      "type": "http",
      "url": "https://mcp.wama.cloud/mcp",
      "oauth": {
        "clientId": "wama-mcp"
      }
    }
  }
}

OpenAI Codex CLI

Dodaj serwer MCP HTTP z URL https://mcp.wama.cloud/mcp i OAuth client id wama-mcp. Zobacz aktualną dokumentację Codex dla pliku konfiguracyjnego. Dokończ logowanie w przeglądarce, jeśli jest wymagane.

Windsurf

Dodaj zdalne MCP https://mcp.wama.cloud/mcp z client id wama-mcp, potem dokończ logowanie w przeglądarce.

Inne narzędzia AI

Jeśli narzędzie obsługuje zdalne MCP przez HTTPS:

1. Użyj URL https://mcp.wama.cloud/mcp.
2. Client id wama-mcp (bez secret) przy logowaniu.
3. Albo wklej klucz API jako Authorization: Bearer wama_….

Aplikacje desktopowe otwierające lokalny URL zwrotny (http://localhost… lub http://127.0.0.1…) są obsługiwane automatycznie.

O co możesz pytać

Z podłączonym asystentem (przykłady):

• „Szukaj produktów zawierających …”
• „Jaki jest stan magazynowy produktu …?”
• „Krótkie podsumowanie sprzedaży z tego tygodnia”

Akcje zapisu (korekta stanu, utworzenie lub zakończenie sprzedaży) wymagają zakresu read & write. Preferuj read, dopóki ich nie potrzebujesz.

Wskazówki bezpieczeństwa

• Jedno połączenie = jeden punkt sprzedaży. Utwórz inny klucz lub połącz się ponownie dla innego magazynu/sklepu.
• Traktuj klucze API jak hasła. Nie udostępniaj ich na czacie, w e-mailu ani w publicznych zgłoszeniach.
• Unieważniaj nieużywane klucze w Ustawienia → Integracje.
• Dla programistów korzystających z REST API (nie MCP) zobacz przewodnik API.