Skip to main content
Glama

CI PyPI Python License: MIT MCP Badge

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

Сайт проекта: simonether.github.io/kwork-mcp.

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

  • «Найди свежие проекты про Telegram-ботов с бюджетом от 20 000 ₽ и скажи, какие мне подходят».

  • «Покажи диалоги с непрочитанными сообщениями и предложи ответы».

  • «Что с моими заказами? Где что-то ждёт моих действий?»

  • «Сколько у меня коннектов и какие мои отклики ещё висят?»

  • «Подготовь отклик на проект 3257238: 15 000 ₽, 5 дней» — агент покажет точный текст и цену и отправит только после вашего «да».

Related MCP server: fiverr-mcp-server

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

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

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

В обычном терминале:

uvx kwork-mcp@1.5.2 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 kwork-mcp@1.5.2

Codex:

codex mcp add kwork -- uvx kwork-mcp@1.5.2

Cursor: Add to Cursor

Claude Desktop: Settings → Developer → Edit Config, файл claude_desktop_config.json. Cursor без кнопки: ~/.cursor/mcp.json или .cursor/mcp.json проекта.

{
  "mcpServers": {
    "kwork": {
      "command": "uvx",
      "args": ["kwork-mcp@1.5.2"]
    }
  }
}

Claude Desktop не видит uvx из терминала, поэтому возьмите блок из вывода login: в нём уже указан полный путь к uvx.

Сервер сам найдёт аккаунт, с которым вы вошли. Если вы входили в несколько аккаунтов, укажите нужный: -e KWORK_EXPECTED_USER_ID=123456 или блок "env" в JSON.

Логин, пароль, токен и прокси в конфиг клиента не добавляйте: сервер с ними откажется запускаться.

3. Проверьте

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

Без клиента то же видно в терминале: uvx kwork-mcp@1.5.2 status покажет, с каким аккаунтом и сайтом запустится сервер, не обращаясь к Kwork. Сменить аккаунт: uvx kwork-mcp@1.5.2 logout, затем снова login.

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

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

KWORK_WRITES

Что происходит

confirm (по умолчанию)

Перед каждой отправкой агент показывает точный текст, цену и получателя и ждёт вашего «да»

auto

Агент отправляет сам, когда это нужно для вашей задачи, без отдельного подтверждения

off

Только чтение: инструменты отправки скрыты, агент их не видит

В режиме 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 kwork-mcp@1.5.2

В режиме 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 kwork-mcp@1.5.2

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

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

Что видите

Что делать

auth_required или auth_expired

Входа нет или он истёк: выполните uvx kwork-mcp@1.5.2 login и перезапустите клиент

account_binding_required

Вы входили в несколько аккаунтов: укажите нужный в KWORK_EXPECTED_USER_ID или удалите лишний вход командой uvx kwork-mcp@1.5.2 logout <user_id>

Непонятно, какой аккаунт и сайт использует сервер

uvx kwork-mcp@1.5.2 status покажет это без запросов к Kwork

Сервер не стартует, «некорректная конфигурация: …»

Проверьте названные переменные KWORK_* в конфиге клиента

«KWORK_ENABLE_WRITES удалена в 1.5.0»

Замените её на KWORK_WRITES=off, confirm или auto

write_disabled

Сервер запущен с KWORK_WRITES=off, доступно только чтение

captcha

Войдите в Kwork в браузере, пройдите капчу, затем повторите login

Claude Desktop не видит сервер

Возьмите блок для Claude Desktop из вывода login (в нём полный путь к uvx) или укажите путь из which uvx, затем перезапустите приложение

ambiguous_write с related_write_id

Отправка с неизвестным результатом блокирует новые. Попросите агента выполнить reconcile_write для этого ID

Сверка долго не сходится

Проверьте операцию на сайте Kwork, указанном в поле site у pending-writes, и зафиксируйте исход вручную (команды ниже)

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

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

Инструменты

Чтение:

Инструмент

Что делает

account_status

Какой аккаунт подключён, включена ли запись, есть ли несверенные отправки

get_connects

Баланс коннектов

discover_projects, get_project

Проекты биржи: избранные категории, вся биржа или выбранные категории, фильтры по цене и откликам

get_exchange_info

Сводка по бирже

list_my_offers, get_offer

Ваши отклики

list_worker_orders, get_order_details

