Подключите своих ИИ-агентов

Быстрый старт

OwlMem даёт всем ИИ-агентам вашей команды одну общую базу знаний и память через MCP. Подключение агента занимает около минуты.

1. Создайте пространство. Войдите на owlmem.com/app по email. Первое пространство бесплатно.
2. Добавьте OwlMem в свой ИИ. Укажите этот адрес там, где приложение просит удалённый MCP-сервер или пользовательский коннектор:
   Копировать

   https://mcp.owlmem.com/mcp

3. Подтвердите доступ. Приложение откроет страницу OwlMem. Выберите имя для агента и нажмите Allow. Вот и всё — никаких ключей.

Затем объясните агентам, как им пользоваться, — см. Обучение агентов. Каждое подключённое приложение появляется в консоли в разделе AI agents & tokens → Connected apps, где его можно отключить в любой момент.

Claude (веб, десктоп и мобильные приложения)

1. Откройте Settings → Connectors и выберите Add custom connector.
2. Назовите его OwlMem и вставьте URL:
   Копировать

   https://mcp.owlmem.com/mcp

3. Нажмите Connect, войдите в OwlMem и нажмите Allow.

Коннекторы, добавленные в веб-версии, работают и в Claude Desktop, и в мобильных приложениях. На тарифах Claude Team и Enterprise администратору, возможно, сначала придётся добавить коннектор для всей организации.

Claude Code

Добавьте сервер (с --scope user он будет доступен во всех проектах):

claude mcp add --transport http --scope user owlmem https://mcp.owlmem.com/mcp

Затем запустите Claude Code, введите /mcp, выберите owlmem и нажмите Authenticate. В браузере откроется страница подтверждения OwlMem.

Codex

При добавлении сервера сразу начинается вход:

codex mcp add owlmem --url https://mcp.owlmem.com/mcp

Если шаг в браузере не успел завершиться, выполните codex mcp login owlmem. Или добавьте сервер в ~/.codex/config.toml вручную, а затем войдите:

[mcp_servers.owlmem]
url = "https://mcp.owlmem.com/mcp"

Codex спрашивает разрешения перед вызовом MCP-инструментов, если вы не разрешили их в его настройках подтверждений.

ChatGPT

1. Откройте Settings → Apps & Connectors. В разделе Advanced settings включите Developer mode.
2. Выберите Create, назовите коннектор OwlMem, вставьте URL и выберите OAuth в качестве способа аутентификации:
   Копировать

   https://mcp.owlmem.com/mcp

3. Войдите в OwlMem и нажмите Allow.

Доступность пользовательских коннекторов зависит от вашего тарифа ChatGPT и настроек рабочего пространства.

Cursor

Добавьте это в ~/.cursor/mcp.json (или в .cursor/mcp.json внутри проекта):

{
  "mcpServers": {
    "owlmem": { "url": "https://mcp.owlmem.com/mcp" }
  }
}

Откройте Cursor Settings → MCP. У OwlMem будет статус Needs login — нажмите на него и подтвердите доступ в браузере.

VS Code (GitHub Copilot)

Выполните MCP: Add Server из палитры команд, выберите HTTP и вставьте URL — или добавьте сервер в .vscode/mcp.json:

{
  "servers": {
    "owlmem": { "type": "http", "url": "https://mcp.owlmem.com/mcp" }
  }
}

VS Code попросит войти, когда Copilot впервые обратится к серверу.

Windsurf, Gemini CLI и другие

Windsurf — ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "owlmem": { "serverUrl": "https://mcp.owlmem.com/mcp" }
  }
}

Gemini CLI — ~/.gemini/settings.json, затем выполните /mcp auth owlmem:

{
  "mcpServers": {
    "owlmem": { "httpUrl": "https://mcp.owlmem.com/mcp" }
  }
}

Любой другой клиент, поддерживающий удалённые MCP-серверы с OAuth, подключается так же: укажите URL и подтвердите доступ. OwlMem поддерживает спецификацию авторизации MCP (OAuth 2.1 с PKCE и динамической регистрацией клиентов).

Токен вместо входа

Некоторые инструменты не умеют проходить вход — скрипты, задачи CI, старые клиенты. Для них создайте токен в консоли в разделе AI agents & tokens → Connect an AI и передавайте его как bearer-токен:

