MCP WEEEK с базой знаний
weeek-mcp
MCP-сервер для WEEEK: задачи через публичный API и полноценный CRUD базы знаний через внутренний API с сохраненной сессией браузера
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Хранит сессию браузера для доступа к внутреннему API WEEEK
- Может создавать, редактировать и удалять документы базы знаний
Установка
Ручная установка
pip install "weeek-mcp[kb]" && playwright install chromium && weeek-mcp-login && claude mcp add weeek -s user -e WEEEK_API_TOKEN=... -- weeek-mcpУстановка для остальных MCP-клиентов, [kb] можно опустить, если база знаний не нужна.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер закрывает две части WEEEK, у которых разная природа доступа. Задачи, доски и колонки идут через официальный публичный REST API: полный жизненный цикл задачи, назначение и снятие исполнителей. База знаний официального публичного API не имеет, поэтому сервер обращается к внутреннему JSON API WEEEK через сохраненную сессию браузера, полученную одноразовым входом weeek-mcp-login с Playwright. Документы базы знаний рендерятся в Markdown и публикуются как MCP-ресурсы weeek-kb://<id>, поэтому их можно выбирать как контент прямо в MCP-клиенте, а не только по ссылке. Правка тела документа на месте говорит на совместном протоколе WEEEK Hocuspocus/Yjs напрямую, потому что содержимое живет в общем документе для совместного редактирования.
Для кого. Для тех, кому кроме задач WEEEK нужны документы базы знаний прямо в контексте агента.
Подходит, если
- Нужен доступ и к задачам, и к базе знаний WEEEK из одного сервера
- Нужно, чтобы документы базы знаний подтягивались как контент, а не просто ссылка
- Работаете в Claude Desktop и хотите установку одним файлом .mcpb
Не подходит, если
- Не хочется входить в WEEEK через браузерную сессию Playwright ради базы знаний
- Нужны только задачи, без базы знаний можно взять более простой сервер без Playwright
Пример запроса к агенту
Найди в базе знаний документ про онбординг и заведи задачу проверить его актуальностьОграничения
Работа с базой знаний требует Playwright и сохраненную сессию, полученную одноразовым входом, а при 2FA или SSO вход нужно повторять вручную командой weeek-mcp-login. Без email и пароля в настройках сервер не может переавторизоваться сам при истечении сессии. Задачи работают без Playwright, только с WEEEK_API_TOKEN. Подтягивание документов через меню вложений зависит от поддержки MCP Resources конкретным клиентом и работает не во всех.
Как отключить. Удалите .mcpb-расширение в Claude Desktop через Settings → Extensions или уберите сервер weeek-mcp из конфигурации другого MCP-клиента.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| WEEEK_API_TOKEN обязательная, секрет | Личный токен WEEEK для задач через публичный API. |
Проверка безопасности
- Хранит сессию браузера для доступа к внутреннему API WEEEK
- Может создавать, редактировать и удалять документы базы знаний
Коротко о README
README на английском с русской версией отдельным файлом описывает две части функциональности: задачи через публичный REST API и базу знаний через внутренний API WEEEK с ресурсами MCP. Показаны два пути установки: .mcpb для Claude Desktop без Python и pip для остальных клиентов (Claude Code, Cursor, Windsurf, VS Code и других) с одноразовым входом для базы знаний через weeek-mcp-login и Playwright. Отдельно объяснено, что подтягивание документов через вложения зависит от поддержки MCP Resources клиентом.
Частые вопросы
Почему база знаний работает не через официальный API?
У WEEEK нет публичного API для базы знаний, поэтому сервер использует внутренний JSON API через сохраненную сессию браузера из одноразового входа.
Нужен ли Python для установки в Claude Desktop?
Нет для задач: Desktop запускает .mcpb-сервер своим встроенным uv. Python нужен только для установки через pip в других клиентах или для одноразового входа в базу знаний.
Похожие
Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI