SkillFoxx
Telegram

MCP WEEEK с базой знаний

weeek-mcp

MCP-сервер для WEEEK: задачи через публичный API и полноценный CRUD базы знаний через внутренний API с сохраненной сессией браузера

  • 2 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Хранит сессию браузера для доступа к внутреннему API WEEEK
  • Может создавать, редактировать и удалять документы базы знаний
Все причины и проверки
Российский стек

adalekin/weeek-mcpАвтор:adalekin

Установка

Сервисы

Ручная установка

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] можно опустить, если база знаний не нужна.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Хранит сессию браузера для доступа к внутреннему API WEEEK
  • Может создавать, редактировать и удалять документы базы знаний

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер закрывает две части 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

Пример запроса к агенту

Найди в базе знаний документ про онбординг и заведи задачу проверить его актуальность

MCP

Транспорт
stdio
Авторизация
API-ключ

Переменные окружения

WEEEK_API_TOKEN обязательная, секрет
Личный токен WEEEK для задач через публичный API.

Ограничения

Работа с базой знаний требует Playwright и сохраненную сессию, полученную одноразовым входом, а при 2FA или SSO вход нужно повторять вручную командой weeek-mcp-login. Без email и пароля в настройках сервер не может переавторизоваться сам при истечении сессии. Задачи работают без Playwright, только с WEEEK_API_TOKEN. Подтягивание документов через меню вложений зависит от поддержки MCP Resources конкретным клиентом и работает не во всех.

Как отключить. Удалите .mcpb-расширение в Claude Desktop (Settings, раздел Extensions) или уберите сервер weeek-mcp из конфигурации другого MCP-клиента.

Частые вопросы

Почему база знаний работает не через официальный API?

У WEEEK нет публичного API для базы знаний, поэтому сервер использует внутренний JSON API через сохраненную сессию браузера из одноразового входа.

Нужен ли Python для установки в Claude Desktop?

Нет для задач: Desktop запускает .mcpb-сервер своим встроенным uv. Python нужен только для установки через pip в других клиентах или для одноразового входа в базу знаний.

Обсуждение

Вопросов и отзывов пока нет.

WEEEK — все инструменты
Российский стек

MCP-сервер для WEEEK, по умолчанию только чтение: задачи, вложения и комментарии через браузерную сессию, запись включается отдельно

MCP-серверРасширенный доступ
Российский стек

MCP-сервер для WEEEK на 12 инструментов: 7 на чтение и 5 на запись отдельно, чтобы MCP-клиент мог авто-одобрять безопасные вызовы

MCP-серверРасширенный доступ1
Российский стек

Python MCP-сервер для WEEEK API v1: задачи, проекты, доски, воронки, сделки и контакты, с режимом SSE для n8n

MCP-серверШирокий доступ2
Российский стек

MCP-сервер для WEEEK, построенный из официальной OpenAPI-спецификации: задачи, тайм-трекинг и вся CRM-часть с воронками и сделками

MCP-серверШирокий доступ2
Российский стек

MCP-сервер для WEEEK создает задачу по названиям проекта, колонки и исполнителя в один вызов, без цепочки запросов за их ID

MCP-серверРасширенный доступ4
Российский стек

Локальный MCP-сервер для Weeek: проекты, задачи и доски только на чтение по умолчанию, запись включается отдельно

MCP-серверРасширенный доступ

Коротко о README

README на английском с русской версией отдельным файлом описывает две части функциональности: задачи через публичный REST API и базу знаний через внутренний API WEEEK с ресурсами MCP. Показаны два пути установки: .mcpb для Claude Desktop без Python и pip для остальных клиентов (Claude Code, Cursor, Windsurf, VS Code и других) с одноразовым входом для базы знаний через weeek-mcp-login и Playwright. Отдельно объяснено, что подтягивание документов через вложения зависит от поддержки MCP Resources клиентом.

Бейдж для README

Сообщить о проблеме