Kwork freelance hesabınızı projeleri aramak, diyalogları yönetmek ve yanıtlar veya teklifler hazırlamak için AI agent'larına bağlar.
Ayrıca bilinen adı simonether/kwork-mcp, kwork-mcp
- Yıldızlar
- 6
- Araçlar
- —
- İndirmeler, 30 gün
- 482
- En son sürüm
- 1.5.2
- Son commit
- 14 Kas 2026
- Lisans
- MIT
Kwork MCP nedir?
Kwork bir MCP sunucusudur. Kwork freelance hesabınızı projeleri aramak, diyalogları yönetmek ve yanıtlar veya teklifler hazırlamak için AI agent'larına bağlar.
Özet, projenin README dosyasından oluşturuldu
Kwork MCP sunucusu hakkında
Kwork kullanan freelancerlar, günlük iş akışlarının büyük bir kısmını otomatikleştirmek için hesaplarını Claude Desktop, Cursor veya Claude Code gibi AI agent'larına bağlayabilirler. Bu MCP server, bir agent'ın yeni projeleri aramasına, okunmamış mesajları izlemesine, sipariş durumlarını kontrol etmesine ve bağlantıları yönetmesine olanak tanır. macOS veya Linux üzerinde uv aracılığıyla Python 3.12 ile 3.14 arası sürümleri çalıştıran kullanıcılar için tasarlanmıştır.
Kullanıcılar, platformla etkileşime geçmek için agent'tan belirli bir bütçe dahilindeki Telegram bot projeleri gibi spesifik işleri bulmasını veya müşteri diyaloglarına yanıt taslakları hazırlamasını isteyebilirler. Server, teklif veya mesaj gönderme gibi eylemlerin varsayılan olarak açık kullanıcı onayı gerektirdiği bir güvenlik mekanizması içerir. KWORK_WRITES değişkenini kullanarak manuel onay, otomatik gönderim veya salt okunur mod arasında seçim yaparak otonomi seviyesini yapılandırabilirsiniz.
Kurulum, şifreleri istemci yapılandırmalarında saklamadan, yerel makinenizde bir token'ı güvenli bir şekilde depolayan tek seferlik bir giriş komutu içerir. Server hem kwork.ru hem de kwork.com adreslerini destekleyerek freelance işinizin tek bir yapay zeka destekli arayüz üzerinden düzenli kalmasını sağlar.
Neler yapabilirsiniz
- 1Hedef odaklı freelance projeler bulunAgent'tan 20.000 ₽ üzerindeki bütçeye sahip güncel Telegram bot projelerini bulmasını isteyin.
- 2Müşteri iletişimini yönetinOkunmamış mesajların özetini isteyin ve agent'tan uygun yanıtlar önermesini talep edin.
- 3Proje teklifleri taslaklayın ve gönderinBelirli bir proje ID'si için agent'ın özel bir yanıt hazırlamasını sağlayın ve metni onayladıktan sonra gönderilmesini isteyin.
- 4Hesap ve sipariş durumunu izleyinMevcut bağlantı bakiyenizi kontrol edin ve hangi siparişlerin acil dikkat gerektirdiğini görün.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Kwork MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleKwork MCP'yi Claude Code içine yükleyin
$ claude mcp add kwork-mcp -- uvx kwork-mcpKwork MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"kwork-mcp": {
"command": "uvx",
"args": [
"kwork-mcp"
]
}
}
}Kwork MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"kwork-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"kwork-mcp"
]
}
}
}Kwork MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"kwork-mcp","type":"stdio","command":"uvx","args":["kwork-mcp"]}'Kwork MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"kwork-mcp": {
"command": "uvx",
"args": [
"kwork-mcp"
]
}
}
}Kwork MCP'yi Codex içine yükleyin
$ codex mcp add kwork-mcp -- uvx kwork-mcpKwork MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.kwork-mcp] command = "uvx" args = ["kwork-mcp"]
Kwork MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user kwork-mcp uvx -- kwork-mcpKwork MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"kwork-mcp": {
"command": "uvx",
"args": [
"kwork-mcp"
]
}
}
}Yapılandırma
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
| Ad | Açıklama | Sunucu |
|---|---|---|
| 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 |
Otomatik kontroller
Çalıştırıldı 13 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirGeçti
- Açık kaynak lisansı (OSI)Geçti
- Son bir yıl içinde commit veya sürüm mevcutGeçti
- Paket adı popüler bir pakete yakın değilGeçti
- Uzak uç nokta HTTPS kullanıyorKontrol edilmedi
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Modele yönelik gizli talimat yokGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokGeçti
kwork-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 soruları
Kwork MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add kwork-mcp -- uvx kwork-mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Kwork MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Kwork hesabıma nasıl giriş yaparım?
Terminalinizde uvx kwork-mcp@1.5.2 login komutunu çalıştırın. Sistem, giriş bilgilerinizi ve şifrenizi güvenli bir şekilde isteyecektir.
AI agent otomatik olarak mesaj veya teklif gönderebilir mi?
Evet, otomatik gönderim için KWORK_WRITES değişkenini 'auto', onayınızı beklemek için 'confirm' (varsayılan) veya sadece okuma erişimi için 'off' olarak yapılandırabilirsiniz.