Verbindet dein Kwork Freelancer-Konto mit KI-Agenten, um nach Projekten zu suchen, Dialoge zu verwalten und Antworten oder Angebote vorzubereiten.
Auch bekannt als simonether/kwork-mcp, kwork-mcp
- Stars
- 6
- Tools
- —
- Downloads, 30 Tage
- 482
- Neueste Version
- 1.5.2
- Letzter Commit
- 14. Nov. 2026
- Lizenz
- MIT
Was ist Kwork MCP?
Kwork ist ein MCP server. Verbindet dein Kwork Freelancer-Konto mit KI-Agenten, um nach Projekten zu suchen, Dialoge zu verwalten und Antworten oder Angebote vorzubereiten.
Zusammenfassung generiert aus dem README des Projekts
Über Kwork MCP server
Freelancer auf Kwork können ihre Konten mit KI-Agenten wie Claude Desktop, Cursor oder Claude Code verbinden, um einen Großteil ihres täglichen Workflows zu automatisieren. Dieser Server ermöglicht es einem Agenten, nach neuen Projekten zu suchen, ungelesene Nachrichten zu überwachen, den Status von Aufträgen zu prüfen und Kontakte zu verwalten. Er ist für macOS- oder Linux-Nutzer konzipiert, die Python 3.12 bis 3.14 mit uv verwenden.
Nutzer interagieren mit der Plattform, indem sie den Agenten bitten, nach spezifischen Jobs zu suchen – zum Beispiel nach Telegram-Bot-Projekten innerhalb eines bestimmten Budgets – oder Entwürfe für Antworten in Client-Dialogen zu erstellen. Der Server enthält einen Sicherheitsmechanismus, bei dem Aktionen wie das Versenden von Angeboten oder Nachrichten standardmäßig eine explizite Bestätigung durch den Nutzer erfordern. Du kannst den Autonomiegrad über die Variable KWORK_WRITES konfigurieren und zwischen manueller Bestätigung, automatischem Versand oder Read-only-Modus wählen.
Die Einrichtung erfolgt über einen einmaligen Login-Befehl, der ein Token sicher auf deinem lokalen Rechner speichert, ohne Passwörter in den Client-Konfigurationen zu hinterlegen. Der Server unterstützt sowohl kwork.ru als auch kwork.com und stellt sicher, dass dein Freelance-Business über eine einzige KI-gestützte Schnittstelle organisiert bleibt.
Was du damit machen kannst
- 1Gezielt Freelance-Projekte findenBitte den Agenten, nach aktuellen Telegram-Bot-Projekten mit einem Budget von über 20.000 ₽ zu suchen.
- 2Client-Kommunikation verwaltenFordere eine Zusammenfassung ungelesener Nachrichten an und lass dir vom Agenten passende Antwortvorschläge erstellen.
- 3Projektangebote entwerfen und versendenLass den Agenten eine spezifische Antwort für eine Projekt-ID vorbereiten und versende sie, nachdem du den Text freigegeben hast.
- 4Konto- und Auftragsstatus überwachenPrüfe dein aktuelles Guthaben für Verbindungen und sieh nach, welche Aufträge deine sofortige Aufmerksamkeit erfordern.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Kwork MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenKwork MCP in Claude Code installieren
$ claude mcp add kwork-mcp -- uvx kwork-mcpKwork MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"kwork-mcp": {
"command": "uvx",
"args": [
"kwork-mcp"
]
}
}
}Kwork MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"kwork-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"kwork-mcp"
]
}
}
}Kwork MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"kwork-mcp","type":"stdio","command":"uvx","args":["kwork-mcp"]}'Kwork MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"kwork-mcp": {
"command": "uvx",
"args": [
"kwork-mcp"
]
}
}
}Kwork MCP in Codex installieren
$ codex mcp add kwork-mcp -- uvx kwork-mcpKwork MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.kwork-mcp] command = "uvx" args = ["kwork-mcp"]
Kwork MCP in Gemini CLI installieren
$ gemini mcp add -s user kwork-mcp uvx -- kwork-mcpKwork MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"kwork-mcp": {
"command": "uvx",
"args": [
"kwork-mcp"
]
}
}
}Konfiguration
KWORK_AUTH_LOCK_TIMEOUTMaximum seconds to wait for account credential-store authentication coordination
KWORK_BURST_LIMITShared account-level token bucket capacity
KWORK_CIRCUIT_FAILURE_THRESHOLDShared route failures before opening the circuit
KWORK_CIRCUIT_OPEN_SECONDSBase shared circuit-open interval in seconds
KWORK_EXPECTED_USERNAMEOptional second account identity check
KWORK_EXPECTED_USER_IDKwork user ID to serve; optional when kwork-mcp login bound a single account, required when several are bound
KWORK_LOG_LEVELGateway stderr log level: DEBUG, INFO, WARNING or ERROR
KWORK_PERSIST_TOKENUse the verified account-scoped credential store; required for normal server startup
KWORK_PREPARATION_TTL_SECONDSSafe write preparation lifetime
KWORK_RATE_WAIT_TIMEOUTMaximum seconds to wait for shared rate-limit admission
KWORK_READ_ATTEMPTSMaximum attempts for retry-safe read requests only
KWORK_RECONCILIATION_ABSENCE_CONFIRMATIONSComplete absent observations required before a terminal result
KWORK_RECONCILIATION_ABSENCE_INTERVAL_SECONDSMinimum interval between absent observations (1-300 seconds)
KWORK_RECONCILIATION_MIN_AGE_SECONDSMinimum age before ambiguous-write read-back (1-300 seconds)
KWORK_RETRY_BACKOFF_BASEInitial retry backoff for retry-safe reads, in seconds
KWORK_RETRY_BACKOFF_MAXMaximum retry backoff for retry-safe reads, in seconds
KWORK_ROUTE_BURST_LIMITShared per-route token bucket capacity
KWORK_ROUTE_RPS_LIMITShared per-route token refill rate
KWORK_RPS_LIMITShared account-level token refill rate
KWORK_SITEKwork site: ru (kwork.ru) or com (kwork.com); kwork.com has no project exchange
KWORK_STATE_DIRAbsolute private directory shared by gateway processes for the same account
KWORK_STATE_RETENTION_DAYSRetention for terminal durable write records
KWORK_TIMEOUTKwork request timeout in seconds (1-120)
KWORK_WRITESSending to Kwork: confirm asks the user before each send (client dialog or chat), auto lets the agent send, off is read-only
KWORK_WRITE_LEASE_SECONDSDurable one-writer lease duration in seconds
| Name | Beschreibung | Typ |
|---|---|---|
| KWORK_AUTH_LOCK_TIMEOUT | Maximum seconds to wait for account credential-store authentication coordination | |
| KWORK_BURST_LIMIT | Shared account-level token bucket capacity | |
| KWORK_CIRCUIT_FAILURE_THRESHOLD | Shared route failures before opening the circuit | |
| KWORK_CIRCUIT_OPEN_SECONDS | Base shared circuit-open interval in seconds | |
| KWORK_EXPECTED_USERNAME | Optional second account identity check | |
| KWORK_EXPECTED_USER_ID | Kwork user ID to serve; optional when kwork-mcp login bound a single account, required when several are bound | |
| KWORK_LOG_LEVEL | Gateway stderr log level: DEBUG, INFO, WARNING or ERROR | |
| KWORK_PERSIST_TOKEN | Use the verified account-scoped credential store; required for normal server startup | |
| KWORK_PREPARATION_TTL_SECONDS | Safe write preparation lifetime | |
| KWORK_RATE_WAIT_TIMEOUT | Maximum seconds to wait for shared rate-limit admission | |
| KWORK_READ_ATTEMPTS | Maximum attempts for retry-safe read requests only | |
| KWORK_RECONCILIATION_ABSENCE_CONFIRMATIONS | Complete absent observations required before a terminal result | |
| KWORK_RECONCILIATION_ABSENCE_INTERVAL_SECONDS | Minimum interval between absent observations (1-300 seconds) | |
| KWORK_RECONCILIATION_MIN_AGE_SECONDS | Minimum age before ambiguous-write read-back (1-300 seconds) | |
| KWORK_RETRY_BACKOFF_BASE | Initial retry backoff for retry-safe reads, in seconds | |
| KWORK_RETRY_BACKOFF_MAX | Maximum retry backoff for retry-safe reads, in seconds | |
| KWORK_ROUTE_BURST_LIMIT | Shared per-route token bucket capacity | |
| KWORK_ROUTE_RPS_LIMIT | Shared per-route token refill rate | |
| KWORK_RPS_LIMIT | Shared account-level token refill rate | |
| KWORK_SITE | Kwork site: ru (kwork.ru) or com (kwork.com); kwork.com has no project exchange | |
| KWORK_STATE_DIR | Absolute private directory shared by gateway processes for the same account | |
| KWORK_STATE_RETENTION_DAYS | Retention for terminal durable write records | |
| KWORK_TIMEOUT | Kwork request timeout in seconds (1-120) | |
| KWORK_WRITES | Sending to Kwork: confirm asks the user before each send (client dialog or chat), auto lets the agent send, off is read-only | |
| KWORK_WRITE_LEASE_SECONDS | Durable one-writer lease duration in seconds |
Automatisierte Checks
Geluften am 13. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarBestanden
- Open Source Lizenz (OSI)Bestanden
- Commit oder Release im letzten JahrBestanden
- Package-Name ähnelt keinem populären PackageBestanden
- Remote Endpoint nutzt HTTPSNicht geprüft
- Destruktive Tools sind markiertNicht geprüft
- Keine versteckten Anweisungen an das ModellBestanden
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenBestanden
README
Auf GitHub ansehenkwork-mcp подключает ваш аккаунт Kwork к ИИ-агенту: Claude
Code, Claude Desktop, Codex, Cursor и другим MCP-клиентам. Агент ищет проекты на
бирже, читает диалоги, заказы и офферы, готовит отклики. По умолчанию агент
отправляет что-то на Kwork только после вашего «да» на точный текст.
Сайт проекта: simonether.github.io/kwork-mcp.
Что можно попросить у агента
- «Найди свежие проекты про Telegram-ботов с бюджетом от 20 000 ₽ и скажи, какие мне подходят».
- «Покажи диалоги с непрочитанными сообщениями и предложи ответы».
- «Что с моими заказами? Где что-то ждёт моих действий?»
- «Сколько у меня коннектов и какие мои отклики ещё висят?»
- «Подготовь отклик на проект 3257238: 15 000 ₽, 5 дней» — агент покажет точный текст и цену и отправит только после вашего «да».
Быстрый старт
Нужны 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
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.
Лицензия
Kwork MCP Fragen
Wie füge ich Kwork MCP zu Claude Code hinzu?
Führe claude mcp add kwork-mcp -- uvx kwork-mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Kwork MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Wie logge ich mich in mein Kwork-Konto ein?
Führe den Befehl uvx kwork-mcp@1.5.2 login in deinem Terminal aus. Du wirst sicher nach deinem Login und Passwort gefragt.
Kann der KI-Agent Nachrichten oder Angebote automatisch versenden?
Ja, du kannst die Variable KWORK_WRITES auf 'auto' für den automatischen Versand, 'confirm' (Standard) für deine manuelle Bestätigung oder 'off' für reinen Lesezugriff konfigurieren.