# agent-magnet

MCP-сервер сохраняет контекст проекта между сессиями и делится им между AI-инструментами. Пригодится для решений, правил и рабочих предпочтений.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 14
- Автор: helinakdogan
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/helinakdogan/agentmagnet
- Обновлён: 2026-09-05
- HTML: https://affpapa.org/nevibecode/mcp/agent-magnet

## Что делает

agent-magnet добавляет поведенческую память для AI-инструментов. Он сохраняет решения, соглашения, предупреждения, неудачные попытки, цели, предпочтения и выполненные действия, а затем сортирует эти записи. Память общая для Claude, Cursor и Codex.

Локальный режим включается по умолчанию, а начальная установка выполняется через `pip install agent-magnet` и `agent-magnet init`. Команда сама настраивает Claude Code, Claude Desktop и Cursor. Для Codex и других MCP-клиентов доступна ручная конфигурация с `agent-magnet-mcp` и `MAGNET_USER_ID`.

Для командной памяти нужен платный ключ Agent Magnet; локальный режим работает без ключа. В установочных параметрах также встречаются `MAGNET_OPENAI_KEY`, `MAGNET_REDIS_URL`, `MAGNET_PROJECT_ID` и `MAGNET_LOCAL_MODE`.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `MAGNET_USER_ID`, `MAGNET_OPENAI_KEY`, `MAGNET_LOCAL_MODE`, `MAGNET_REDIS_URL`, `MAGNET_PROJECT_ID` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env MAGNET_USER_ID=<MAGNET_USER_ID> --env MAGNET_OPENAI_KEY=<MAGNET_OPENAI_KEY> --env MAGNET_LOCAL_MODE=<MAGNET_LOCAL_MODE> --env MAGNET_REDIS_URL=<MAGNET_REDIS_URL> --env MAGNET_PROJECT_ID=<MAGNET_PROJECT_ID> --transport stdio agent-magnet -- uvx agent-magnet
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-magnet <команда>

### Codex

**Командой платформы**
```bash
codex mcp add agent-magnet --env MAGNET_USER_ID=<MAGNET_USER_ID> --env MAGNET_OPENAI_KEY=<MAGNET_OPENAI_KEY> --env MAGNET_LOCAL_MODE=<MAGNET_LOCAL_MODE> --env MAGNET_REDIS_URL=<MAGNET_REDIS_URL> --env MAGNET_PROJECT_ID=<MAGNET_PROJECT_ID> -- uvx agent-magnet
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-magnet <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "agent-magnet": {
            "command": "uvx",
            "args": [
                "agent-magnet"
            ],
            "env": {
                "MAGNET_USER_ID": "<MAGNET_USER_ID>",
                "MAGNET_OPENAI_KEY": "<MAGNET_OPENAI_KEY>",
                "MAGNET_LOCAL_MODE": "<MAGNET_LOCAL_MODE>",
                "MAGNET_REDIS_URL": "<MAGNET_REDIS_URL>",
                "MAGNET_PROJECT_ID": "<MAGNET_PROJECT_ID>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-magnet <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "agent-magnet": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "agent-magnet"
            ],
            "env": {
                "MAGNET_USER_ID": "<MAGNET_USER_ID>",
                "MAGNET_OPENAI_KEY": "<MAGNET_OPENAI_KEY>",
                "MAGNET_LOCAL_MODE": "<MAGNET_LOCAL_MODE>",
                "MAGNET_REDIS_URL": "<MAGNET_REDIS_URL>",
                "MAGNET_PROJECT_ID": "<MAGNET_PROJECT_ID>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-magnet <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e MAGNET_USER_ID=<MAGNET_USER_ID> -e MAGNET_OPENAI_KEY=<MAGNET_OPENAI_KEY> -e MAGNET_LOCAL_MODE=<MAGNET_LOCAL_MODE> -e MAGNET_REDIS_URL=<MAGNET_REDIS_URL> -e MAGNET_PROJECT_ID=<MAGNET_PROJECT_ID> agent-magnet uvx agent-magnet
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-magnet <команда>

## Когда брать
- сохранять решения между сессиями
- передавать контекст проекта между Claude, Cursor и Codex
- фиксировать соглашения и предпочтения команды
- отмечать завершённые задачи и забывать устаревшее
- подключать память к MCP-клиенту вручную

## Примеры запросов агенту
- Запомни решение использовать `PostgreSQL` для этого проекта.
- Сохрани соглашение: все API-обработчики лежат в `src/api`.
- Удали из памяти устаревшее предупреждение о `legacy-auth`.

## Похожие
- [lead-magnet-generator](https://affpapa.org/nevibecode/skills/lead-magnet-generator.md) — скилл · 1200 установок
- [lead-magnet](https://affpapa.org/nevibecode/skills/lead-magnet.md) — скилл · 452 установки
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 392262
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33989
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89609
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81163
- [Front-End Checklist](https://affpapa.org/nevibecode/mcp/front-end-checklist.md) — MCP-сервер · ★ 74569
- [Scrapling MCP Server](https://affpapa.org/nevibecode/mcp/scrapling-mcp-server.md) — MCP-сервер · ★ 89899

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