MCP-сервер brainattic

База знаний, которую ваш ИИ читает и обновляет по вашим правилам.

Ценные знания часто оказываются разбросаны по личным беседам с ИИ, отдельным ассистентам и изолированным системам. brainattic предоставляет людям и ИИ-агентам общую постоянную базу знаний с управляемым доступом: единый авторитетный набор документов с историей версий, даже если участники команды пользуются разными ИИ-клиентами. Права доступа задают люди, правила помогают агентам работать по принятым принципам, а история изменений позволяет отслеживать и восстанавливать правки.

brainattic — это не ещё один ИИ-чатбот, не архив истории переписок и не замена SharePoint, Git или существующим бизнес-системам. В нём хранится необходимая команде информация из этих систем: решения, процедуры, сведения о клиентах и история проектов. ИИ-клиенты подключаются по протоколу Model Context Protocol (MCP), чтобы искать, читать и обновлять данные.

В этом репозитории описан размещённый MCP-сервер brainattic: его возможности, подключение клиента и порядок работы. Исходный код сервера здесь не представлен. Сервис размещает и обслуживает Finite Software Systems Ltd.


Конечная точка MCP	`https://app.brainattic.ai/api/mcp`
Транспорт	Streamable HTTP
Аутентификация	OAuth 2.1, обнаруживается автоматически (динамическая регистрация клиента, ключ API и секрет клиента не требуются)
Официальное имя в реестре MCP	`ai.brainattic/knowledge-base`
Карточка для обнаружения	https://brainattic.ai/.well-known/mcp/server.json
Продукт и регистрация	https://brainattic.ai
Инструкция по подключению	https://brainattic.ai/docs/connect
Поддержка	https://brainattic.ai/support · hello@brainattic.ai

Одна база знаний для всех агентов

Личная память ИИ помогает одному человеку в одном клиенте. Общие знания позволяют всей команде опираться на принятые решения, исправлять их в одном месте и использовать в следующих задачах — без копирования личных переписок и необходимости просить всех перейти на другого ассистента.

Отдел продаж может работать в ChatGPT, аналитики — в Claude, разработчики — в VS Code с GitHub Copilot, а операционная команда — в Hermes. Все используют одну и ту же версионируемую базу знаний в пределах своих прав доступа, сохраняя привычные инструменты и рабочие процессы.

Совместную работу регулируют три отдельных механизма:

Права доступа определяют, к чему пользователи и подключённые к ним агенты могут обращаться и что могут изменять.
Правила — написанные людьми инструкции о том, как агентам следует работать. Они направляют поведение, но технически не ограничивают доступ и не заменяют права доступа.
История изменений и аудит позволяют отслеживать правки, проверять их и восстанавливать предыдущие версии документов.

Мы создали brainattic в Finite Software Systems Ltd, чтобы устранить именно тот пробел, с которым столкнулись в собственной работе. В разделе Одна база знаний для всех агентов показано, как запрос на изменение проходит путь от звонка с клиентом через анализ, реализацию и тестирование до выпуска, а также как новый участник команды осваивается за одну беседу.

Возможности сервера

После подключения агент работает в вашем рабочем пространстве brainattic и использует ваши права доступа. Каждый пользователь входит в систему под собственной учётной записью, поэтому агент получает доступ только к тем данным, которые доступны этому пользователю.

Инструменты сервера распределены по следующим группам:

Поиск и извлечение данных. Гибридный поиск по ключевым словам и смыслу по документам, а также извлечение фрагментов для подготовки обоснованных ответов со ссылками на источники.
Документы. Создание, чтение, просмотр списка и обновление документов в формате Markdown. Правки можно вносить точечно: открыть сеанс редактирования, применить пакет изменений, а затем сохранить их или отменить.
История версий. Каждое сохранённое изменение создаёт новую версию. Можно просматривать историю, читать любую предыдущую версию и восстанавливать её.
Правила. Написанные людьми инструкции для рабочих пространств, проектов и групп. Перед внесением изменений агентам следует ознакомиться с ними, чтобы учитывать принятые в команде правила.
Проекты и группы. Организация документов, их архивация и восстановление.
Вложения. Добавление файлов и изображений к документам и их просмотр.
Навыки. Хранение повторно используемых процедур для агентов в виде версионируемых навыков с вспомогательными файлами.
Напоминания. Создание разовых и повторяющихся напоминаний для участников рабочего пространства.

При подключении клиент обнаруживает актуальный список инструментов. Каждый инструмент содержит аннотации MCP (readOnlyHint, destructiveHint, openWorldHint), поэтому клиент может запросить подтверждение перед запуском инструмента, который изменяет или удаляет данные.