Ваши заказы как продавца

list_dialogs, get_dialog

Диалоги и сообщения

list_my_kworks, get_kwork_details

Ваши кворки

get_user_info, search_users

Профили пользователей

list_categories, list_favorite_categories

Категории

list_notifications

Уведомления

Запись: 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

Available Tools

22 tools
account_statusСтатус привязки аккаунта KworkA
Read-onlyIdempotent

Проверить фактический аккаунт, ожидаемую привязку и готовность writes.

Используйте первым после запуска и перед безопасным write-flow. Возвращает стабильные user_id/username и полную внешнюю запись профиля. Данные Kwork помечены как недоверенный внешний ввод.

Inputs: no named parameters. Returns: data, meta, error, summary, +2 more

commit_writeВыполнить подготовленную запись KworkA
DestructiveIdempotent

Выполнить ровно подготовленный payload в режиме shared one-writer.

Commit повторяем только с теми же write_id/payload_hash/token: shared ledger вернёт сохранённый результат и не вызовет Kwork повторно. Remote writes никогда автоматически не retry. Timeout, proxy loss, 5xx или неподтверждённый offer_id дают submission_unknown/isError; после этого commit повторять нельзя — вызовите reconcile_write. При KWORK_WRITES=confirm вызывайте commit_write только после явного «да» пользователя на точный текст, цену и получателя.

Inputs: write_id (required), payload_hash (required), confirmation_token (required). Returns: data, meta, error, summary, +2 more

discover_projectsПоиск проектов KworkA
Read-onlyIdempotent

Получить страницу проектов с явным discovery-режимом и opaque cursor.

favorites берёт избранные рубрики аккаунта (нужна хотя бы одна), all — вся биржа, category_ids требует непустой список. Результат сохраняет полные описания и unknown upstream fields, paging, query fingerprint и watermark, пригодный для будущего delta polling.

Inputs: mode (required), query, cursor, price_to, +5 more. Returns: data, meta, error, summary, +2 more

get_connectsБаланс коннектов KworkA
Read-onlyIdempotent

Получить активные и общие коннекты без изменения аккаунта.

Inputs: no named parameters. Returns: data, meta, error, summary, +2 more

get_dialogСообщения диалога KworkA
Read-onlyIdempotent

Получить полные сообщения диалога по username.

Без page возвращается последняя страница с самыми свежими сообщениями. Страницы нумеруются от начала переписки: более ранние сообщения лежат на page на единицу меньше, page=1 — самое начало.

Inputs: username (required), page. Returns: data, meta, error, summary, +2 more

get_exchange_infoИнформация биржи KworkB
Read-onlyIdempotent

Получить полный стандартный exchangeInfo response через pinned API client.

Inputs: no named parameters. Returns: data, meta, error, summary, +2 more

get_kwork_detailsДетали кворкаC
Read-onlyIdempotent

Получить полный getKworkDetailsExtra response без ложных полей.

Inputs: kwork_id (required). Returns: data, meta, error, summary, +2 more

get_offerДетали оффера KworkC
Read-onlyIdempotent

Получить собственный оффер по offer_id, включая обязательный project_id.

Inputs: offer_id (required). Returns: data, meta, error, summary, +2 more

get_order_detailsДетали заказа KworkB
Read-onlyIdempotent

Получить полную структуру details/stages/tracks заказа без обрезки.

Inputs: order_id (required). Returns: data, meta, error, summary, +2 more

get_projectДетали проекта KworkB
Read-onlyIdempotent

Получить проект по стабильному project_id с полным описанием и raw fields.

Inputs: project_id (required). Returns: data, meta, error, summary, +2 more

get_user_infoПрофиль пользователя KworkA
Read-onlyIdempotent

Получить полный публичный профиль ровно по одному user_id или username.

Inputs: user_id, username. Returns: data, meta, error, summary, +2 more

get_write_statusПолучить состояние записи KworkB
Read-onlyIdempotent

Прочитать durable state и сохранённый результат без remote write.

Inputs: write_id (required). Returns: data, meta, error, summary, +2 more

list_categoriesДерево категорий KworkA
Read-onlyIdempotent

Получить полное трёхуровневое дерево категорий и их ID.

Inputs: no named parameters. Returns: data, meta, error, summary, +2 more

list_dialogsСписок диалогов KworkB
Read-onlyIdempotent

