Qudata MCP

MCP сервер Qudata.ai для AI-агентов: поиск GPU-офферов, работа с шаблонами и безопасная аренда GPU-инстансов через Model Context Protocol

Что такое Qudata MCP?

Qudata MCP — это сервер Model Context Protocol, который дает AI-агентам типизированный доступ к Qudata.ai: GPU marketplace, каталогу GPU, шаблонам запуска и управлению инстансами. Через MCP агент может искать подходящие GPU-офферы, проверять цены и доступность, готовить шаблоны и выполнять действия в аккаунте пользователя по API-ключу.

MCP сервер работает поверх Streamable HTTP и доступен по адресу:

https://api.qudata.ai/mcp

Страница полезна, если вы хотите подключить Qudata к Cursor, Claude Desktop или другому MCP-клиенту и управлять GPU-инфраструктурой с помощью AI-агента.

Подключение

Для Cursor, Claude Desktop и других MCP-клиентов можно использовать mcp-remote. Добавьте сервер qudata в конфигурацию MCP-клиента:

{
  "mcpServers": {
    "qudata": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.qudata.ai/mcp",
        "--header",
        "Authorization: Bearer YOUR_QUDATA_API_KEY"
      ]
    }
  }
}

API-ключ можно получить на странице API ключей. Для MCP-клиентов рекомендуется заголовок Authorization: Bearer <key>. Также поддерживается общий backend-заголовок X-API-Key.

Внимание

Не передавайте API-ключ в публичные репозитории, промпты или логи. MCP tools выполняются от имени владельца ключа.

Discovery для AI-агентов

Qudata публикует machine-readable endpoints, которые помогают AI-системам и поисковым агентам понять возможности сервиса:

/.well-known/mcp.json — транспорт MCP, авторизация и scopes.
/.well-known/ai-plugin.json — legacy manifest для совместимости.
/llms.txt — краткое описание Qudata MCP для LLM.
/llms-full.txt — расширенное описание tools, параметров и ограничений.

Эти файлы помогают LLM и агентным платформам корректно индексировать Qudata MCP, находить доступные инструменты и учитывать safety rules перед действиями с аккаунтом.

Возможности MCP tools

Marketplace

search_market_offers ищет GPU-офферы в marketplace Qudata. Поддерживаются фильтры по GPU, провайдеру, региону, доступности, цене, валюте и локали. Tool подходит для запросов вроде: «найди самые дешевые RTX 4090 для аренды» или «подбери GPU для обучения модели в Европе».

get_offer возвращает расширенную карточку оффера по offer_id: GPU, цены, rentable, in_stock, тип запуска и другую информацию, нужную перед арендой.

GPU каталог

list_gpus возвращает список GPU-моделей с фильтрацией по провайдеру, наличию в marketplace и поисковой строке.

get_gpu находит GPU по ObjectId, translit_name или похожему названию.

gpu_profitability рассчитывает доходность GPU за период. Если hourly_price не передан, используется рыночная цена Qudata.

Templates

list_templates показывает публичные и пользовательские шаблоны запуска: instance, vm и agent.

get_template возвращает шаблон, видимый владельцу API-ключа.

create_template создает Docker template типа instance. Можно задать image, tag, переменные окружения, команду запуска, порты, SSH, Web UI, минимальный диск, список GPU и приватность шаблона.

update_template обновляет пользовательский Docker template.

update_vm_template обновляет пользовательский VM template без изменения VM image.

clone_vm_template копирует видимый VM template в пользовательский template.

delete_template удаляет пользовательский template и требует confirm=true.

Instances

list_instances возвращает инстансы владельца API-ключа.

rent_instance создает платный GPU-инстанс по офферу и шаблону. По умолчанию tool возвращает preview и не создает ресурс без явного confirm=true.

Перед созданием инстанса Qudata проверяет:

оффер существует;
шаблон видим владельцу API-ключа;
оффер доступен для аренды: rentable == true;
сервер есть в наличии: in_stock == true;
тип запуска оффера совместим с типом шаблона.

Правила совместимости:

RunType.vm требует TemplateType.vm;
RunType.instance требует TemplateType.instance.

manage_instance управляет инстансом пользователя: start, pause, reboot.

destroy_instance удаляет инстанс владельца API-ключа и требует confirm=true.

attach_ssh_key и detach_ssh_key привязывают или отвязывают SSH-ключ от инстанса.

Безопасность и подтверждения

Read-only tools для поиска GPU и marketplace можно использовать для анализа и подбора конфигураций. Tools, которые меняют состояние аккаунта или создают платные ресурсы, требуют API-ключ и дополнительные подтверждения.

Особенно важно:

rent_instance может списать баланс и создать внешний ресурс у провайдера;
повторный подтвержденный вызов rent_instance может создать новый инстанс;
destroy_instance завершает ресурс и запускает финализацию удаления;
delete_template удаляет пользовательский template.

Для destructive и paid tools используйте двухшаговый сценарий: сначала попросите агента получить preview без confirm, проверьте параметры и только затем подтвердите действие с confirm=true.

Примеры запросов агенту

Покажи 5 самых дешевых офферов RTX 4090, доступных для аренды.

Создай приватный template для docker image ghcr.io/company/worker:latest с SSH и UI на порту 7860.

Проверь оффер и template для аренды, но не создавай инстанс без подтверждения.

Покажи мои активные инстансы и перезагрузи выбранный instance_id.

Как формулировать запросы

Для лучших результатов указывайте модель GPU, бюджет, регион, срок аренды, валюту и требования к шаблону. Например: «найди доступный NVIDIA H100 в Европе, отсортируй по цене, проверь совместимость с VM template и покажи preview аренды без подтверждения».

On this page