Kwork

kwork-mcp は、Kwork アカウントを Claude Code、Claude Desktop、Codex、Cursor などの MCP クライアントに接続します。エージェントは マーケットプレイスでプロジェクトを検索し、会話、注文、オファーを読み取り、 応募文を作成します。デフォルトでは、正確な文面を確認してあなたが「はい」と 答えた後にのみ、エージェントは Kwork に何かを送信します。

プロジェクトのサイト：simonether.github.io/kwork-mcp。

エージェントに頼めること

• 「予算が 20 000 ₽ 以上の Telegram ボット関連の新着プロジェクトを探して、私に合うものを教えてください。」
• 「未読メッセージがある会話を表示して、返信案を提案してください。」
• 「私の注文の状況を教えてください。対応が必要なものはありますか？」
• 「コネクトはいくつありますか？まだ保留中の応募はありますか？」
• 「プロジェクト 3257238 への応募文を作成してください。15 000 ₽、5 日」—エージェントが正確な文面と価格を表示し、あなたが「はい」と答えた後にのみ送信します。

クイックスタート

macOS または Linux、Python 3.12–3.14、uv が必要です。 Windows はサポートされていません。

1. Kwork にログインする（初回のみ）

通常のターミナルで：

uvx [email protected] login

コマンドは Kwork のログイン名とパスワードを非表示で尋ねます。また、必要に応じて 電話番号の下 4 桁とプロキシも尋ね、見つかったアカウントを表示します：

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

確認後、トークンはお使いのコンピューター上の保護されたストレージ （~/.local/state/kwork-mcp）に保存されます。ログイン名とパスワードはどこにも 保存されません。最後に、コマンドは Claude Code と Codex 用の接続コマンド、および Claude Desktop と Cursor 用のブロックを表示します。

2. エージェントを接続する

Claude Code：

claude mcp add kwork --scope user -- uvx [email protected]

Codex：

codex mcp add kwork -- uvx [email protected]

Cursor：

{
  "mcpServers": {
    "kwork": {
      "command": "uvx",
      "args": ["[email protected]"]
    }
  }
}

サーバーはログイン済みのアカウントを自動的に検出します。複数のアカウントでログイン している場合は、-e KWORK_EXPECTED_USER_ID=123456 または JSON の "env" ブロックで 使用するアカウントを指定してください。

ログイン名、パスワード、トークン、プロキシをクライアントの設定に追加しないでください。 これらが含まれていると、サーバーは起動を拒否します。

3. 確認する

クライアントを再起動し、エージェントに「Kwork アカウントのステータスを確認して」と 依頼します。エージェントは account_status を呼び出して、user_id と名前を表示します。

クライアントを使わずに、ターミナルで同じ情報を確認することもできます： uvx [email protected] status は、Kwork に接続せずに、サーバーがどのアカウントとサイトで 起動するかを表示します。アカウントを切り替えるには、uvx [email protected] logout を 実行してから、もう一度 login を実行してください。

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

Отправку на Kwork (отклики, сообщения, удаление офферов, сдача заказа, запуск и пауза кворков) задаёт переменная KWORK_WRITES:

В режиме confirm сервер в ответе prepare_write и в своих инструкциях указывает агенту показать вам запрос и отправлять только после вашего «да». Сам проверить это «да» сервер не может. Вторую кнопку даёт клиент: Claude Code и Claude Desktop по умолчанию спрашивают разрешение перед инструментом отправки, а в Codex то же включает default_tools_approval_mode = "writes" в настройках сервера [mcp_servers.kwork].

Режим выбирается в конфиге клиента, например для Claude Code:

claude mcp remove kwork --scope user
claude mcp add kwork --scope user -e KWORK_WRITES=auto -- uvx [email protected]

В режиме auto от чужих команд в текстах проектов и сообщений защищает только поведение агента: сервер помечает эти тексты как внешние данные, но проверить, что агент их не послушал, не может.

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

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

kwork.com

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

claude mcp add kwork-com --scope user -e KWORK_SITE=com -- uvx [email protected]

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

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

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

uvx [email protected] pending-writes
uvx [email protected] resolve-write <write_id> succeeded   # операция на Kwork прошла
uvx [email protected] resolve-write <write_id> absent      # операции на Kwork нет

Инструменты

Чтение:

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

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

• Логин, пароль и прокси вводятся только в kwork-mcp login через скрытый ввод и не попадают в конфиг клиента.
• Сервер работает только с аккаунтом, который вы подтвердили при входе (если аккаунтов несколько, с указанным в 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