Kollektiv | Your private LLM knowledgebase

Коллектив МКП

🧠 Ваша личная база знаний LLM

Kollektiv MCP позволяет вам создать персональную базу знаний LLM за считанные секунды и использовать ее из вашего любимого редактора/клиента. Больше никаких настроек инфраструктуры, фрагментации, синхронизации — просто загрузите свои данные и начните общаться. Поддерживает все основные клиенты MCP из коробки — Cursor, Windsurf, Claude Desktop и т. д.

🧪 Kollektiv находится в стадии ранней бета-версии. Если у вас возникли проблемы с подключением к клиенту MCP, попробуйте сначала выполнить эти шаги . Если все еще не удалось, пожалуйста, сообщите о проблеме здесь

Почему Коллектив?

• Нет необходимости повторно загружать данные между сеансами чата
• Доступ из любого клиента — Cursor, Windsurf, Claude Desktop, VSCode, PyCharm и т. д.
• Нет необходимости в настройке инфраструктуры — просто загрузите свои данные и начните общаться.

💿 Связь

Самый простой способ подключиться к Kollektiv MCP — скопировать и вставить следующую конфигурацию в файл mcp.json вашего редактора. Все клиенты (Cursor, Windsurf, Claude Desktop, VSCode, PyCharm) поддерживают этот формат json

• имя:
  • kollektiv - вы можете дать серверу любое описательное имя
• команда:
  • npx — убедитесь, что у вас установлен node.js перед запуском этой команды
• аргументы:
  • -y — позволяет вашей оболочке установить mcp-remote , который в настоящее время требуется для подключения к удаленным серверам.
  • mcp-remote — позволяет вашему клиенту подключаться к удаленному серверу MCP (в данном случае Kollektiv)
  • https://mcp.thekollektiv.ai/mcp — конечная точка, к которой вы подключаетесь

Ознакомьтесь с короткой демонстрацией ниже или прочтите индивидуальные инструкции по подключению для клиентов.

Курсор

Откройте курсор и перейдите в Cursor Settings > MCP > Add new global MCP Server . Вставьте конфигурацию выше и сохраните (ctrl/cmd+s).

Если настройка прошла успешно и вы ранее не проходили аутентификацию, должно открыться окно браузера, направляющее вас на страницу входа.

💡После сохранения json может потребоваться некоторое время для подключения Cursor к MCP. Возможно, вам придется перезапустить Cursor или дать ему немного времени. Если вы видите «Клиент закрыт» или другие ошибки, выполнение этих шагов по устранению неполадок может помочь.

Если подключение прошло успешно, вы увидите, что Kollektiv MCP на странице настроек станет зеленым:

Виндсерфинг

Откройте Windsurf и перейдите в Settings -> Windsurf Settings > MCP Servers > View raw config . Вставьте конфигурацию выше и сохраните (ctrl/cmd+s).

Если настройка прошла успешно и вы ранее не проходили аутентификацию, должно открыться окно браузера, направляющее вас на страницу входа.

💡Windsurf, в отличие от других клиентов, по моему опыту требует перезапуска приложения для правильного подключения. Если сервер не становится «зеленым» через некоторое время, попробуйте выполнить шаги по устранению неполадок ниже.

Если подключение прошло успешно, вы увидите, что Kollektiv MCP на странице настроек станет зеленым:

Клод для рабочего стола

Откройте Claude Desktop и перейдите в Settings -> Developer > Edit config . Откройте файл json в любом текстовом редакторе или редакторе кода, вставьте конфигурацию выше и сохраните (ctrl/cmd+s).

Если настройка прошла успешно и вы ранее не проходили аутентификацию, должно открыться окно браузера, направляющее вас на страницу входа.

💡Claude for Desktop требует перезапуска приложения для правильного подключения. Если сервер не становится «зеленым» через некоторое время, попробуйте выполнить шаги по устранению неполадок ниже.

Если подключение прошло успешно, вы увидите, что Kollektiv MCP на странице настроек станет зеленым:

Код VS

Откройте VS Code и перейдите в Settings -> MCP: Add server > Command (stdio) :

• команда:
  • npx -y mcp-remote https://mcp.thekollektiv.ai/mcp
• имя:
  • дайте вашему серверу описательное имя, например, kollektiv

Ваш файл конфигурации settings.json должен выглядеть примерно так:

Дальнейшие шаги:

• Нажмите «Пуск» , чтобы подключиться к серверу MCP.
  • если вы не аутентифицированы - вы будете перенаправлены на страницу аутентификации
• Не забудьте добавить "chat.mcp.enabled": true, в ваш settings.json
• Переключиться в режим агента

💡VS Code требует, чтобы вы вручную запустили свой сервер, добавили chat.mcp.enabled и переключились в режим агента, чтобы использовать MCP. Если вы не видите инструменты MCP в режиме агента, попробуйте выполнить шаги по устранению неполадок ниже.

Если подключение прошло успешно, вы должны увидеть инструменты, предоставляемые Kollektiv MCP.

Клайн

Откройте Cline, нажмите MCP Servers > Edit Configuration и добавьте следующую конфигурацию в файл cline_mcp_settings.json :

Примечание: Cline пока не поддерживает прямые подключения к удаленным серверам, поддерживающим авторизацию.

Если подключение прошло успешно, вы будете перенаправлены на этап аутентификации. После входа в систему вы должны увидеть включенный Kollektiv MCP в Cline.

Другие (PyCharm, Claude Code)

Большинство клиентов MCP используют тот же формат .json и должны работать с теми же шагами настройки, что и ранее упомянутые клиенты:

