Przejdź do treści
Qamera AI
Wypróbuj za darmo

Konfiguracja

Utwórz klucz API z właściwymi uprawnieniami i połącz Cursor, Claude Desktop lub innego klienta MCP z Qamera AI.

Czego potrzebujesz

  1. Konta w Qamera AI — załóż je na qamera.ai.
  2. Klucza API z dwoma uprawnieniami, utworzonego w ustawieniach workspace'u.

Nie musisz niczego instalować. Serwer MCP hostujemy my pod adresem https://mcp.qamera.ai; Twój klient AI łączy się z nim przez sieć.

Tworzenie klucza API

  1. Zaloguj się w Qamera AI.
  2. Otwórz Ustawienia workspace'u i przejdź do Kluczy API.
  3. Wybierz Utwórz klucz i nadaj mu nazwę, po której go później rozpoznasz — na przykład nazwę narzędzia, które podłączasz.
  4. Zaznacz oba uprawnienia:
    • Rejestrowanie treści (content.register) — wszystko, co dotyczy produktów, generowania, podglądów i zatwierdzania.
    • Odczyt statusu treści (content.read) — sprawdzanie, czy generowanie się zakończyło.
  5. Skopiuj klucz, gdy się wyświetli.

Nic nie jest zaznaczone domyślnie, a jedno uprawnienie nie wystarczy. Formularz wymaga przynajmniej jednego i niczego nie proponuje, więc łatwo utworzyć klucz tylko z pierwszym. Taki klucz działa przy niemal wszystkim, a przy sprawdzaniu statusu zwraca błąd uprawnień — co wygląda jak generowanie, które nigdy nie ruszyło, a nie jak klucz z niezaznaczonym polem.

Jak wygląda klucz. Zaczyna się od mk_live_, potem identyfikator, kropka i sekret: mk_live_<identyfikator>.<sekret>. Jeśli we wklejonym tekście nie ma kropki albo nie zaczyna się on od mk_live_, kopiowanie było niepełne.

Sekret pokazujemy tylko raz. Później nie da się go odzyskać — jeśli go zgubisz, utwórz nowy klucz i usuń stary. Nie trzymaj go we współdzielonych dokumentach ani w niczym, co trafia do repozytorium.

Cursor

Utwórz lub otwórz plik .cursor/mcp.json w swoim projekcie:

{
  "mcpServers": {
    "qamera-ai": {
      "url": "https://mcp.qamera.ai",
      "transport": { "type": "sse" },
      "headers": {
        "Authorization": "Bearer TWOJ_KLUCZ_QAMERA_AI"
      }
    }
  }
}

Zastąp TWOJ_KLUCZ_QAMERA_AI skopiowanym kluczem. Zachowaj słowo Bearer i pojedynczą spację, która oddziela je od klucza.

Następnie:

  1. Zapisz plik.
  2. Uruchom Cursor ponownie, żeby wczytał nowy serwer.
  3. Otwórz czat AI i zapytaj na przykład: „Wypisz moje produkty w Qamera AI".

Jeśli narzędzia się nie pojawią, zajrzyj do Rozwiązywania problemów — najczęstszą przyczyną jest klucz, a nie konfiguracja.

Claude Desktop

Claude Desktop łączy się ze zdalnym serwerem jako konektor, dodawany w ustawieniach, a nie w pliku konfiguracyjnym.

  1. Otwórz Ustawienia — Ctrl + , w Windows, Cmd + , w macOS — a potem Konektory.
  2. Wybierz Dodaj, a następnie Dodaj własny konektor.
  3. Wpisz adres serwera: https://mcp.qamera.ai
  4. Rozwiń Nagłówki żądania i dodaj:
    • nazwa nagłówka x-api-key
    • wartość: Twój klucz, dokładnie tak, jak go skopiowałeś
  5. Kliknij Dodaj, a potem włącz konektor w rozmowie przyciskiem +.

Jedno zastrzeżenie, które może Cię dotyczyć. Uwierzytelnianie nagłówkiem we własnych konektorach jest funkcją w wersji beta, udostępnianą stopniowo. Jeśli w oknie nie widzisz sekcji Nagłówki żądania, Twoje konto jeszcze jej nie ma — bez niej Claude Desktop nie uwierzytelni się w Qamera AI i na razie drogą jest Cursor albo inny klient. Aktualny stan dostępności podaje dokumentacja konektorów Anthropic.

W planach Team i Enterprise konektor dodaje raz właściciel w Ustawieniach organizacji, a członkowie łączą się z nim indywidualnie.

Inni klienci MCP

Z hostowanym serwerem połączy się każdy klient zgodny z MCP.

  • Adres serwera: https://mcp.qamera.ai
  • Uwierzytelnianie: wyślij klucz w jednym z nagłówków:
    • Authorization: Bearer TWOJ_KLUCZ
    • X-Api-Key: TWOJ_KLUCZ

Sprawdzenie, czy serwer działa

curl https://mcp.qamera.ai/health

Poprawna odpowiedź oznacza, że serwer jest osiągalny. Nie mówi nic o Twoim kluczu — odrzucony klucz powoduje błąd już przy łączeniu, co opisujemy na stronie rozwiązywania problemów.

Jeśli konfigurowałeś Qamera AI przed sierpniem 2026

Wcześniejszy adres — adres IP z numerem portu, po zwykłym http — nadal działa, więc nic, co masz skonfigurowane, dziś nie przestanie działać. Przejdź na https://mcp.qamera.ai, gdy będzie Ci wygodnie: stary adres wysyła Twój klucz API niezaszyfrowany i zostanie wycofany, gdy integracje się przeniosą.

Co dalej