Kwork

kwork-mcp 将您的 Kwork 账号连接到 AI Agent：Claude Code、Claude Desktop、Codex、Cursor 和其他 MCP 客户端。Agent 可以在交易平台上搜索项目、 查看对话、订单和报价，并准备回复。默认情况下，只有在您对确切文本说“是”之后，Agent 才会在 Kwork 上发送内容。

项目网站：simonether.github.io/kwork-mcp。

可以让 Agent 做什么

• “找找预算不低于 20 000 ₽ 的 Telegram 机器人相关新项目，并告诉我哪些适合我。”
• “显示有未读消息的对话，并建议如何回复。”
• “我的订单怎么样？哪些订单正在等待我处理？”
• “我有多少个连接点？我的哪些回复还在等待处理？”
• “为项目 3257238 准备回复：15 000 ₽，5 天”——Agent 会显示确切文本和价格，只有在您说“是”后才会发送。

快速开始

需要 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. 连接 Agent

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. 检查

重启客户端，并向 Agent 询问：“检查 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