MCP: Claude Desktop, ChatGPT, Cursor

ImportOS Data має віддалений сервер Model Context Protocol для AI-агентів. Він розраховує вартість авто з аукціонів США «під ключ» в Україні, Польщі, Литві, Німеччині та Грузії, оцінює ринкову ціну, декодує VIN, шукає оголошення й віддає митні правила.

• Адреса: https://api.importos.app/mcp (streamable HTTP, без сесій: одне повідомлення JSON-RPC на кожен POST). Чекає на власника Домен-заглушка до підтвердження власником.
• Автентифікація: Authorization: Bearer rv_live_..., тобто той самий API-ключ, що й для REST. OAuth поки не реалізовано (див. нижче).
• Результати інструментів збігаються з відповідями REST.

ІнструментиCopy Anchor Link

Інструменти, на які в ключа немає права, у списку не показуються. Всі п'ять лише читають (readOnlyHint: true).

Заплановані, але недоступні: create_lead (для агентів-продавців) і get_deal_status (для клієнтських асистентів). Їм потрібні сервіс угод і scope write:deals У розробці.

Опис кожного інструмента написаний для моделі: коли викликати, приклад входу й обмеження. Головні обмеження, які інструменти повторюють моделі:

• Параметри з verified: false лише орієнтовні; у відповіді є warnings (наприклад rule_unverified, tariffs_typical) і confidence нижче 1. Передавайте їх користувачеві.
• Ринкова ціна побудована на цінах оголошень, а не угод. sample_size: 0 означає «немає даних» (null, а не нуль).
• Результати пошуку: ціни на момент отримання. Збійні чи заблоковані джерела потрапляють у errors, а виклик не падає.

Вхідні поля calculate_landed_costCopy Anchor Link

Увага: назви полів тут не збігаються з REST (POST /v1/landed-cost).

ПідключенняCopy Anchor Link

Спершу створіть API-ключ у Desk з правами mcp, read:pricing, read:listings (швидкий старт).

Claude DesktopCopy Anchor Link

Claude Desktop підключає віддалені сервери зі статичним ключем через mcp-remote. Відкрийте Settings → Developer → Edit Config (Windows: %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "importos": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.importos.app/mcp",
        "--header",
        "Authorization:${IMPORTOS_AUTH}"
      ],
      "env": { "IMPORTOS_AUTH": "Bearer rv_live_YOUR_KEY" }
    }
  }
}

Форма Authorization:${...} без пробілу після двокрапки й зі значенням у env обходить відому помилку лапок на Windows. Повністю закрийте й знову запустіть Claude Desktop, потім запитайте, наприклад: «Скільки коштуватиме в Україні Toyota Camry 2018 2.5 з Copart NJ, ставка $8000?»

CursorCopy Anchor Link

Файл ~/.cursor/mcp.json (або .cursor/mcp.json у проєкті):

{
  "mcpServers": {
    "importos": {
      "url": "https://api.importos.app/mcp",
      "headers": { "Authorization": "Bearer rv_live_YOUR_KEY" }
    }
  }
}

Claude CodeCopy Anchor Link

claude mcp add --transport http importos https://api.importos.app/mcp --header "Authorization: Bearer rv_live_YOUR_KEY"

ChatGPTCopy Anchor Link

• Якщо у вашому діалозі є поле bearer/API-ключ, вкажіть https://api.importos.app/mcp і свій ключ rv_live_....
• Якщо ні, ChatGPT не зможе підключитися, доки ми не додамо OAuth 2.1 з динамічною реєстрацією клієнта Чекає на власника. Це в планах, але не зроблено, і ми не будемо стверджувати інакше.

Будь-який інший клієнтCopy Anchor Link

Використовуйте транспорт Streamable HTTP, URL і заголовок Authorization. Швидка перевірка через curl:

curl -s https://api.importos.app/mcp \
  -H "Authorization: Bearer rv_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

або офіційний TypeScript-клієнт:

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const client = new Client({ name: 'my-agent', version: '1.0.0' });
await client.connect(
  new StreamableHTTPClientTransport(new URL('https://api.importos.app/mcp'), {
    requestInit: { headers: { Authorization: `Bearer ${process.env.IMPORTOS_API_KEY}` } },
  }),
);
const result = await client.callTool({
  name: 'calculate_landed_cost',
  arguments: {
    lot_price_usd: 8000,
    auction: 'copart',
    vehicle: { year: 2018, fuel: 'petrol', engine_cc: 2487 },
    us_state: 'NJ',
    destination_country: 'UA',
    our_fee_usd: 700,
  },
});
console.log(result.structuredContent);

Результат — JSON (structuredContent, дубльований у текстовому вмісті): items[], total, total_range, warnings[], assumptions[], rulesVersion, fx[], confidence.

ОбмеженняCopy Anchor Link

• Без сесій: немає серверного потоку; GET /mcp і DELETE /mcp повертають 405. Усі клієнти зі Streamable HTTP працюють.
• Без OAuth: доступ за статичним ключем. OAuth 2.1 (потрібен конекторам ChatGPT) Чекає на власника.
• Оцінки, а не пропозиції: неперевірені ставки позначаються, а не ховаються.
• Реєстр MCP: маніфест mcp/server.json (формат MCP Registry) готовий, але публікація потребує підтвердження домену Чекає на власника.
• Windows і Norton: фільтр мережі може псувати loopback-відповіді на /mcp, див. швидкий старт.