Authorization: Bearer om_…

Пример для Claude Code:

claude mcp add --transport http owlmem https://mcp.owlmem.com/mcp --header "Authorization: Bearer $OWLMEM_TOKEN"

Клиент, который умеет запускать только локальные (stdio) серверы, подключите через мост mcp-remote:

{
  "mcpServers": {
    "owlmem": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.owlmem.com/mcp", "--header", "Authorization: Bearer ${OWLMEM_TOKEN}"],
      "env": { "OWLMEM_TOKEN": "om_…" }
    }
  }
}

Срок действия токенов не истекает; отзовите токен в консоли, когда он больше не нужен. Агент — это вы плюс его имя, поэтому новый токен для уже используемого имени заменяет старый, и старый сразу перестаёт работать. То же самое происходит при повторном подключении приложения через вход.

Токен-приглашение для чужого ИИ

Чтобы агент партнёра мог работать с вашей организацией без аккаунта, основной аккаунт создаёт токен-приглашение (omi_…) в разделе AI agents & tokens. Партнёр добавляет OwlMem в своё приложение и вместо входа вставляет токен на странице входа OwlMem. Первый ИИ, который его использует, привязывается к нему; всем, кто попробует позже, будет отказано. В списке видно, привязан ли каждый токен, а отзыв токена отключает этот ИИ.

Инструменты агентов

База знаний — для страниц, которые люди и агенты перечитывают (инструкции, решения, заметки по проектам). Память — для отдельных фактов, которые агент может найти по смыслу.

Поиск и извлечение воспоминаний не ограничены ни в одном тарифе. Сохранение воспоминаний учитывается в месячном лимите записей в память по вашему тарифу, запись документов — в занятом месте на диске.

Обучение агентов

Агенты пользуются OwlMem гораздо лучше, если добавить несколько строк в их постоянные инструкции — CLAUDE.md, AGENTS.md, правила Cursor или инструкции проекта Claude:

## Team memory (OwlMem)
- Before starting a task, use kb_search (documents) and kb_recall (facts) for the topic.
- When you learn something reusable — a fix, a gotcha, a decision — save it with kb_write
  under lessons/ or projects/<name>/. Search first and update the existing page instead of
  creating a duplicate.
- Store facts that change (prices, versions, status) with kb_retain and snapshot=true or an
  expiry, so they retire on their own.
- Never put passwords or API keys in documents or memory. Use the OwlMem vault.

Новое пространство начинается с четырёх папок — lessons/, projects/, reference/, archive/, — в каждой есть короткий README. Агенты могут создавать и другие папки, до трёх уровней вложенности.

Хранилище и команда owlmem

Хранилище содержит учётные данные, нужные вашим агентам, со сквозным шифрованием: элементы шифруются на вашей машине ключом, который есть только у вас, а OwlMem хранит шифротекст, который не может прочитать. Основной аккаунт включает хранилище в консоли в разделе Vault (хранилище); после этого им может пользоваться вся организация. Сохраните показанный код восстановления — консоль предложит отправить его себе из вашего собственного почтового приложения, так что он никогда не проходит через OwlMem.

Разблокировка с Passkey. Каждый Passkey, добавленный в разделе Your approval methods, настраивается и для разблокировки хранилища — по отпечатку пальца или лицу на вашем устройстве (функция PRF у Passkey; её поддерживают Passkey в Chrome, Edge, Safari, Google Password Manager и iCloud Keychain). После этого импорт, экспорт и разблокировка на новой машине — одно касание, а код восстановления нужен только на крайний случай.

Агенты работают с хранилищем через команду owlmem (Node 18 или новее):

npm install -g owlmem
owlmem login            # paste a token for this agent
owlmem vault unlock     # press Enter to approve in your browser with a passkey (or paste the recovery code)
owlmem run --env DB_PASSWORD=prod/db:password -- ./deploy.sh

owlmem run передаёт секреты в окружение команды, так что агент их никогда не видит. Чтобы агент мог пользоваться хранилищем напрямую, добавьте локальный MCP-сервер — расшифровка остаётся на вашей машине:

claude mcp add owlmem-vault -- npx -y owlmem mcp

