Документация MCP-сервера: настройка и JSON-RPC API

Подключите Claude, Cursor или LM Studio к MCP-серверу Arttron: реальная JSON-конфигурация, пример JSON-RPC tools/call и справочник REST API.

Начало работы

1. Аутентификация

Зарегистрируйтесь по почте или GitHub → Получите API ключ → Вставьте в конфиг MCP клиента

Передавайте ключ как Bearer-токен: Authorization: Bearer YOUR_API_KEY.

2. Получите API ключ

Войдите в dashboard → Создайте новый API ключ → Скопируйте ключ (показывается только один раз)

Коннектор claude.ai (без API-ключа)

Откройте Settings → Connectors → Add custom connector, вставьте URL коннектора и подтвердите вход через OAuth. claude.ai регистрируется сам, поэтому API-ключ не нужен.

MCP (JSON-RPC)

MCP endpoint говорит на JSON-RPC 2.0 поверх Streamable HTTP. Укажите в клиенте https://arttron.dev/api/mcp и авторизуйтесь Bearer-ключом — двенадцать инструментов определяются автоматически.

URL коннектора

https://arttron.dev/api/mcp

Примечание: /api/mcp/stream — легаси SSE-маршрут, оставленный только для REST API. Это не MCP endpoint, поэтому он не работает в MCP-клиентах и коннекторах — всегда используйте https://arttron.dev/api/mcp.

Отправьте JSON-RPC 2.0 на MCP endpoint с заголовком Authorization; результат инструмента приходит в блоках result.content.

Конфигурация MCP-клиента

{
  "mcpServers": {
    "arttron": {
      "url": "https://arttron.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

JSON-RPC запрос (tools/call)

POST /api/mcp
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Accept: application/json, text/event-stream

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "dns_lookup",
    "arguments": { "domain": "example.com", "type": "MX" }
  }
}

REST API

Простые REST endpoints ниже — отдельный API для скриптов, это не MCP-транспорты. Список инструментов доступен без авторизации, вызов инструмента — с Bearer-ключом.

REST запрос

POST /api/mcp/tools/call
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "tool": "dns_lookup",
  "input": { "domain": "example.com", "type": "MX" }
}

Доступные инструменты

Все двенадцать инструментов обслуживает MCP endpoint https://arttron.dev/api/mcp. Используйте заголовок Authorization с вашим API-ключом.

  • dns_lookup — Resolve DNS records
  • ip_lookup — Geolocate IP addresses
  • qr_generate — Generate QR codes
  • list_versions — List available versions
  • download_dev_server — Download server binary
  • proxy_image — Proxy external images

Лимиты

Бесплатный тариф: 200 вызовов инструментов в месяц на MCP-ключ и 100 на API-ключ — эта месячная квота и есть основной лимит.

Поверх месячной квоты у каждого инструмента есть небольшой лимит (например, 20 DNS-запросов/сек, 30 геолокаций IP/мин, 15 прокси изображений/сек); всё считается на API-ключ.

Нужна помощь?

Напишите нам на support@arttron.dev

Назад к MCP

Что охватывает документация MCP

Документация ведёт от нуля до первого вызова инструмента. Шаг первый — авторизация: создайте бесплатную учётную запись и сгенерируйте API-ключ или, для claude.ai, зарегистрируйте URL коннектора и подтвердите запрос OAuth, и тогда ключ не нужен. Шаг второй — конфигурация клиента: блок mcpServers ниже направляет ваш клиент на endpoint Streamable HTTP.

Остальная часть страницы — это формат обмена. MCP-endpoint говорит на JSON-RPC 2.0; запрос tools/call называет инструмент и передаёт его аргументы, а результат приходит в блоках content. Пример: запрос tools/call для dns_lookup с {"domain":"example.com","type":"MX"} возвращает MX-записи для example.com. Отдельный, удобный для скриптов REST-интерфейс описан для тех, кто не говорит на JSON-RPC.

Как подключить клиент

  1. Войдите и создайте API-ключ или добавьте URL коннектора в claude.ai и подтвердите OAuth.
  2. Вставьте блок mcpServers с endpoint https://arttron.dev/api/mcp и вашим Bearer-ключом.
  3. Перезапустите клиент; все двенадцать инструментов обнаруживаются во время рукопожатия MCP.
  4. Вызовите инструмент, например dns_lookup, и прочитайте результат в блоках content.

Частые вопросы о документации

Какой endpoint использовать?

Для MCP-клиентов всегда https://arttron.dev/api/mcp. Путь /api/mcp/stream — это устаревший SSE-маршрут, оставленный только для REST API, и он не является MCP-endpoint.

Нужен ли API-ключ в claude.ai?

Нет. Добавление URL коннектора в разделе «Настройки → Коннекторы → Добавить пользовательский коннектор» регистрирует клиент через OAuth 2.1, поэтому там API-ключ не требуется.

Можно ли вызывать инструменты из скрипта?

Да. REST-интерфейс — tools/list публичен, а tools/call требует Bearer-ключ — описан на той же странице для тех, кто не говорит на JSON-RPC.