integration_instructions Setup Guide

MCP Setup

5 simple steps with screenshots. Works on Windows and macOS.

bolt

Easiest: Claude.ai (web) — no installs

No Node.js and no config files. Connects right in the browser via OAuth. Limits are shared with your API key.

1

Create a key in the dashboard

Open the dashboard → Create key. Copy the MCP URL, OAuth Client ID and Client Secret (or click "Download JSON") — shown only once.

2

Open Connectors in Claude

In Claude click Customize (or Settings) in the left panel → Connectors.

Claude — Customize
On the left choose Customize → Connectors
3

Add custom connector

Click + next to Connectors → Add custom connector.

Add custom connector
+ → Add custom connector
4

The connector form appears

Fields: Name, Remote MCP server URL and Advanced settings with OAuth Client ID / Secret.

Custom connector form
The "Add custom connector" form with Advanced settings
5

Paste URL and credentials → Add

Name: AUTOMOTO-MCP · URL: https://mcp.automoto.ai/mcp. In Advanced settings paste the Client ID and Secret from step 1 → Add.

Filled connector form
Filled URL + Client ID/Secret → Add
6

Click Connect

The AUTOMOTO-MCP connector appears in the list. Click Connect.

Connect AUTOMOTO-MCP
Click Connect for AUTOMOTO-MCP
7

Approve access

Approve access in the authorization window. You will see Connected to AUTOMOTO-MCP and the list of available tools.

Connected — tool permissions
Connected — tool permissions
8

Enable it in the chat

In the chat click + → Connectors and toggle on AUTOMOTO-MCP. Done — try asking, e.g.: "Show the top-5 cars in Ukraine".

Enable connector in chat
+ → Connectors → enable AUTOMOTO-MCP
info
Need Desktop / terminal?
Switch to the "Desktop / IDE" tab above.
checklist

Before You Start

Make sure you have installed:

1
Claude Desktop
Download and install from claude.ai/download. Click Download, run the installer, wait for completion.
2
Node.js
MCP requires Node.js to work. Nothing will run without it.

download How to Install Node.js

  1. Go to nodejs.org
  2. Click the big green button "Download Node.js (LTS)"
  3. Run the downloaded file (.msi on Windows, .pkg on macOS)
  4. Click Next → Next → Install (all default settings)
  5. Verify: open a terminal and type node --version — should show a version number
3
AUTOMOTO API Key
Register on automoto.ai. After your application is approved, you'll receive the key by email. First 7 days are free.
bolt
Quick Way: Wizard
If you already have an API key — use the Wizard. It generates a ready config file in 30 seconds. Download it and skip to step 3.
1

Open Settings

Open Claude Desktop. Press Ctrl + , (comma) — or click the menu icon at the bottom-left and choose Settings.

Claude Desktop — Settings
Press Ctrl + , or bottom-left menu → Settings
2

Developer → Edit Config

In the Settings window, find Developer on the left sidebar (at the bottom, under "Desktop app"). Click it. Then click the Edit Config button.

Developer → Edit Config
Select Developer on the left → click Edit Config
folder
Where is the config file?
After clicking Edit Config, the folder with the file will open. If not — find it manually:
Windows: press Win + R, type %APPDATA%\Claude, press Enter
macOS: Finder → Go → Go to Folder → ~/Library/Application Support/Claude/
3

Replace the Config File

Find the file claude_desktop_config.json in the opened folder. There are two ways:

auto_awesome Method A: File from Wizard (easiest)

  1. Open the Wizard and generate a config
  2. Click "Download file" — it will save claude_desktop_config.json
  3. Copy the downloaded file to this folder, replacing the old one

edit Method B: Edit Manually

  1. Open claude_desktop_config.json in any text editor (Notepad, VS Code)
  2. Replace all contents with the JSON below (replace YOUR_API_KEY with your 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
The file claude_desktop_config.json in the Claude folder
warning
Already have other MCP servers?
If the file already has other server configs — add "automoto-data": {...} inside the existing "mcpServers" object, don't replace the entire file.
4

Verify the File Contents

Open the file and make sure it looks approximately like this (your API key will be different):

Config file contents
The file should contain a "mcpServers" block with "automoto-data" and your API key
check_circle
What to check
  • There is a "mcpServers" block with "automoto-data" inside
  • URL points to https://mcp.automoto.ai/mcp
  • Your API key is pasted correctly (no extra spaces)
  • JSON is valid — no extra commas or missing quotes
5

Restart Claude Desktop

Completely close Claude Desktop. On Windows — check the system tray (near the clock). Launch Claude again. Go to Settings → Developer — you should see automoto-data with status running.

automoto-data running
automoto-data with status running — it works!

celebration Done!

Now open a new chat and try a query, for example:

"Show top-10 most popular cars in Ukraine"
"What is the average price of BMW X5?"
"How many EVs were registered in 2025?"

Claude will automatically use AUTOMOTO MCP to fetch the data.

terminal

Claude Code (CLI)

If you use Claude Code in the terminal — one command is enough:

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

Verify: claude mcp list

edit_note

Cursor / VS Code

Create a file .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code) in your project root:

.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

Something Not Working?

error automoto-data doesn't appear after restart

  1. Completely close Claude (check the system tray near the clock on Windows)
  2. Verify Node.js is installed: open CMD and type node --version
  3. Check your JSON — even one extra comma will break the config. Use jsonlint.com to validate
  4. Check logs: %APPDATA%\Claude\logs\ (Windows) or ~/Library/Logs/Claude/ (macOS)

error ENOENT Error on Windows

Add the full AppData path to the config:

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

Also make sure npm is installed globally: npm install -g npm

error Authorization Error (401 / 403)

  1. Is the API key activated? You need to bind a card in the dashboard
  2. Key copied without extra spaces?
  3. Key starts with dmcp_live_ or dmcp_test_?