Когда вы нажимаете Enter в owlmem vault unlock, в браузере открывается страница с агентом, машиной и кодом. Убедитесь, что код совпадает с кодом в терминале, коснитесь Passkey — и ключ будет отправлен только на эту машину, зашифрованный специально для неё.

Для работы с хранилищем агентам нужно подтверждение (Passkey, приложение-аутентификатор или GitHub) на срок от 15 минут до 2 часов. Каждый подтверждает своих агентов, основной аккаунт может подтверждать чужих. Удаление и экспорт всегда требуют нового подтверждения. Импорт из Bitwarden, 1Password, KeePass и файлов .env, а также экспорт выполняются в консоли одним касанием Passkey или командой owlmem vault import / export.

Резервные копии. При каждом изменении или удалении элемента предыдущая версия хранится 30 дней. Основной аккаунт может восстановить её на странице хранилища; при восстановлении копия заменённой версии тоже сохраняется.

Тарифы и цены

Тарифы отличаются только числом подключаемых ИИ-агентов, местом на диске, записями в память в месяц и числом элементов в хранилище. В каждом тарифе есть все функции и любое число людей. Цены в долларах США; при оплате за год двенадцать месяцев стоят как десять.

• ИИ-агенты считаются как человек плюс имя агента: ваш Claude и Claude коллеги — это два агента. Поиск и чтение не ограничены.
• Сменить тариф или отменить подписку можно в любой момент в разделе Billing консоли. После отмены тариф действует до конца оплаченного периода.
• Возвраты. Полный возврат в течение 14 дней после первого платежа — напишите на [email protected]. После этого платежи не возвращаются. См. условия.

Организации, лимиты и ваши данные

• Организации. Ваше пространство — это организация с одним основным аккаунтом. Основной аккаунт приглашает людей по email в разделе Organization; они присоединяются как пользователи. Все пользуются общей базой знаний, воспоминаниями и хранилищем. Каждый пользователь управляет своими ИИ-агентами и токенами; основной аккаунт — агентами и токенами всех, а также участниками, оплатой, экспортом и удалением. Тарифы ограничивают число ИИ-агентов, а не людей.
• Отдельные аккаунты. Один и тот же email в двух организациях — это два отдельных аккаунта. После входа вы выбираете, в какую организацию войти; переключиться можно на боковой панели.
• Лимиты. Каждый тариф задаёт число ИИ-агентов, место на диске и месячные записи в память — см. цены. При достижении лимита записи отклоняются с понятным сообщением; чтение продолжает работать.
• Ваш GitHub. Синхронизируйте базу знаний с собственным репозиторием в разделе Knowledge → Sync to your GitHub. Синхронизируются только файлы Markdown.
• Экспорт и удаление. Основной аккаунт может скачать всё или удалить организацию в разделе Organization.
• Конфиденциальность. Ваши данные хранятся на серверах в Канаде. Мы не обучаем модели на ваших данных и не показываем рекламу. Подробнее — в политике конфиденциальности.

Решение проблем

“The space has reached its AI agent limit”

Каждый агент (человек плюс имя) занимает одно место. На странице подтверждения используйте одно из уже имеющихся имён агентов, отключите в консоли агента, которым больше не пользуетесь, или перейдите на старший тариф.

Приложение просит войти снова

Доступ обновляется автоматически. Если вы отключили приложение в консоли или оно не использовалось 60 дней, подключите его заново.

Не приходит письмо для входа

Проверьте папку «Спам» — письмо приходит от [email protected]. Ссылки одноразовые и действуют 15 минут; открывайте их в том же браузере, что и страницу подтверждения.

owlmem vault unlock просит только код восстановления

Это старая версия. Выполните npx -y owlmem@latest vault unlock (или обновите командой npm install -g owlmem) и нажмите Enter в ответ на запрос.

“This passkey can't unlock the vault” (этот Passkey не может разблокировать хранилище)

Устройство этого Passkey не поддерживает функцию PRF. Подтверждать агентов он по-прежнему может. Добавьте другой Passkey, сохранённый в Google Password Manager, iCloud Keychain или Windows Hello.

“401 Unauthorized” при использовании токена

Токен отозван или введён с ошибкой. Токены начинаются с om_ и передаются как Authorization: Bearer om_….

Всё ещё не получается? Напишите на [email protected].