Безопасность данных и размещение

Основные данные клиентов хранятся и обрабатываются на инфраструктуре под управлением Finite Software Systems Ltd в Болгарии, в Европейском союзе. Finite Software Systems Ltd эксплуатирует собственную инфраструктуру, размещённую в дата-центре уровня Tier 3+ в Софии. Оператор дата-центра предоставляет физические помещения и контролирует доступ к ним, но не имеет логического доступа к данным клиентов.

Рабочие пространства клиентов изолированы друг от друга на логическом уровне. Для них предусмотрены ролевые права доступа и индивидуальная аутентификация пользователей. Доступ защищён с помощью TLS; для MCP-подключений используется аутентификация на основе OAuth. Finite Software Systems Ltd применяет сегментацию сетей, межсетевые экраны, ограничение административного доступа, ведёт операционные журналы и журналы безопасности, осуществляет мониторинг и регулярно создаёт резервные копии на контролируемой компанией инфраструктуре в ЕС. Finite Software Systems Ltd строго соблюдает документированные процедуры ISO 9001 и ISO/IEC 27001.

brainattic не передаёт документы клиентов сторонним ИИ-моделям самостоятельно.

Выбранный вами ИИ-клиент может получать содержимое, которое вы явно запрашиваете через коннектор, с учётом ваших прав доступа и правил самого клиента. Размещение данных в ЕС не определяет, где поставщик ИИ обрабатывает это содержимое. Дополнительные интеграции, например напоминания Slack, также могут предусматривать передачу данных за пределы ЕЭЗ. Эти и другие ограниченные исключения описаны в опубликованных правилах.

Опубликованные сведения о мерах безопасности, обработке данных и договорных обязательствах доступны в разделах Безопасность, Политика конфиденциальности и Соглашение об обработке данных.

Локальное развертывание

Finite Software Systems Ltd готова предложить организациям локальное развертывание brainattic на собственной инфраструктуре, чтобы они могли контролировать место и порядок эксплуатации базы знаний. Каждое развертывание планируется индивидуально: мы согласуем с вами требования, объём работ, интеграции и сроки внедрения.

Начать можно с пилотного проекта — он позволит оценить реализуемость и практическую ценность решения, прежде чем переходить к его локальному развертыванию с Finite Software Systems Ltd. Свяжитесь с нами, чтобы обсудить ваши потребности и подходящий вариант развертывания для вашей организации.

ИИ-клиенты и интеграции также должны соответствовать вашим требованиям к обработке данных. Локальное размещение базы знаний само по себе не определяет, где эти сервисы обрабатывают содержимое.

Требования

Учётная запись brainattic и доступ к рабочему пространству. Если у вас их нет, зарегистрируйтесь.
MCP-клиент с поддержкой удалённых серверов Streamable HTTP и OAuth.
Браузер для однократного входа.

Настройка

Все клиенты используют один и тот же URL: https://app.brainattic.ai/api/mcp. При первом подключении клиент откроет окно браузера. Войдите в brainattic и подтвердите доступ. Вводить ключ или секрет не нужно.

VS Code (GitHub Copilot)

Добавьте сервер в файл .vscode/mcp.json в проекте или в пользовательскую конфигурацию с помощью команды MCP: Add Server:

{
  "servers": {
    "brainattic": {
      "type": "http",
      "url": "https://app.brainattic.ai/api/mcp"
    }
  }
}

Запустите сервер из файла или представления MCP, завершите вход — и инструменты brainattic появятся в режиме агента Copilot.

Claude (claude.ai и Claude Desktop)

Откройте Settings → Connectors → Add custom connector. Назовите коннектор brainattic, вставьте URL и подключитесь. Claude проведёт вас через процедуру входа.

Claude Code

claude mcp add --transport http brainattic https://app.brainattic.ai/api/mcp

Затем выполните /mcp в Claude Code и выберите brainattic, чтобы войти.

ChatGPT

Откройте Settings → Connectors, добавьте пользовательский коннектор с указанным выше URL и завершите вход. Для пользовательских MCP-коннекторов требуется план ChatGPT с их поддержкой.

Cursor

Добавьте настройки в ~/.cursor/mcp.json для всех проектов или в .cursor/mcp.json для одного проекта:

{
  "mcpServers": {
    "brainattic": {
      "url": "https://app.brainattic.ai/api/mcp"
    }
  }
}

Mistral Vibe

Администратор рабочего пространства открывает Connectors, нажимает + Add Connector → Custom MCP Connector, задаёт имя brainattic и вставляет URL. В чате включите brainattic в разделе Tools.

