Что агент делает в трекере WEEEK
Собственного MCP-сервера у WEEEK нет, все серверы и плагины написали пользователи трекера. Наборы инструментов у них заметно расходятся. Один сервер умеет только задачи, другой дотягивается до сделок и документов базы знаний, поэтому выбирать удобно по сценарию.
- Рабочий день разработчика. Плагин claude-weeek берет задачу и предлагает имя ветки, показывает задачи на сегодня, собирает стендап по коммитам и двигает задачу на следующую стадию. Два хука находят номер задачи в имени ветки и в коммите без обращения к API. Удаления в плагине нет намеренно. Пространства на своем сервере (self-hosted) он тоже поддерживает.
- Задача одной фразой. MCP WEEEK по именам вместо ID принимает в
weeek_create_taskназвания проекта, колонки и исполнителя и срок вроде «next friday». Обычно для этого нужно четыре запроса за идентификаторами. В Claude Desktop сервер ставится расширением.mcpb, а токен хранится в системной связке ключей. - Комментарии и исполнители обычной речью. Плагин WEEEK с 12 отобранными инструментами закрывает 23 операции API для Codex и Claude Code, отвечает именами вместо id и markdown вместо HTML. Нужен Node 22.18 или новее.
- Учет времени. MCP-сервер Weeek для задач и учета времени добавляет к задаче затраченное время и строит сводный отчет с группировкой. Код покрыт тестами pytest.
- Сделки и воронки. MCP WEEEK из OpenAPI с CRM строит инструменты из официальной спецификации с developers.weeek.net, поэтому имена методов совпадают с документацией. Инструментов много, и найти нужный по тегу или тексту помогает
weeek_list_operations. - Документы базы знаний. MCP WEEEK с базой знаний читает и правит статьи через внутренний API под сохраненной сессией браузера. У публичного API этой части нет.
Где взять токен WEEEK API
Токен создают в настройках рабочего пространства, раздел API. Публичный API v1 принимает его в заголовке Authorization: Bearer и выполняет все запросы от имени того, кто создал токен. Права токена документация не делит. Описания серверов называют его доступ полным. Ограничивать агента приходится на стороне сервера или MCP-клиента.
Серверы читают токен из переменной WEEEK_API_TOKEN или WEEEK_TOKEN. Плагины с системной связкой ключей спрашивают его один раз при установке. Если завести для агента отдельного пользователя, его правки в задачах не смешаются с вашими.
npx skillfoxx add mcp/weeek-mcp
Режим только чтения для агента
MCP-сервер Weeek по умолчанию показывает 10 инструментов чтения, а 5 инструментов для правок прячет до READ_ONLY=false. Список ENABLED_TOOLS сужает набор еще сильнее. MCP WEEEK с правками только по подтверждению требует WEEEK_ALLOW_WRITE, список разрешенных проектов и подтверждение каждого действия.
Третий путь дает MCP WEEEK с разделением чтения и правок. У него 7 инструментов чтения и 5 для правок, и в клиенте можно одобрять автоматически только первые. Списки он режет по 20 позиций, максимум 50, чтобы ответ не съел контекст.
У этих трех серверов расширенный уровень доступа. Широкий стоит у claude-weeek, у сервера из OpenAPI и у Weeek MCP Server, который покрывает весь API вместе с удалением пользователей, проектов и сделок. VPN не нужен ни одному из этих серверов.
Что агент может испортить
Токен видит все пространство, включая CRM, даже если сервер работает только с задачами. Удаленную через API задачу или сделку из чата не вернуть. Перемещения и правки у сервера weeek-mcp откатываются вручную.
Сетевой режим SSE у Weeek MCP Server нужен для n8n и открывает API пространства по сети. Без MCP_API_KEY, HTTPS и firewall порт наружу не открывайте. Серверы с базой знаний и комментариями держат куки браузера. При 2FA или SSO вход повторяют вручную.
Если в команде трекер другой, посмотрите соседние разделы Кайтен и YouGile. Сравнить серверы под ваш процесс можно в подборе Foxx AI.