Получить страницу диалогов с полными последними сообщениями.

Inputs: page. Returns: data, meta, error, summary, +2 more

list_favorite_categoriesИзбранные категории KworkB
Read-onlyIdempotent

Получить полный ответ избранных категорий текущего аккаунта.

Inputs: no named parameters. Returns: data, meta, error, summary, +2 more

list_my_kworksСписок моих кворковB
Read-onlyIdempotent

Получить все собственные кворки с status group и полными raw fields.

Inputs: no named parameters. Returns: data, meta, error, summary, +2 more

list_my_offersСписок моих офферов KworkB
Read-onlyIdempotent

Список собственных офферов; каждый элемент гарантирует offer_id и project_id.

Inputs: page. Returns: data, meta, error, summary, +2 more

list_notificationsУведомления KworkB
Read-onlyIdempotent

Получить полные notification groups и вложенные notifications.

Inputs: no named parameters. Returns: data, meta, error, summary, +2 more

list_worker_ordersСписок заказов продавца KworkC
Read-onlyIdempotent

Список заказов продавца через реальный generic workerOrders page contract.

Inputs: page. Returns: data, meta, error, summary, +2 more

prepare_writeПодготовить безопасную запись KworkA
Idempotent

Проверить и сохранить точный Kwork write payload без remote side effect.

Поддерживаемые actions: submit_offer, delete_offer, send_message, edit_message, delete_message, mark_dialog_read, submit_order_approval и set_kwork_state. Перед подготовкой выполняются свежая account binding check и action-specific preflight. Результат содержит payload_hash, TTL и HMAC-derived confirmation_token; в ledger хранится только его hash. Exact replay того же idempotency_key/request возвращает тот же token, пока запись prepared. Другой request с тем же key запрещён.

Inputs: request (required), idempotency_key (required). Returns: data, meta, error, summary, +2 more

reconcile_writeСверить неоднозначную запись KworkA

Read back Kwork state for submission_unknown without resubmitting payload.

Возвращает reconciled_succeeded при найденном точном side effect. Reconciled_absent требует нескольких полных отрицательных наблюдений через visibility interval; до этого остаётся submission_unknown. Remote write не выполняется. Неизвестные состояния (модерация, исчезнувший объект, чужой текст) не считаются доказательством; если сверка не сходится, оператор фиксирует исход через kwork-mcp resolve-write.

Inputs: write_id (required). Returns: data, meta, error, summary, +2 more

search_usersПоиск пользователей KworkB
Read-onlyIdempotent

Искать пользователей Kwork с сохранением полных полей и paging metadata.

Inputs: query (required), page. Returns: data, meta, error, summary, +2 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 22 tools

    Disambiguation4/5

    Most tools target distinct resources and actions, and the list/get pairs (dialogs, offers, kworks, projects) are differentiated by scope and description. Minor potential confusion remains around account_status vs. get_user_info and between several read-oriented list/get pairs, but descriptions generally resolve this.

    Naming Consistency4/5

    The set is predominantly consistent snake_case verb_noun naming: list_*, get_*, prepare_write, commit_write, reconcile_write. account_status is the main exception, and a few names like discover_projects and search_users use different verbs for similar retrieval patterns, but overall readability is high.

    Tool Count3/5

    With 22 tools, the surface is on the heavy side for a single MCP server, even accounting for Kwork's broad domain. The tools mostly earn their place, but there is room to consolidate or hide lower-level read operations.

    Completeness3/5

    Read coverage is broad across orders, dialogs, users, projects, offers, kworks, categories, and notifications, and the write lifecycle is carefully modeled. However, core lifecycle gaps remain, such as creating/editing kwork listings and broader order/payment/review operations.

    Maintenance

    ActivitySlowing
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      MCP server for searching Fiverr gigs, comparing freelancer packages, reading seller reviews, and exploring service categories. Provides structured tools for gig search, details, seller profiles, reviews, and category browsing with built-in anti-bot handling.
      5
      18
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      An MCP server for automating Upwork workflows including job search, proposal submission, client communication, and contract management. It provides tools for client vetting, template-based proposals, and session safety with audit logging.
      MIT
    • F
      license
      Not graded
      quality
      F
      maintenance
      MCP server for the Upwork GraphQL API enabling job search, contract management, proposal drafting, and other Upwork automation tasks via natural language.
      -