1. Скопируйте и вставьте конфигурацию в json -конфигурацию вашего клиента.
2. Перезапустите приложение.
3. Выполните аутентификацию, если вы еще этого не сделали
4. Kollektiv MCP должен стать зеленым и быть доступным в режиме чата/агента

Успех вашего подключения зависит от многих факторов, включая, помимо прочего:

• насколько сильно разработчики конкретного клиента хотели поддерживать соединения MCP
• поддерживает ли клиент последнюю спецификацию MCP с поддержкой OAuth

Если у вас возникли проблемы, вам могут помочь следующие простые шаги по устранению неполадок .

Поддерживаемые клиенты

Я проверил работу подключения к следующим клиентам MCP:

• Курсор ✅
• Виндсерфинг ✅
• Клод Рабочий стол ✅
• VS Код ✅
• Клайн ✅

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

🎮 Использование

Доступные инструменты

• /query_documents — Задайте вопрос к документам, которые вы загрузили в Kollektiv, и получите ответ на основе источников из ваших документов.
• /list_documents — возвращает список синхронизированных документов вместе с основными метаданными.
• Совет: добавьте фразу «используйте Kollektiv MCP», чтобы клиент знал, что нужно вызывать эти инструменты.

Советы по использованию

• Всегда добавляйте «использовать Kollektiv MCP» — это сообщает клиенту, какой сервер MCP использовать.
• Дождитесь, пока документ станет доступен . После загрузки может пройти 1–2 минуты, прежде чем документ можно будет запросить.
• При необходимости перефразируйте запросы . Если клиент сгенерировал плохой запрос, отредактируйте или перепишите его самостоятельно.

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

Этот сервер MCP использует Cloudflare Agents SDK, а также другие библиотеки, чтобы предоставить пользователям самый современный способ подключения и использования серверов MCP. С другой стороны, клиенты MCP еще не реализовали поддержку двух критических частей:

• удаленные серверы MCP
• Авторизация сервера MCP

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

Поддерживать

Если вам нужна дополнительная поддержка, пожалуйста, создайте запрос на GitHub или напишите на support@thekollektiv.ai

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

Если вы получаете ошибку «Неверный запрос на авторизацию», как показано ниже, или не можете подключиться по другой причине, попробуйте выполнить следующие действия, которые должны устранить проблему.

1. Убедитесь, что вы подключаетесь к правильной конечной точке :
   • Используйте https://mcp.thekollektiv.ai/mcp в качестве конечной точки MCP.
2. Очистите кэш mcp-remote :
   • Что это делает:
     • Удаляет кэш библиотеки mcp-remote , которая используется для подключения к удаленному серверу с клиента, который не поддерживает удаленные подключения.
   • Как:
     • Выполните следующую команду в терминале

3. Очистите данные браузера и файлы cookie :
   • Что это делает:
     • Удаляет файлы cookie браузера, которые используются для хранения информации аутентификации при входе в Kollektiv.
   • Как:
     • Откройте настройки браузера и удалите данные о просмотренных страницах за последние несколько часов.

⚠️ Примечание: это приведет к выходу из всех активных сеансов, включая Kollektiv. Делайте это только в том случае, если вы застряли в сломанном процессе входа.

4. Перезапустите клиент MCP и попробуйте повторно подключиться к серверу MCP:
   • Что это делает:
     • Клиенты MCP (Cursor, Windsurf и т. д.) часто кэшируют параметры подключения/конфигурации из предыдущих запусков, что может помешать аутентификации.
   • Как:
     • Перезапустите редактор/клиент.
     • Попробуйте повторно подключиться к серверу MCP.

Использование MCP-инспектора

Для отладки вы можете использовать MCP Inspector для подключения к серверу Kollektiv MCP.

Выберите транспорт SSE или потоковый HTTP

• SSE: подключитесь к серверу по адресу https://mcp.thekollektiv.ai/sse
• Потоковое HTTP: подключитесь к серверу по адресу https://mcp.thekollektiv.ai/mcp

🛠️ Подробности реализации (для 🤓)

Если вы здесь только ради Kollektiv - пропустите это. Этот раздел для разработчиков и строителей, которым интересно, как это работает.

Kollektiv MCP является частью модульной системы, позволяющей пользователям настраивать RAG для своих данных за считанные секунды — без необходимости управлять инфраструктурой, конвейерами или конфигурациями моделей.

Он состоит из трех независимо развернутых служб:

• MCP-сервер (Cloudflare Worker)
  https://mcp.thekollektiv.ai
  Действует как безопасный шлюз для взаимодействия клиентов с индексированными данными через Model Context Protocol. Поддерживает OAuth.
• Фронтенд (React + Vite Worker)
  https://thekollektiv.ai
  Понятный, минималистичный пользовательский интерфейс для загрузки и управления контентом.
• Бэкэнд (FastAPI)
  https://api.thekollektiv.ai
  Обеспечивает прием исходных данных, проверку и оркестровку конвейера RAG.

🔐 Безопасность

Kollektiv MCP реализует ряд мер безопасности:

• Вход в систему осуществляется с помощью стандартного потока OAuth 2.1 «Код авторизации», поддерживаемого Supabase; сохраняются только кратковременные, HttpOnly , Secure файлы cookie — никакие пароли никогда не попадают на этот сервер.
• Весь трафик обслуживается исключительно по протоколу HTTPS через Edge Cloudflare , и каждый конфиденциальный запрос POST содержит одноразовый CSRF/токен транзакции.
• Бэкэнд работает внутри «песочницы» Cloudflare Workers (без локальной файловой системы, без длительных процессов), что значительно сокращает поверхность атаки.Подробные правила раскрытия информации см. на сайте SECURITY.md .

🪪 Лицензия

Выпущено по лицензии Apache License 2.0 — коммерческая поддержка или альтернативное лицензирование: azuev@outlook.com