Налаштування
Створіть ключ API з потрібними дозволами та під'єднайте Cursor, Claude Desktop або іншого клієнта MCP до Qamera AI.
Що потрібно
- Обліковий запис Qamera AI — зареєструйтеся на qamera.ai.
- Ключ API з двома дозволами, створений у налаштуваннях робочого простору.
Встановлювати нічого не треба. MCP-сервер розміщуємо ми за адресою https://mcp.qamera.ai; ваш AI-клієнт з'єднується з ним через мережу.
Створення ключа API
- Увійдіть до Qamera AI.
- Відкрийте Налаштування робочого простору й перейдіть до Ключів API.
- Оберіть Створити ключ і дайте йому назву, за якою впізнаєте його згодом, — наприклад, назву інструмента, який під'єднуєте.
- Позначте обидва дозволи:
- Реєстрація контенту (
content.register) — усе, що стосується продуктів, генерування, попередніх переглядів і затвердження. - Читання статусу контенту (
content.read) — перевірка, чи завершилося генерування.
- Реєстрація контенту (
- Скопіюйте ключ, коли він з'явиться.
Нічого не позначено за замовчуванням, і одного дозволу замало. Форма вимагає щонайменше одного й нічого не пропонує, тому легко створити ключ лише з першим. Такий ключ працює майже скрізь, а на перевірці статусу повертає помилку дозволів — і це має вигляд генерування, яке так і не почалося, а не ключа з непозначеним пунктом.
Який вигляд має ключ. Він починається з 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 і один пробіл, що відокремлює його від ключа.
Далі:
- Збережіть файл.
- Перезапустіть Cursor, щоб він підхопив новий сервер.
- Відкрийте чат AI і запитайте, наприклад: «Виведи мої продукти в Qamera AI».
Якщо інструменти не з'явилися, загляньте до Усунення несправностей — найчастіша причина — ключ, а не конфігурація.
Claude Desktop
Claude Desktop з'єднується з віддаленим сервером як конектор, який додають у налаштуваннях, а не у файлі конфігурації.
- Відкрийте Налаштування —
Ctrl+,у Windows,Cmd+,у macOS — потім Конектори. - Оберіть Додати, далі Додати власний конектор.
- Введіть адресу сервера:
https://mcp.qamera.ai - Розгорніть Заголовки запиту й додайте:
- назва заголовка
x-api-key - значення: ваш ключ, точно так, як ви його скопіювали
- назва заголовка
- Натисніть Додати, а потім увімкніть конектор у розмові кнопкою +.
Одне застереження, яке може вас стосуватися. Автентифікація заголовком у власних конекторах — це функція у стадії бета, яку розгортають поступово. Якщо у вікні немає розділу Заголовки запиту, ваш обліковий запис її ще не має — без неї 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 незашифрованим і буде виведена з ужитку, щойно інтеграції переїдуть.
Що далі
- Довідник інструментів — усе, що вміє ваш асистент.
- Приклади — три приклади сесій.
- Усунення несправностей — коли щось не з'єднується.