# q-ring

q-ring — MCP-сервер для Claude Code, который хранит секреты в системном хранилище ключей и отдаёт их агенту через MCP. Секреты можно разделять по окружениям.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 у репозитория
- Автор: I4cTime
- Лицензия: AGPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/I4cTime/q-ring
- Обновлён: 2026-11-14
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/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 и временного использования, но не для постоянного локального хранения.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `QRING_BACKEND`, `QRING_FILE_PASSPHRASE`, `QRING_FILE_BACKEND_PATH`, `QRING_CONFIG_DIR` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

## Когда брать
- хранить ключи API вне открытых `.env`-файлов
- разделять значения секретов между dev, staging и prod
- синхронизировать один ключ между проектами
- передавать секреты агенту через MCP
- создавать временные секреты с ограничением по времени или числу чтений

## Примеры запросов агенту
- Сохрани ключ `OPENAI_API_KEY` и отдай его агенту через MCP.
- Покажи различия секретов между окружениями staging и prod.
- Скопируй значение `DATABASE_URL` из staging в prod через q-ring.

## Похожие
- [oura-ring-mcp](https://affpapa.org/nevibecode/mcp/oura-ring-mcp.md) — MCP-сервер · ★ 37 у репозитория
- [tree-ring-memory](https://affpapa.org/nevibecode/hooks/tree-ring-memory.md) — хук · ★ 1596 у репозитория
- [Context7](https://affpapa.org/nevibecode/mcp/context7.md) — MCP-сервер · 5563 установки
- [Search Google Flights](https://affpapa.org/nevibecode/mcp/search-google-flights.md) — MCP-сервер · 2595 установок
- [Math-MCP](https://affpapa.org/nevibecode/mcp/math-mcp.md) — MCP-сервер · 5958 установок
- [pipeworx gateway](https://affpapa.org/nevibecode/mcp/pipeworx-gateway.md) — MCP-сервер · 419019 установок
- [SparkForge](https://affpapa.org/nevibecode/mcp/sparkforge.md) — MCP-сервер · 219896 установок
- [OpenWebSearch](https://affpapa.org/nevibecode/mcp/openwebsearch.md) — MCP-сервер · 494 установки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
