Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.
Kwork
ภาพรวม
คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)
Account-bound, typed and durable stdio MCP gateway for the Kwork freelance marketplace
สามเสาของ PopNx MCP
สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน
- เสียงผู้ใช้iยังไม่มีรีวิวรีวิวเปิดพร้อมระบบบัญชีในขั้นถัดไป
- ผลตรวจเบื้องต้นของเราiผ่าน 1 จาก 1 ข้อตรวจจากข้อมูลที่เปิดอยู่ ยังไม่ได้สแกนโค้ด
- การใช้งานiยังไม่ได้วัด★ –
ใช้ทำอะไรได้
ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry
- การเชื่อมต่อ: รันบนเครื่อง
- ช่องทาง (transport): stdio
- หมวด: ร้านค้าออนไลน์และรับเงิน
ติดตั้ง
เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง
ก่อนติดตั้ง
- ผลตรวจเบื้องต้น: ผ่าน 1 จาก 1 ข้อ
- รันในเครื่องคุณด้วยสิทธิ์ของผู้ใช้คุณ (ไฟล์ อินเทอร์เน็ต แอปต่าง ๆ)
- ค่าที่คุณต้องใส่เอง:
KWORK_EXPECTED_USER_ID,KWORK_EXPECTED_USERNAME,KWORK_WRITES,KWORK_SITE,KWORK_TIMEOUT,KWORK_STATE_DIR,KWORK_PERSIST_TOKEN,KWORK_RPS_LIMIT,KWORK_BURST_LIMIT,KWORK_ROUTE_RPS_LIMIT,KWORK_ROUTE_BURST_LIMIT,KWORK_RATE_WAIT_TIMEOUT,KWORK_AUTH_LOCK_TIMEOUT,KWORK_READ_ATTEMPTS,KWORK_RETRY_BACKOFF_BASE,KWORK_RETRY_BACKOFF_MAX,KWORK_CIRCUIT_FAILURE_THRESHOLD,KWORK_CIRCUIT_OPEN_SECONDS,KWORK_PREPARATION_TTL_SECONDS,KWORK_WRITE_LEASE_SECONDS,KWORK_RECONCILIATION_MIN_AGE_SECONDS,KWORK_RECONCILIATION_ABSENCE_CONFIRMATIONS,KWORK_RECONCILIATION_ABSENCE_INTERVAL_SECONDS,KWORK_STATE_RETENTION_DAYS,KWORK_LOG_LEVEL
ต้องเตรียมก่อน
- PyPIติดตั้ง uv ของ Python (มีคำสั่ง uvx) ในเครื่อง
คุณใช้แอปไหน
เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”
เปิด Claude Desktop → Settings → Developer → Edit Config แล้ววางค่านี้ในไฟล์ claude_desktop_config.json
{
"mcpServers": {
"kwork": {
"command": "uvx",
"args": [
"kwork-mcp"
],
"env": {
"KWORK_EXPECTED_USER_ID": "ใส่ค่าของคุณ",
"KWORK_EXPECTED_USERNAME": "ใส่ค่าของคุณ",
"KWORK_WRITES": "ใส่ค่าของคุณ",
"KWORK_SITE": "ใส่ค่าของคุณ",
"KWORK_TIMEOUT": "ใส่ค่าของคุณ",
"KWORK_STATE_DIR": "ใส่ค่าของคุณ",
"KWORK_PERSIST_TOKEN": "ใส่ค่าของคุณ",
"KWORK_RPS_LIMIT": "ใส่ค่าของคุณ",
"KWORK_BURST_LIMIT": "ใส่ค่าของคุณ",
"KWORK_ROUTE_RPS_LIMIT": "ใส่ค่าของคุณ",
"KWORK_ROUTE_BURST_LIMIT": "ใส่ค่าของคุณ",
"KWORK_RATE_WAIT_TIMEOUT": "ใส่ค่าของคุณ",
"KWORK_AUTH_LOCK_TIMEOUT": "ใส่ค่าของคุณ",
"KWORK_READ_ATTEMPTS": "ใส่ค่าของคุณ",
"KWORK_RETRY_BACKOFF_BASE": "ใส่ค่าของคุณ",
"KWORK_RETRY_BACKOFF_MAX": "ใส่ค่าของคุณ",
"KWORK_CIRCUIT_FAILURE_THRESHOLD": "ใส่ค่าของคุณ",
"KWORK_CIRCUIT_OPEN_SECONDS": "ใส่ค่าของคุณ",
"KWORK_PREPARATION_TTL_SECONDS": "ใส่ค่าของคุณ",
"KWORK_WRITE_LEASE_SECONDS": "ใส่ค่าของคุณ",
"KWORK_RECONCILIATION_MIN_AGE_SECONDS": "ใส่ค่าของคุณ",
"KWORK_RECONCILIATION_ABSENCE_CONFIRMATIONS": "ใส่ค่าของคุณ",
"KWORK_RECONCILIATION_ABSENCE_INTERVAL_SECONDS": "ใส่ค่าของคุณ",
"KWORK_STATE_RETENTION_DAYS": "ใส่ค่าของคุณ",
"KWORK_LOG_LEVEL": "ใส่ค่าของคุณ"
}
}
}
}พิมพ์คำสั่งนี้ใน Terminal
claude mcp add kwork --env KWORK_EXPECTED_USER_ID='ใส่ค่าของคุณ' --env KWORK_EXPECTED_USERNAME='ใส่ค่าของคุณ' --env KWORK_WRITES='ใส่ค่าของคุณ' --env KWORK_SITE='ใส่ค่าของคุณ' --env KWORK_TIMEOUT='ใส่ค่าของคุณ' --env KWORK_STATE_DIR='ใส่ค่าของคุณ' --env KWORK_PERSIST_TOKEN='ใส่ค่าของคุณ' --env KWORK_RPS_LIMIT='ใส่ค่าของคุณ' --env KWORK_BURST_LIMIT='ใส่ค่าของคุณ' --env KWORK_ROUTE_RPS_LIMIT='ใส่ค่าของคุณ' --env KWORK_ROUTE_BURST_LIMIT='ใส่ค่าของคุณ' --env KWORK_RATE_WAIT_TIMEOUT='ใส่ค่าของคุณ' --env KWORK_AUTH_LOCK_TIMEOUT='ใส่ค่าของคุณ' --env KWORK_READ_ATTEMPTS='ใส่ค่าของคุณ' --env KWORK_RETRY_BACKOFF_BASE='ใส่ค่าของคุณ' --env KWORK_RETRY_BACKOFF_MAX='ใส่ค่าของคุณ' --env KWORK_CIRCUIT_FAILURE_THRESHOLD='ใส่ค่าของคุณ' --env KWORK_CIRCUIT_OPEN_SECONDS='ใส่ค่าของคุณ' --env KWORK_PREPARATION_TTL_SECONDS='ใส่ค่าของคุณ' --env KWORK_WRITE_LEASE_SECONDS='ใส่ค่าของคุณ' --env KWORK_RECONCILIATION_MIN_AGE_SECONDS='ใส่ค่าของคุณ' --env KWORK_RECONCILIATION_ABSENCE_CONFIRMATIONS='ใส่ค่าของคุณ' --env KWORK_RECONCILIATION_ABSENCE_INTERVAL_SECONDS='ใส่ค่าของคุณ' --env KWORK_STATE_RETENTION_DAYS='ใส่ค่าของคุณ' --env KWORK_LOG_LEVEL='ใส่ค่าของคุณ' -- uvx kwork-mcpเติมค่าที่เว้นว่างไว้ก่อนรัน
หรือคัดลอกค่าตั้งเอง
วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json
{
"mcpServers": {
"kwork": {
"command": "uvx",
"args": [
"kwork-mcp"
],
"env": {
"KWORK_EXPECTED_USER_ID": "ใส่ค่าของคุณ",
"KWORK_EXPECTED_USERNAME": "ใส่ค่าของคุณ",
"KWORK_WRITES": "ใส่ค่าของคุณ",
"KWORK_SITE": "ใส่ค่าของคุณ",
"KWORK_TIMEOUT": "ใส่ค่าของคุณ",
"KWORK_STATE_DIR": "ใส่ค่าของคุณ",
"KWORK_PERSIST_TOKEN": "ใส่ค่าของคุณ",
"KWORK_RPS_LIMIT": "ใส่ค่าของคุณ",
"KWORK_BURST_LIMIT": "ใส่ค่าของคุณ",
"KWORK_ROUTE_RPS_LIMIT": "ใส่ค่าของคุณ",
"KWORK_ROUTE_BURST_LIMIT": "ใส่ค่าของคุณ",
"KWORK_RATE_WAIT_TIMEOUT": "ใส่ค่าของคุณ",
"KWORK_AUTH_LOCK_TIMEOUT": "ใส่ค่าของคุณ",
"KWORK_READ_ATTEMPTS": "ใส่ค่าของคุณ",
"KWORK_RETRY_BACKOFF_BASE": "ใส่ค่าของคุณ",
"KWORK_RETRY_BACKOFF_MAX": "ใส่ค่าของคุณ",
"KWORK_CIRCUIT_FAILURE_THRESHOLD": "ใส่ค่าของคุณ",
"KWORK_CIRCUIT_OPEN_SECONDS": "ใส่ค่าของคุณ",
"KWORK_PREPARATION_TTL_SECONDS": "ใส่ค่าของคุณ",
"KWORK_WRITE_LEASE_SECONDS": "ใส่ค่าของคุณ",
"KWORK_RECONCILIATION_MIN_AGE_SECONDS": "ใส่ค่าของคุณ",
"KWORK_RECONCILIATION_ABSENCE_CONFIRMATIONS": "ใส่ค่าของคุณ",
"KWORK_RECONCILIATION_ABSENCE_INTERVAL_SECONDS": "ใส่ค่าของคุณ",
"KWORK_STATE_RETENTION_DAYS": "ใส่ค่าของคุณ",
"KWORK_LOG_LEVEL": "ใส่ค่าของคุณ"
}
}
}
}เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง
หรือคัดลอกค่าตั้งเอง
วางในไฟล์ .vscode/mcp.json ของโปรเจกต์
{
"servers": {
"kwork": {
"type": "stdio",
"command": "uvx",
"args": [
"kwork-mcp"
],
"env": {
"KWORK_EXPECTED_USER_ID": "ใส่ค่าของคุณ",
"KWORK_EXPECTED_USERNAME": "ใส่ค่าของคุณ",
"KWORK_WRITES": "ใส่ค่าของคุณ",
"KWORK_SITE": "ใส่ค่าของคุณ",
"KWORK_TIMEOUT": "ใส่ค่าของคุณ",
"KWORK_STATE_DIR": "ใส่ค่าของคุณ",
"KWORK_PERSIST_TOKEN": "ใส่ค่าของคุณ",
"KWORK_RPS_LIMIT": "ใส่ค่าของคุณ",
"KWORK_BURST_LIMIT": "ใส่ค่าของคุณ",
"KWORK_ROUTE_RPS_LIMIT": "ใส่ค่าของคุณ",
"KWORK_ROUTE_BURST_LIMIT": "ใส่ค่าของคุณ",
"KWORK_RATE_WAIT_TIMEOUT": "ใส่ค่าของคุณ",
"KWORK_AUTH_LOCK_TIMEOUT": "ใส่ค่าของคุณ",
"KWORK_READ_ATTEMPTS": "ใส่ค่าของคุณ",
"KWORK_RETRY_BACKOFF_BASE": "ใส่ค่าของคุณ",
"KWORK_RETRY_BACKOFF_MAX": "ใส่ค่าของคุณ",
"KWORK_CIRCUIT_FAILURE_THRESHOLD": "ใส่ค่าของคุณ",
"KWORK_CIRCUIT_OPEN_SECONDS": "ใส่ค่าของคุณ",
"KWORK_PREPARATION_TTL_SECONDS": "ใส่ค่าของคุณ",
"KWORK_WRITE_LEASE_SECONDS": "ใส่ค่าของคุณ",
"KWORK_RECONCILIATION_MIN_AGE_SECONDS": "ใส่ค่าของคุณ",
"KWORK_RECONCILIATION_ABSENCE_CONFIRMATIONS": "ใส่ค่าของคุณ",
"KWORK_RECONCILIATION_ABSENCE_INTERVAL_SECONDS": "ใส่ค่าของคุณ",
"KWORK_STATE_RETENTION_DAYS": "ใส่ค่าของคุณ",
"KWORK_LOG_LEVEL": "ใส่ค่าของคุณ"
}
}
}
}เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง
ตัวนี้รันในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะ server บนอินเทอร์เน็ต ลองเลือกแอปอื่น
ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี
ค่าที่ต้องใส่เอง
KWORK_EXPECTED_USER_IDenvKwork user ID to serve; optional when kwork-mcp login bound a single account, required when several are boundKWORK_EXPECTED_USERNAMEenvOptional second account identity checkKWORK_WRITESenvSending to Kwork: confirm asks the user before each send (client dialog or chat), auto lets the agent send, off is read-onlyKWORK_SITEenvKwork site: ru (kwork.ru) or com (kwork.com); kwork.com has no project exchangeKWORK_TIMEOUTenvKwork request timeout in seconds (1-120)KWORK_STATE_DIRenvAbsolute private directory shared by gateway processes for the same accountKWORK_PERSIST_TOKENenvUse the verified account-scoped credential store; required for normal server startupKWORK_RPS_LIMITenvShared account-level token refill rateKWORK_BURST_LIMITenvShared account-level token bucket capacityKWORK_ROUTE_RPS_LIMITenvShared per-route token refill rateKWORK_ROUTE_BURST_LIMITenvShared per-route token bucket capacityKWORK_RATE_WAIT_TIMEOUTenvMaximum seconds to wait for shared rate-limit admissionKWORK_AUTH_LOCK_TIMEOUTenvMaximum seconds to wait for account credential-store authentication coordinationKWORK_READ_ATTEMPTSenvMaximum attempts for retry-safe read requests onlyKWORK_RETRY_BACKOFF_BASEenvInitial retry backoff for retry-safe reads, in secondsKWORK_RETRY_BACKOFF_MAXenvMaximum retry backoff for retry-safe reads, in secondsKWORK_CIRCUIT_FAILURE_THRESHOLDenvShared route failures before opening the circuitKWORK_CIRCUIT_OPEN_SECONDSenvBase shared circuit-open interval in secondsKWORK_PREPARATION_TTL_SECONDSenvSafe write preparation lifetimeKWORK_WRITE_LEASE_SECONDSenvDurable one-writer lease duration in secondsKWORK_RECONCILIATION_MIN_AGE_SECONDSenvMinimum age before ambiguous-write read-back (1-300 seconds)KWORK_RECONCILIATION_ABSENCE_CONFIRMATIONSenvComplete absent observations required before a terminal resultKWORK_RECONCILIATION_ABSENCE_INTERVAL_SECONDSenvMinimum interval between absent observations (1-300 seconds)KWORK_STATE_RETENTION_DAYSenvRetention for terminal durable write recordsKWORK_LOG_LEVELenvGateway stderr log level: DEBUG, INFO, WARNING or ERROR
ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
ทำอะไรได้บ้าง
รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง
ผลตรวจเบื้องต้นi
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 8 พ.ย. 2569
- ✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันด้วยบัญชี GitHub simonether ซึ่งเป็นเจ้าของ repo
- … ยังไม่ตรวจ
ยังมีคนดูแล
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
- … ยังไม่ตรวจ
มีสัญญาอนุญาต (license)
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
- – ไม่เกี่ยว
endpoint ตอบ
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
- – ไม่เกี่ยว
ล็อกอินแบบ OAuth
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
- … ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต
เทียบกับตัวอื่นในหมวด ร้านค้าออนไลน์และรับเงินi
- ดาวมากกว่า 0% ของอีก 2550 ตัวในหมวดนี้
- ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 46% ของอีก 2550 ตัวในหมวดนี้
- ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 100% ของอีก 2550 ตัวในหมวดนี้
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
คำถามที่พบบ่อย
Kwork ปลอดภัยไหม?
จากการตรวจเบื้องต้นของเรา ผ่าน 1 จาก 1 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
ต้องใช้กุญแจหรือรหัสอะไรบ้าง?
registry ไม่ได้ระบุว่าต้องใช้กุญแจ แต่บางตัวจะขอให้ล็อกอินตอนใช้ครั้งแรก
ตัวนี้รันบนเครื่องหรือบนคลาวด์?
รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)
ยังมีคนดูแลอยู่ไหม?
repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (1.5.2) เข้า registry 35 วันที่ผ่านมา
ใช้กับโปรแกรมไหนได้บ้าง?
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Python (uv) ในเครื่องด้วย
มีตัวไหนใช้แทนได้บ้าง?
ในหมวดเดียวกันมี Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce
ตัวที่ใช้แทนได้
server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว
อ่านการ์ด:★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi
Stripe MCP
server ทางการของ Stripe ให้ AI ดูและจัดการลูกค้า สินค้า การชำระเงิน และใบแจ้งหนี้ ต่อผ่านคลาวด์ของ Stripe และล็อกอินแบบ OAuth
MCP Cn Commerce
8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending
README จากผู้ทำ
เปิดอ่าน README
ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ
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
Cursor:
Claude Desktop и другие клиенты
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 |
| Непонятно, какой аккаунт и сайт использует сервер | 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 succeeded # операция на Kwork прошла uvx kwork-mcp@1.5.2 resolve-write 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