Gemini CLI

gemini extensions install https://github.com/rutash/brainattic-gemini-cli

Затем выполните /mcp auth brainattic в Gemini CLI.

Любой другой MCP-клиент

Укажите в настройках клиента адрес https://app.brainattic.ai/api/mcp (Streamable HTTP). OAuth 2.1 обнаруживается на стороне сервера, как описано в спецификации авторизации MCP. Неаутентифицированный запрос возвращает 401 с bearer challenge, который сообщает клиенту, где пройти вход.

Как пользоваться

brainattic лучше всего подходит для работы в формате диалога: агент предлагает изменения, вы уточняете и одобряете их, а агент выполняет. Всё, что он записывает, сохраняется как редакция, которую можно просмотреть или откатить.

Ниже описан подходящий порядок действий для первого сеанса.

1. Начните с правил рабочего пространства

Правила — это короткие соглашения, составленные людьми. Агент читает их до того, как что-либо записывать. Например, в них можно указать язык, формат дат, правила именования, допустимые статусы и то, что ни при каких обстоятельствах нельзя записывать (секреты, учётные данные, персональные данные). В каждом рабочем пространстве с самого начала есть документ с правилами, поэтому начните с вопроса:

«Какие правила нужно соблюдать перед тем, как что-либо записывать в этом рабочем пространстве? Прочитай их и объясни простыми словами».

Если правила уже заполнены, агент кратко изложит их и объяснит, как будет им следовать. Если они пока пусты, агент сообщит об этом — это будет повод перейти к шагу 2.

2. Настройте правила под свой подход к работе

Сформулируйте правила в диалоге с агентом, не создавая их с нуля:

«Предложи правила для нашего рабочего пространства: язык, формат дат, именование документов, набор статусов и список того, что нельзя записывать. Учитывай мой подход к работе. Подготовь черновик на проверку и пока ничего не сохраняй».

Внесите замечания, добавьте, удалите или уточните пункты, пока черновик вас не устроит. Затем скажите: «Сохрани эти правила для рабочего пространства». Для изменения правил рабочего пространства нужны права администратора. Редакторы могут задавать правила для проекта или группы, а администратор также может редактировать любые правила в веб-приложении: Admin → Rules. Начиная со следующей записи, все подключённые агенты будут читать утверждённые правила, а не только тот агент, с которым вы общались.

3. Попросите объяснить, как устроен brainattic

Попросите агента объяснить модель на примерах из вашей работы:

«Объясни, как в brainattic связаны рабочие пространства, проекты, группы, документы, правила и навыки. Приведи примеры из моей работы».

Кратко:

Понятие	Описание	Пример
Рабочее пространство	Граница, в пределах которой действуют знания и разрешения команды. Каждому участнику назначена роль: Читатель, Редактор или Администратор.	«Acme Ltd»
Проект	Необязательное основное место для документа. Документ может относиться не более чем к одному проекту, а в проекте может быть создано написанное вручную обзорное вступление («начните здесь»).	«Подключение клиентов»
Группа	Сквозная метка. Документ может относиться к нескольким группам или не относиться ни к одной, независимо от проекта. Группы не являются подразделами проектов.	«для клиентов», «требует проверки»
Документ	Версионируемая страница в Markdown. Каждое сохранённое изменение становится редакцией.	«Контрольный список подключения»
Правила	Соглашения на уровне рабочего пространства, проекта или группы. Агент читает их в этом порядке, а при прямом противоречии приоритет имеет более конкретный уровень.	«Каждая инструкция начинается с краткого описания цели»
Навыки	Повторно используемые пошаговые инструкции для агентов, на которые могут ссылаться правила.	«Как оформить заметки о встрече»

4. Узнайте, как применить brainattic к своей работе

Ваш агент уже многое о вас знает: предыдущие беседы, обсуждавшиеся проекты, которыми вы делились файлы и любые данные, которые хранит клиент. Попросите его связать эти сведения с brainattic:

«Учитывая то, что ты знаешь о моей работе из наших разговоров, как лучше всего использовать brainattic? Что стоит хранить здесь, что лучше оставить за его пределами и где это сэкономит нам больше всего времени?»

Хороший ответ содержит конкретные варианты: например, регулярно принимаемые решения, инструкции, о которых часто спрашивают, сведения о клиентах или историю проектов. Агент также объяснит, почему эту информацию лучше хранить в общей базе знаний с установленными правилами, а не в отдельном чате.

