Przejdź do treści

Налаштування

Створіть ключ API з потрібними дозволами та під'єднайте Cursor, Claude Desktop або іншого клієнта MCP до Qamera AI.

Що потрібно

  1. Обліковий запис Qamera AI — зареєструйтеся на qamera.ai.
  2. Ключ API з двома дозволами, створений у налаштуваннях робочого простору.

Встановлювати нічого не треба. MCP-сервер розміщуємо ми за адресою https://mcp.qamera.ai; ваш AI-клієнт з'єднується з ним через мережу.

Створення ключа API

  1. Увійдіть до Qamera AI.
  2. Відкрийте Налаштування робочого простору й перейдіть до Ключів API.
  3. Оберіть Створити ключ і дайте йому назву, за якою впізнаєте його згодом, — наприклад, назву інструмента, який під'єднуєте.
  4. Позначте обидва дозволи:
    • Реєстрація контенту (content.register) — усе, що стосується продуктів, генерування, попередніх переглядів і затвердження.
    • Читання статусу контенту (content.read) — перевірка, чи завершилося генерування.
  5. Скопіюйте ключ, коли він з'явиться.

Нічого не позначено за замовчуванням, і одного дозволу замало. Форма вимагає щонайменше одного й нічого не пропонує, тому легко створити ключ лише з першим. Такий ключ працює майже скрізь, а на перевірці статусу повертає помилку дозволів — і це має вигляд генерування, яке так і не почалося, а не ключа з непозначеним пунктом.

Який вигляд має ключ. Він починається з mk_live_, далі йде ідентифікатор, крапка й секрет: mk_live_<ідентифікатор>.<секрет>. Якщо у вставленому тексті немає крапки або він не починається з mk_live_, копіювання було неповним.

Секрет показуємо лише один раз. Згодом відновити його неможливо — якщо загубите, створіть новий ключ і видаліть старий. Не зберігайте його у спільних документах і ніде, що потрапляє до репозиторію.

Cursor

Створіть або відкрийте файл .cursor/mcp.json у своєму проєкті:

{
  "mcpServers": {
    "qamera-ai": {
      "url": "https://mcp.qamera.ai",
      "transport": { "type": "sse" },
      "headers": {
        "Authorization": "Bearer ВАШ_КЛЮЧ_QAMERA_AI"
      }
    }
  }
}

Замініть ВАШ_КЛЮЧ_QAMERA_AI скопійованим ключем. Збережіть слово Bearer і один пробіл, що відокремлює його від ключа.

Далі:

  1. Збережіть файл.
  2. Перезапустіть Cursor, щоб він підхопив новий сервер.
  3. Відкрийте чат AI і запитайте, наприклад: «Виведи мої продукти в Qamera AI».

Якщо інструменти не з'явилися, загляньте до Усунення несправностей — найчастіша причина — ключ, а не конфігурація.

Claude Desktop

Claude Desktop з'єднується з віддаленим сервером як конектор, який додають у налаштуваннях, а не у файлі конфігурації.

  1. Відкрийте Налаштування — Ctrl + , у Windows, Cmd + , у macOS — потім Конектори.
  2. Оберіть Додати, далі Додати власний конектор.
  3. Введіть адресу сервера: https://mcp.qamera.ai
  4. Розгорніть Заголовки запиту й додайте:
    • назва заголовка x-api-key
    • значення: ваш ключ, точно так, як ви його скопіювали
  5. Натисніть Додати, а потім увімкніть конектор у розмові кнопкою +.

Одне застереження, яке може вас стосуватися. Автентифікація заголовком у власних конекторах — це функція у стадії бета, яку розгортають поступово. Якщо у вікні немає розділу Заголовки запиту, ваш обліковий запис її ще не має — без неї Claude Desktop не зможе автентифікуватися в Qamera AI, і поки що шляхом є Cursor або інший клієнт. Поточний стан доступності подає документація конекторів Anthropic.

У планах Team та Enterprise конектор один раз додає власник у Налаштуваннях організації, а учасники під'єднуються до нього окремо.

Інші клієнти MCP

З розміщеним сервером з'єднається будь-який клієнт, сумісний з MCP.

  • Адреса сервера: https://mcp.qamera.ai
  • Автентифікація: надішліть ключ в одному із заголовків:
    • Authorization: Bearer ВАШ_КЛЮЧ
    • X-Api-Key: ВАШ_КЛЮЧ

Перевірка, чи сервер працює

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

Успішна відповідь означає, що сервер доступний. Про ваш ключ вона не каже нічого — відхилений ключ спричиняє помилку вже під час з'єднання, і це описано на сторінці усунення несправностей.

Якщо ви налаштовували Qamera AI до серпня 2026

Попередня адреса — IP з номером порту, через звичайний http — досі працює, тож ніщо з налаштованого сьогодні не перестане працювати. Перейдіть на https://mcp.qamera.ai, коли буде зручно: стара адреса надсилає ваш ключ API незашифрованим і буде виведена з ужитку, щойно інтеграції переїдуть.

Що далі