q-ring — MCP-сервер для Claude Code: установка
q-ring — MCP-сервер для Claude Code, который хранит секреты в системном хранилище ключей и отдаёт их агенту через MCP. Секреты можно разделять по окружениям.
AGPL-3.0 ★ 6 обновлён 2026-11-14
claude mcp add --env QRING_BACKEND=<QRING_BACKEND> --env QRING_FILE_PASSPHRASE=<QRING_FILE_PASSPHRASE> --env QRING_FILE_BACKEND_PATH=<QRING_FILE_BACKEND_PATH> --env QRING_CONFIG_DIR=<QRING_CONFIG_DIR> --transport stdio q-ring -- npx -y @i4ctime/q-ringЧто делает q-ring
q-ring хранит ключи API и другие секреты в системном хранилище macOS, Linux или Windows, а агент получает их через MCP. Сервер предоставляет 46 MCP-инструментов и умеет связывать значения между проектами, задавать окружения и создавать временные секреты.
Для выбора окружения используются флаг --env, переменные QRING_ENV и NODE_ENV, ветка Git или .q-ring.json. Установка через Claude Code запускает пакет @i4ctime/q-ring с помощью npx. В контейнере Docker системное хранилище ключей недоступно, поэтому такой режим подходит для MCP и временного использования, но не для постоянного локального хранения.
Какие задачи решает
- хранить ключи API вне открытых
.env-файлов - разделять значения секретов между dev, staging и prod
- синхронизировать один ключ между проектами
- передавать секреты агенту через MCP
- создавать временные секреты с ограничением по времени или числу чтений
Примеры запросов агенту
- Сохрани ключ
OPENAI_API_KEYи отдай его агенту через MCP. - Покажи различия секретов между окружениями staging и prod.
- Скопируй значение
DATABASE_URLиз staging в prod через q-ring.
Как установить q-ring
Командой платформы
claude mcp add --env QRING_BACKEND=<QRING_BACKEND> --env QRING_FILE_PASSPHRASE=<QRING_FILE_PASSPHRASE> --env QRING_FILE_BACKEND_PATH=<QRING_FILE_BACKEND_PATH> --env QRING_CONFIG_DIR=<QRING_CONFIG_DIR> --transport stdio q-ring -- npx -y @i4ctime/q-ringВместо <…> подставьте свои значения
Командой платформы
codex mcp add q-ring --env QRING_BACKEND=<QRING_BACKEND> --env QRING_FILE_PASSPHRASE=<QRING_FILE_PASSPHRASE> --env QRING_FILE_BACKEND_PATH=<QRING_FILE_BACKEND_PATH> --env QRING_CONFIG_DIR=<QRING_CONFIG_DIR> -- npx -y @i4ctime/q-ringВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"q-ring": {
"command": "npx",
"args": [
"-y",
"@i4ctime/q-ring"
],
"env": {
"QRING_BACKEND": "<QRING_BACKEND>",
"QRING_FILE_PASSPHRASE": "<QRING_FILE_PASSPHRASE>",
"QRING_FILE_BACKEND_PATH": "<QRING_FILE_BACKEND_PATH>",
"QRING_CONFIG_DIR": "<QRING_CONFIG_DIR>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"q-ring": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@i4ctime/q-ring"
],
"env": {
"QRING_BACKEND": "<QRING_BACKEND>",
"QRING_FILE_PASSPHRASE": "<QRING_FILE_PASSPHRASE>",
"QRING_FILE_BACKEND_PATH": "<QRING_FILE_BACKEND_PATH>",
"QRING_CONFIG_DIR": "<QRING_CONFIG_DIR>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e QRING_BACKEND=<QRING_BACKEND> -e QRING_FILE_PASSPHRASE=<QRING_FILE_PASSPHRASE> -e QRING_FILE_BACKEND_PATH=<QRING_FILE_BACKEND_PATH> -e QRING_CONFIG_DIR=<QRING_CONFIG_DIR> q-ring npx -y @i4ctime/q-ringВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о q-ring
Как установить q-ring в Claude Code?
Выполни команду claude mcp add q-ring -e QRING_FILE_PASSPHRASE=<QRING_FILE_PASSPHRASE> -- npx -y @i4ctime/q-ring.
Что делает q-ring?
q-ring хранит секреты в системном хранилище ключей и предоставляет агенту MCP-инструменты для чтения, генерации, разделения по окружениям и передачи секретов.
Что нужно для работы q-ring?
Для запуска через команду установки нужен npx. Локальное постоянное хранение использует системное хранилище ключей macOS, Linux или Windows; в Docker оно недоступно.