Документация 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
Документация ведёт от нуля до первого вызова инструмента. Шаг первый — авторизация: создайте бесплатную учётную запись и сгенерируйте 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.
Как подключить клиент
- Войдите и создайте API-ключ или добавьте URL коннектора в claude.ai и подтвердите OAuth.
- Вставьте блок mcpServers с endpoint https://arttron.dev/api/mcp и вашим Bearer-ключом.
- Перезапустите клиент; все двенадцать инструментов обнаруживаются во время рукопожатия MCP.
- Вызовите инструмент, например 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.