Примечание: память агента хранится в вашем AI-клиенте, а не в brainattic. brainattic видит только те данные, которые агент читает или записывает через коннектор в пределах разрешений вашей учётной записи.

5. Попросите агента предложить первый проект

Сначала запросите полный план и только потом разрешайте что-либо создавать:

«Предложи для меня первый проект в brainattic: укажи его название и цель, подготовь обзор проекта, перечисли необходимые группы и правила проекта, а также составь черновики трёх примеров документов на основе того, над чем мы уже работали. Покажи весь план и ничего не создавай, пока я не одобрю его».

Типичное предложение выглядит так:

– «Каждая инструкция начинается с краткого описания цели и содержит имя ответственного. Даты указываются в формате ГГГГ-ММ-ДД. Никогда не записывай пароли клиентов или ключи API. Примеры: 1. Контрольный список подключения (для клиентов) 2. Шаблон заметок о стартовом звонке (только для внутреннего использования) 3. Выводы из трёх последних подключений (требует проверки)">

Project:   Customer onboarding. Everything a new customer needs from signing to go-live.
Overview:  "Start here": scope, owners, where the checklist lives, how to propose changes.
Groups:    customer-facing · internal-only · needs-review
Rules:     Title pattern "<Customer> – <topic>". Every procedure starts with a one-line purpose
           and lists its owner. Dates as YYYY-MM-DD. Never record customer passwords or API keys.
Examples:  1. Onboarding checklist (customer-facing)
           2. Kick-off call notes template (internal-only)
           3. Lessons learned from our last three onboardings (needs-review)

Уточните предложение — например, попросите «объединить эти две группы», «добавить группу для договоров» или «ужесточить правила для дат», — а затем одобрите его. Агент создаст проект, группы, обзор и правила, а также добавит примеры документов. Откройте веб-приложение, проверьте результат и историю редакций каждого документа. Изменения можно запросить обычными словами.

6. Придерживайтесь этого подхода

В дальнейшем работайте по той же схеме: агент предлагает, вы уточняете и одобряете, агент выполняет.

Примеры повседневных запросов:

«Найди в brainattic контрольный список для развёртывания, кратко изложи шаги и укажи документы, на которые опирается ответ».
«Добавь эти заметки о встрече в подходящий проект, дай им понятное название и назначь нужные группы».
«Прочитай руководство по подключению и добавь раздел о доступе к VPN. Следуй правилам».
«Покажи, что изменилось на странице с ценами за прошлую неделю, и восстанови предыдущую редакцию».
«Напомни команде в пятницу в 10:00 проверить журнал инцидентов».

Полезные привычки:

Начинайте с действий только для чтения. Прежде чем разрешать агенту вносить изменения, попросите его найти документ, который точно существует.
Проверяйте действия с записью данных. Некоторые инструменты создают, изменяют, архивируют или удаляют содержимое. Обычно клиент запрашивает подтверждение перед их запуском — внимательно прочитайте запрос, прежде чем одобрять его.
Используйте редакции. Каждое сохранение фиксируется, поэтому ошибочное изменение можно проверить и откатить.
Дополняйте правила по мере работы. Если вам дважды приходится поправлять агента по одному и тому же вопросу, попросите его предложить соответствующее правило.

Устранение неполадок

Окно входа не открывается: запустите клиент на устройстве с локальным браузером. Вход через OAuth не подходит для сеанса SSH без участия пользователя.
После успешной работы появляется сообщение «Unauthorized»: войдите снова в настройках MCP или коннектора вашего клиента.
Инструменты отсутствуют: проверьте, что сервер brainattic подключён и включён в клиенте, затем переподключитесь.
Доступ запрещён: доступные вам действия зависят от роли в brainattic. Обратитесь к администратору рабочего пространства — клиент не может изменить эти ограничения.

Право собственности и лицензия

brainattic — продукт компании Finite Software Systems Ltd.

(ФИНИТ Софтуер Системс ЕООД), Company No. 175276896, Sofia, Bulgaria.

Сайт: https://brainattic.ai · Компания: https://finite-soft.com · Контакты: hello@brainattic.ai

© 2026 Finite Software Systems Ltd. Эта документация принадлежит Finite Software Systems Ltd и распространяется по лицензии Creative Commons Attribution 4.0 International (CC BY 4.0) (полный текст доступен в файле LICENSE). Вы можете копировать и адаптировать её, в том числе в коммерческих целях, при условии указания Finite Software Systems Ltd и ссылки на этот репозиторий.

Сам сервис brainattic является проприетарным продуктом и регулируется Условиями использования. Название «brainattic» и его логотип не распространяются по лицензии CC BY 4.0.