kwork-mcp 1.2.1

kwork-mcp подключает ваш аккаунт Kwork к ИИ-агенту: Claude Code, Claude Desktop, Codex, Cursor и другим MCP-клиентам. Агент ищет проекты на бирже, читает диалоги, заказы и офферы, готовит отклики. Отправить что-то на Kwork он может только если вы включили запись, и только после вашего подтверждения.

Что можно попросить у агента

• «Найди свежие проекты про Telegram-ботов с бюджетом от 20 000 ₽ и скажи, какие мне подходят».
• «Покажи диалоги с непрочитанными сообщениями и предложи ответы».
• «Что с моими заказами? Где что-то ждёт моих действий?»
• «Сколько у меня коннектов и какие мои отклики ещё висят?»
• «Подготовь отклик на проект 3257238: 15 000 ₽, 5 дней» — агент покажет точный текст и цену и отправит только после вашего «да».

Быстрый старт

Нужны macOS или Linux, Python 3.12–3.14 и uv. Windows не поддерживается.

1. Войдите в Kwork (один раз)

Запустите в обычном терминале:

uvx --from kwork-mcp==1.2.1 kwork-mcp-bootstrap

Команда скрыто спросит логин и пароль Kwork, а также, по желанию, последние 4 цифры телефона и прокси. Затем покажет найденный аккаунт:

Найден аккаунт Kwork: your_name (user_id=123456). Привязать его? [y/N]: да

После подтверждения токен сохраняется в защищённое хранилище на вашем компьютере (~/.local/state/kwork-mcp), а в конце команда выводит ваш user_id. Он нужен на следующем шаге. Логин и пароль нигде не сохраняются.

2. Подключите агента

Замените 123456 на свой user_id.

Claude Code:

claude mcp add kwork --scope user \
  -e KWORK_EXPECTED_USER_ID=123456 \
  -e KWORK_PERSIST_TOKEN=true \
  -e KWORK_ENABLE_WRITES=false \
  -- uvx --from kwork-mcp==1.2.1 kwork-mcp

{
  "mcpServers": {
    "kwork": {
      "command": "uvx",
      "args": ["--from", "kwork-mcp==1.2.1", "kwork-mcp"],
      "env": {
        "KWORK_EXPECTED_USER_ID": "123456",
        "KWORK_PERSIST_TOKEN": "true",
        "KWORK_ENABLE_WRITES": "false"
      }
    }
  }
}

[mcp_servers.kwork]
command = "uvx"
args = ["--from", "kwork-mcp==1.2.1", "kwork-mcp"]

[mcp_servers.kwork.env]
KWORK_EXPECTED_USER_ID = "123456"
KWORK_PERSIST_TOKEN = "true"
KWORK_ENABLE_WRITES = "false"

Не добавляйте в конфиг клиента логин, пароль, токен или прокси: сервер с ними откажется запускаться. Всё это вводится только через kwork-mcp-bootstrap.

3. Проверьте

Перезапустите клиент и попросите агента: «проверь статус аккаунта Kwork». Он вызовет account_status и покажет ваш user_id и имя.

Отправка откликов и сообщений

По умолчанию агент только читает. Чтобы он мог отправлять отклики и сообщения, удалять офферы и менять статус кворков, замените в конфиге клиента KWORK_ENABLE_WRITES=false на true и перезапустите клиент. Для Claude Code:

claude mcp remove kwork --scope user
claude mcp add kwork --scope user \
  -e KWORK_EXPECTED_USER_ID=123456 \
  -e KWORK_PERSIST_TOKEN=true \
  -e KWORK_ENABLE_WRITES=true \
  -- uvx --from kwork-mcp==1.2.1 kwork-mcp

Каждая запись идёт в два шага. Сначала агент готовит точный запрос (текст, цену, получателя) и показывает его вам. Только после вашего подтверждения запрос уходит на Kwork. Сервер помнит каждую запись и никогда не повторяет её сам.

Если связь оборвалась в момент отправки, результат становится «неизвестным», и агент сверяет его с Kwork, прежде чем делать что-то ещё. Пока такая запись не сверена, новые отправки для аккаунта заблокированы, чтобы не создать дубль.

kwork.com

По умолчанию сервер работает с kwork.ru. Для kwork.com добавьте в конфиг клиента KWORK_SITE=com. Например, для Claude Code вторым сервером рядом с kwork.ru:

claude mcp add kwork-com --scope user \
  -e KWORK_EXPECTED_USER_ID=123456 \
  -e KWORK_PERSIST_TOKEN=true \
  -e KWORK_ENABLE_WRITES=false \
  -e KWORK_SITE=com \
  -- uvx --from kwork-mcp==1.2.1 kwork-mcp

Аккаунт и токен у kwork.ru и kwork.com общие, поэтому заново входить через kwork-mcp-bootstrap не нужно. Биржи проектов на kwork.com нет: поиск проектов, избранные категории и отклик на проект там отвечают site_unsupported. Диалоги, заказы и кворки работают как обычно, но заказы у каждого сайта свои. Запись, подготовленную для одного сайта, отправляет и сверяет только сервер того же сайта.

Если что-то не работает

Ручная фиксация исхода запускается с теми же KWORK_* переменными, что у сервера:

kwork-mcp-bootstrap pending-writes
kwork-mcp-bootstrap resolve-write <write_id> succeeded   # операция на Kwork прошла
kwork-mcp-bootstrap resolve-write <write_id> absent      # операции на Kwork нет

Инструменты

Чтение:

Запись: prepare_write → commit_write, а также get_write_status и reconcile_write. Поддерживаются отклик на проект, удаление отклика, отправка, правка и удаление сообщения, отметка диалога прочитанным, сдача заказа на проверку и запуск или пауза кворка.

Безопасность

• Логин, пароль и прокси вводятся только в kwork-mcp-bootstrap через скрытый ввод и не попадают в конфиг клиента.
• Сервер работает только с аккаунтом, указанным в KWORK_EXPECTED_USER_ID, и проверяет его перед каждой записью.
• Тексты проектов, профилей и сообщений помечаются как внешние данные, а не инструкции для агента.
• Токен лежит в файлах с правами 0600. Приложение их не шифрует, поэтому используйте шифрование диска.
• Лимиты запросов к Kwork общие для всех процессов одного аккаунта.

Подробно: модель безопасности, настройки, архитектура, переход с 0.2.x.

Разработка

git clone https://github.com/simonether/kwork-mcp.git
cd kwork-mcp
uv sync --locked --dev
uv run ruff check . && uv run ruff format --check .
uv run mypy
uv run pytest tests/ -q --cov=kwork_mcp

Для запуска из исходников в конфиге клиента используйте uv --directory /path/to/kwork-mcp run kwork-mcp вместо uvx. Правила для изменений и устройство кода описаны в AGENTS.md.

Лицензия

MIT