Weeeking 🛡️
Русский · English
Potencia tu agente
El comando propio del publicador. No es un endpoint de PlugMCP.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code no tiene enlace de instalación para un comando local. Copia el comando de abajo y ejecútalo en una terminal.
WEEEK_API_TOKEN=<secret> WEEEK_TOKEN=<secret> READ_ONLY=<value> WEEEK_LANG=<value> WEEEK_ALLOW_ACTIONS=<value> WEEEK_DENY_ACTIONS=<value> WEEEK_PROFILE=<value> WEEEK_BASE_URL=<value> WEEEK_DISABLE_KEYCHAIN=<value> WEEEK_MAX_RESPONSE_CHARS=<value> WEEEK_RPS=<value> WEEEK_RPS_BURST=<value> WEEEK_LOG=<value> claude mcp add io.github.onive-weeeking -- npx -y weeeking@0.6.0Ejecútalo en una terminal.
{ "mcpServers": { "io.github.onive-weeeking": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "WEEEK_API_TOKEN": "<secret>", "WEEEK_TOKEN": "<secret>", "READ_ONLY": "<value>", "WEEEK_LANG": "<value>", "WEEEK_ALLOW_ACTIONS": "<value>", "WEEEK_DENY_ACTIONS": "<value>", "WEEEK_PROFILE": "<value>", "WEEEK_BASE_URL": "<value>", "WEEEK_DISABLE_KEYCHAIN": "<value>", "WEEEK_MAX_RESPONSE_CHARS": "<value>", "WEEEK_RPS": "<value>", "WEEEK_RPS_BURST": "<value>", "WEEEK_LOG": "<value>" } } }}claude_desktop_config.json
¿URL remota o un comando en tu máquina? En qué se diferencian las dos instalaciones
Ejecutar en PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirDel publicador
Русский · English
MCP server for Weeek with full public API coverage: tasks, projects, CRM, time tracking.
Weeek and conquer. MCP-сервер для Weeek с полным покрытием публичного API: 157 операций из официальной OpenAPI-спецификации. Один бинарник на Rust, без Node и внешних зависимостей в рантайме. Релизы — для семи платформ: Windows x64/arm64, Linux x64 (glibc/musl), Linux arm64, macOS arm64/x64.
action — weeek_project, weeek_board, weeek_board_column, weeek_custom_fields,
weeek_portfolio, weeek_tags, weeek_task (таймеры, записи времени, вложения, родитель…), weeek_funnels,
weeek_funnel_statuses, weeek_deals, weeek_organizations, weeek_contacts, weeek_currencies.weeek_context, weeek_search_tasks, weeek_get_task,
weeek_list_comments, weeek_download_attachment + записи (weeek_create_task, weeek_update_task,
weeek_move_task, weeek_complete_task, weeek_set_task_people, weeek_add_comment, weeek_delete_comment).READ_ONLY=false.weeek://me и weeek://projects читаются клиентом без tool-call; промпты
«Мои задачи на сегодня» и «Итоги недели» — готовые сценарии для агента.compact=true убирает null и пустые значения (включая пустые элементы массивов)
из тяжёлых ответов; fetchAll=true (+maxItems) собирает страницы задач и комментариев
(страница по умолчанию 100, не более 50 страниц) с флагом truncated.Retry-After и экспоненциальным бэкоффом (429 — для любого
метода, 502/503/504 и сетевые сбои — только для GET/HEAD; таймауты не повторяются); WEEEK_LOG=debug —
HTTP-логи в stderr (метод, путь, статус, длительность; без токена).tools/update_spec.py тянет OpenAPI с developers.weeek.net и генерирует
src/spec_generated.rs — статические данные (&'static str), которые компилируются в бинарник;
в рантайме нет ни JSON, ни парсинга, чанк спеки в репозитории не сохраняется.Требуется Rust 1.88+ (MSVC toolchain на Windows).
cargo build --release
# → target/release/weeeking.exe (Windows) / target/release/weeeking (Linux, macOS)
Готовые бинарники — в GitHub Releases: архивы
weeeking-<версия>-<платформа> и сырые бинарники для npm-обёртки; рядом — файлы .sha256,
хэши также перечислены в описании релиза.
# проверка контрольной суммы
certutil -hashfile weeeking-<версия>-win-x64.zip SHA256 # Windows
sha256sum -c weeeking-<версия>-linux-x64.tar.gz.sha256 # Linux
Каждый файл релиза подписан GitHub-аттестацией (Sigstore) — проверяемое происхождение сборки:
gh attestation verify weeeking-<версия>-win-x64.exe -R OniVe/weeeking
npx -y weeeking # MCP-сервер по stdio; бинарник скачается и проверится по sha256
Пакет weeeking — тонкая обёртка: берёт нативный бинарник нужной платформы (Windows x64/arm64,
Linux x64 gnu/musl, Linux arm64, macOS arm64/x64) из GitHub Releases этой же версии. Публикуется
через npm trusted publishing (OIDC, с provenance).
Сервер также опубликован в официальном MCP Registry — io.github.OniVe/weeeking; оттуда его
подхватывают каталог GitHub MCP и агрегаторы.
На macOS скачанный через браузер бинарник может ловить карантин Gatekeeper — снимите его
(xattr -d com.apple.quarantine <файл>) или ставьте через npx/curl.
WEEEK_API_TOKEN (или WEEEK_TOKEN) из окружения — приоритет всегда за ним.weeek-mcp с именем WEEEK_KEYCHAIN_ACCOUNT
(по умолчанию api-token): Windows Credential Manager (target api-token.weeek-mcp),
macOS Keychain, Linux Secret Service (GNOME Keyring/KWallet через D-Bus); сохраняется командой
weeeking store-token. Значение никогда не логируется.isError с подсказкой.Системное хранилище работает на всех платформах; на headless-Linux без D-Bus его нет — задайте
токен переменными окружения WEEEK_API_TOKEN или WEEEK_TOKEN.
Личность действий (автор комментариев, задач) определяется токеном: API всегда действует от владельца токена. Для второго пользователя нужен его собственный токен (создаётся в Настройках workspace → API; доступ к разделу есть у супер-админов и админов).
# 1) Сохранить токен второго аккаунта (ввод скрыт, в argv токен не попадает)
weeeking store-token --account api-token-anna
# 2) Запуск сервера под этим аккаунтом
$env:WEEEK_KEYCHAIN_ACCOUNT = "api-token-anna"; weeeking # PowerShell (Windows)
WEEEK_KEYCHAIN_ACCOUNT=api-token-anna weeeking # bash/zsh (macOS, Linux)
Пример второго инстанса в конфиге OpenCode (нативная форма V2):
"mcp": {
"servers": {
"weeek-anna": {
"type": "local",
"command": ["C:\\путь\\weeeking.exe"],
"environment": {
"WEEEK_KEYCHAIN_ACCOUNT": "api-token-anna",
"READ_ONLY": "false"
}
}
}
}
Агент сможет выбирать, от кого действовать: тулы weeek-anna_* пишут от Анны, weeek_* — от основного аккаунта.
Удалить запись из хранилища: Windows — cmdkey /delete:api-token-anna.weeek-mcp;
macOS — security delete-generic-password -s weeek-mcp -a api-token-anna;
Linux — средствами вашего хранилища (GNOME Keyring / KWallet).
На headless-Linux без D-Bus системного хранилища нет: мультиаккаунт — отдельный инстанс сервера
с собственным WEEEK_API_TOKEN в окружении.
weeeking запустить MCP-сервер (stdio)
weeeking store-token [--account <имя>] сохранить токен в системное хранилище
weeeking --help справка
READ_ONLY — грубый переключатель: false открывает весь изменяющий API. Тоньше доступ
настраивается фильтром операций (по operationId из OpenAPI):
WEEEK_DENY_ACTIONS — чёрный список: перечисленные операции (или маски: delete-*)
не вызываются и не показываются в описаниях инструментов;WEEEK_ALLOW_ACTIONS — абсолютный белый список: всё, что не перечислено (включая чтения),
запрещено; несовместим с WEEEK_PROFILE;WEEEK_PROFILE=executor — готовый узкий профиль: чтения плюс create-task и
create-task-comment (создание задачи и комментария; без изменений и удалений).Семантика: READ_ONLY=true сильнее списков и профиля (они игнорируются с предупреждением);
WEEEK_DENY_ACTIONS сильнее WEEEK_ALLOW_ACTIONS и профиля. Fail-closed: пустое значение
WEEEK_ALLOW_ACTIONS/WEEEK_DENY_ACTIONS и маска, не совпавшая ни с одной операцией OpenAPI,
останавливают сервер с ошибкой при старте; под READ_ONLY=true такие настройки игнорируются,
но о проблеме сообщается предупреждением. Списки разделяются запятыми и/или пробелами;
* в маске — любая подстрока.
Запрещённые действия не рекламируются в tools/list (действие исчезает из action-enum,
инструмент — из списка) и отклоняются при вызове с типизированной ошибкой. Ресурсы, промпты
и серверная инструкция тоже следуют политике: если контекст (weeek_context и ресурсы
weeek://me, weeek://projects) недоступен, он не рекламируется и не читается, а промпты,
опирающиеся на скрытые инструменты, пропадают из prompts/list.
# Запретить все удаления, остальное оставить:
READ_ONLY=false WEEEK_DENY_ACTIONS="delete-*" weeeking
# Узкий исполнитель: чтения, создание задач и комментариев:
READ_ONLY=false WEEEK_PROFILE=executor weeeking
# Явный белый список (абсолютный — чтения тоже перечисляются):
READ_ONLY=false WEEEK_ALLOW_ACTIONS="get-tasks,get-task,get-task-comments,create-task,create-task-comment" weeeking
Соответствие curated-инструментов операциям OpenAPI:
Инструмент доступен, только если разрешены все его операции (у weeek_context дополнительные
выборки get-boards/get-board-columns проверяются отдельно — при передаче projectId/boardId).
Админ-группы (weeek_project, weeek_task, …) фильтруют action-список: доступные операции
перечислены в описании инструмента.
Weeek не публикует лимиты запросов, и они, по-видимому, общие на workspace. Когда рядом работают несколько потребителей (инстансы weeeking, сервис-синхронизатор, скрипты), бюджет можно сгладить:
WEEEK_RPS — клиентский лимит запросов в секунду для этого инстанса (token bucket): действует
на все HTTP-запросы, включая повторные попытки; Retry-After не отменяется — пауза берётся
не меньше предписанной API;WEEEK_RPS_BURST — допуск всплеска в токенах: по умолчанию «секунда запаса» (ceil(RPS),
минимум 1) — короткая пачка укладывается в секунду без лишнего пейсинга; если при малом RPS
параллельные выборки не должны тормозить, задайте burst вручную;0.001 отклоняются на старте (иначе один запрос ждал бы тысячи секунд).Общий бюджет на несколько инстансов: разделите WEEEK_RPS между ними вручную или поставьте перед
API общий throttle-прокси и укажите его в WEEEK_BASE_URL — тогда лимит соблюдается суммарно.
# Строгий режим для сервиса-синхронизатора: 1 запрос/с без всплеска
READ_ONLY=false WEEEK_RPS=1 WEEEK_RPS_BURST=1 weeeking
# Интерактивный инстанс: в среднем 4 запроса/с, всплеск до 8
WEEEK_RPS=4 WEEEK_RPS_BURST=8 weeeking
Нативная форма OpenCode V2 — серверы живут в mcp.servers:
"mcp": {
"servers": {
"weeek": {
"type": "local",
"command": ["C:\\путь\\weeeking.exe"], // на любой ОС: ["npx", "-y", "weeeking"]
"environment": { "READ_ONLY": "false" }
}
}
}
Добавить из CLI: opencode mcp add weeek -- npx -y weeeking (с --global — для всех проектов).
Отключить сервер, не удаляя из конфига: "disabled": true (нативная V2-форма; V1-форма
"mcp": { "weeek": { … } } с enabled тоже поддерживается).
Любой другой MCP-клиент: команда — путь к бинарнику (или npx -y weeeking), транспорт — stdio.
pip install quickjs # зависимость кодогенератора (один раз)
python tools/update_spec.py # developers.weeek.net → src/spec_generated.rs (кодогенерация)
cargo fmt && cargo build --release
cargo fmt
cargo clippy --all-targets
cargo test # unit + mock-сюита (HTTP против эмулятора) + smoke
Приёмочный smoke против живого API (перед релизом; read-only по умолчанию):
python tools/live_smoke.py
python tools/live_smoke.py --write-test <PROJECT_ID> # + цикл мутаций в sandbox-проекте
Пересборка при работающем OpenCode (exe залочен запущенным MCP-сервером):
python tools\rebuild.py
tags в weeek_update_task заменяет весь список — сначала прочитайте задачу.Проект открыт для вклада и вопросов: баг-репорты, идеи и вопросы — в issues (для типовых случаев есть шаблоны).
Мейнтейнер — @OniVe.
Об уязвимостях сообщайте приватно — см. SECURITY.md. Токены не попадают в логи; не прикладывайте их к issue и PR.
MIT — см. LICENSE.
MCP server for Weeek with full public API coverage: tasks, projects, CRM, time tracking.
{ "mcpServers": { "io.github.onive-weeeking": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "WEEEK_API_TOKEN": "<secret>", "WEEEK_TOKEN": "<secret>", "READ_ONLY": "<value>", "WEEEK_LANG": "<value>", "WEEEK_ALLOW_ACTIONS": "<value>", "WEEEK_DENY_ACTIONS": "<value>", "WEEEK_PROFILE": "<value>", "WEEEK_BASE_URL": "<value>", "WEEEK_DISABLE_KEYCHAIN": "<value>", "WEEEK_MAX_RESPONSE_CHARS": "<value>", "WEEEK_RPS": "<value>", "WEEEK_RPS_BURST": "<value>", "WEEEK_LOG": "<value>" } } }}Herramientas
Aún no hay lista de herramientas. Los servidores remotos la reciben tras la primera comprobación de estado.
Preguntas frecuentes
Copia en esta página la configuración stdio para Cursor, Claude Desktop, Claude Code o VS Code. Usa la instalación del publicador, no un proxy de PlugMCP.
El publicador indica estas variables de entorno: WEEEK_API_TOKEN, WEEEK_TOKEN, READ_ONLY, WEEEK_LANG, WEEEK_ALLOW_ACTIONS, WEEEK_DENY_ACTIONS, WEEEK_PROFILE, WEEEK_BASE_URL, WEEEK_DISABLE_KEYCHAIN, WEEEK_MAX_RESPONSE_CHARS, WEEEK_RPS, WEEEK_RPS_BURST, WEEEK_LOG.
Weeeking se ejecuta localmente por stdio.
Última comprobación: 2026-11-09. MCP server for Weeek with full public API coverage: tasks, projects, CRM, time tracking.