Weeeking 🛡️
Русский · English
Power your agent
คำสั่งของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
npx -y [email protected]Claude Code ไม่มีลิงก์ติดตั้งสำหรับคำสั่งแบบโลคัล ให้คัดลอกคำสั่งด้านล่างแล้วรันในเทอร์มินัล
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.0รันในเทอร์มินัล
{ "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 แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน 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.
เปิดจากผู้เผยแพร่
Русский · 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>" } } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ผู้เผยแพร่ระบุตัวแปรสภาพแวดล้อมเหล่านี้: 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 ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-11-09 MCP server for Weeek with full public API coverage: tasks, projects, CRM, time tracking.