integration_instructions Інструкція

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

5 простих кроків з скріншотами. Працює на Windows та macOS.

checklist

Перед початком

Переконайтесь що у вас встановлено:

1
Claude Desktop
Завантажте та встановіть з claude.ai/download. Натисніть Download, запустіть інсталятор, дочекайтесь завершення.
2
Node.js
MCP потребує Node.js для роботи. Без нього нічого не запуститься.

download Як встановити Node.js

  1. Перейдіть на nodejs.org
  2. Натисніть велику зелену кнопку "Download Node.js (LTS)"
  3. Запустіть завантажений файл (.msi на Windows, .pkg на macOS)
  4. Натискайте Next → Next → Install (всі налаштування за замовчуванням)
  5. Перевірте: відкрийте термінал і введіть node --version — має показати номер версії
3
API ключ AUTOMOTO
Зареєструйтесь на automoto.ai. Після підтвердження заявки ви отримаєте ключ на email. Перші 7 днів — безкоштовно.
bolt
Швидкий спосіб: Wizard
Якщо у вас вже є API ключ — скористайтесь Wizard. Він згенерує готовий файл конфігурації за 30 секунд. Завантажте його і переходьте до кроку 3.
1

Відкрийте Settings

Відкрийте Claude Desktop. Натисніть на клавіатурі Ctrl + , (кома) — або натисніть іконку меню зліва внизу і оберіть Settings.

Claude Desktop — Settings
Натисніть Ctrl + , або меню зліва внизу → Settings
2

Developer → Edit Config

У вікні Settings знайдіть зліва розділ Developer (внизу списку, під "Desktop app"). Натисніть на нього. Потім натисніть кнопку Edit Config.

Developer → Edit Config
Зліва оберіть Developer → натисніть Edit Config
folder
Де знаходиться файл?
Після натискання Edit Config відкриється папка з файлом. Якщо ні — знайдіть вручну:
Windows: натисніть Win + R, введіть %APPDATA%\Claude, натисніть Enter
macOS: Finder → Go → Go to Folder → ~/Library/Application Support/Claude/
3

Замініть файл конфігурації

Знайдіть файл claude_desktop_config.json у відкритій папці. Є два способи:

auto_awesome Спосіб А: Файл з Wizard (найпростіше)

  1. Відкрийте Wizard і згенеруйте конфігурацію
  2. Натисніть "Завантажити файл" — він збереже claude_desktop_config.json
  3. Скопіюйте завантажений файл в цю папку з заміною старого файлу

edit Спосіб Б: Редагування вручну

  1. Відкрийте файл claude_desktop_config.json у будь-якому текстовому редакторі (Notepad, VS Code)
  2. Замініть весь вміст на JSON нижче (замініть YOUR_API_KEY на ваш ключ):
claude_desktop_config.json
{ "mcpServers": { "automoto-data": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.automoto.ai/mcp", "--header", "X-API-Key:YOUR_API_KEY" ] } } }
claude_desktop_config.json
Файл claude_desktop_config.json у папці Claude
warning
Вже є інші MCP сервери?
Якщо у файлі вже є конфігурація інших серверів — додайте "automoto-data": {...} всередину існуючого "mcpServers", а не замінюйте весь файл.
4

Перевірте вміст файлу

Відкрийте файл і переконайтесь, що він виглядає приблизно так (ваш API ключ буде інший):

Config file contents
Файл має містити блок "mcpServers" з "automoto-data" та вашим API ключем
check_circle
Що перевірити
  • Є блок "mcpServers" з "automoto-data" всередині
  • URL вказує на https://mcp.automoto.ai/mcp
  • Ваш API ключ вставлений правильно (без зайвих пробілів)
  • JSON валідний — немає зайвих ком або відсутніх лапок
5

Перезапустіть Claude Desktop

Повністю закрийте Claude Desktop. На Windows — перевірте що його немає в системному треї (біля годинника). Запустіть Claude знову. Зайдіть в Settings → Developer — має з'явитись automoto-data зі статусом running.

automoto-data running
automoto-data зі статусом running — все працює!

celebration Готово!

Тепер відкрийте новий чат і спробуйте написати запит, наприклад:

"Покажи топ-10 найпопулярніших авто в Україні"
"Яка середня ціна на BMW X5?"
"Скільки електромобілів зареєстровано в 2025?"

Claude автоматично використає AUTOMOTO MCP для отримання даних.

terminal

Claude Code (CLI)

Якщо ви використовуєте Claude Code в терміналі — достатньо однієї команди:

Terminal
claude mcp add automoto-data \ --transport sse \ https://mcp.automoto.ai/mcp \ --header "X-API-Key: YOUR_API_KEY"

Перевірте: claude mcp list

edit_note

Cursor / VS Code

Створіть файл .cursor/mcp.json (Cursor) або .vscode/mcp.json (VS Code) в корені вашого проєкту:

.cursor/mcp.json
{ "mcpServers": { "automoto-data": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.automoto.ai/mcp", "--header", "X-API-Key:YOUR_API_KEY" ] } } }
build

Щось не працює?

error automoto-data не з'являється після перезапуску

  1. Повністю закрийте Claude (перевірте трей біля годинника на Windows)
  2. Перевірте що Node.js встановлений: відкрийте CMD і введіть node --version
  3. Перевірте JSON — навіть одна зайва кома зламає конфігурацію. Скористайтесь jsonlint.com для перевірки
  4. Подивіться логи: %APPDATA%\Claude\logs\ (Windows) або ~/Library/Logs/Claude/ (macOS)

error Помилка ENOENT на Windows

Додайте повний шлях до AppData в конфігурацію:

"env": { "APPDATA": "C:\\Users\\your_user\\AppData\\Roaming" }

Також переконайтесь що npm встановлений глобально: npm install -g npm

error Помилка авторизації (401 / 403)

  1. API ключ активований? Потрібно прив'язати карту в dashboard
  2. Ключ скопійований без зайвих пробілів?
  3. Ключ починається з dmcp_live_ або dmcp_test_?