ต้นแบบ · รุ่นทดลอง: มีทุก server ในทะเบียนทางการ อัปเดตทุก 30 นาที รีวิวและบัญชีผู้ใช้จะมาในขั้นถัดไป
PopNx MCPที่รวม MCP สำหรับคนใช้ AI · อธิบายเป็นภาษาคน

Kwork

โดย simonetherรุ่น 1.5.2i★ –iรันบนเครื่อง
ชื่อใน registryio.github.simonether/kwork-mcp

ติดตั้ง

ภาพรวม

คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)

Account-bound, typed and durable stdio MCP gateway for the Kwork freelance marketplace

สามเสาของ PopNx MCP

สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน

ใช้ทำอะไรได้

ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก 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

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .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 เว้นว่างไว้ให้คุณใส่เอง

เปิดใน VS Code

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .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_ID env
    Kwork user ID to serve; optional when kwork-mcp login bound a single account, required when several are bound
  • KWORK_EXPECTED_USERNAME env
    Optional second account identity check
  • KWORK_WRITES env
    Sending to Kwork: confirm asks the user before each send (client dialog or chat), auto lets the agent send, off is read-only
  • KWORK_SITE env
    Kwork site: ru (kwork.ru) or com (kwork.com); kwork.com has no project exchange
  • KWORK_TIMEOUT env
    Kwork request timeout in seconds (1-120)
  • KWORK_STATE_DIR env
    Absolute private directory shared by gateway processes for the same account
  • KWORK_PERSIST_TOKEN env
    Use the verified account-scoped credential store; required for normal server startup
  • KWORK_RPS_LIMIT env
    Shared account-level token refill rate
  • KWORK_BURST_LIMIT env
    Shared account-level token bucket capacity
  • KWORK_ROUTE_RPS_LIMIT env
    Shared per-route token refill rate
  • KWORK_ROUTE_BURST_LIMIT env
    Shared per-route token bucket capacity
  • KWORK_RATE_WAIT_TIMEOUT env
    Maximum seconds to wait for shared rate-limit admission
  • KWORK_AUTH_LOCK_TIMEOUT env
    Maximum seconds to wait for account credential-store authentication coordination
  • KWORK_READ_ATTEMPTS env
    Maximum attempts for retry-safe read requests only
  • KWORK_RETRY_BACKOFF_BASE env
    Initial retry backoff for retry-safe reads, in seconds
  • KWORK_RETRY_BACKOFF_MAX env
    Maximum retry backoff for retry-safe reads, in seconds
  • KWORK_CIRCUIT_FAILURE_THRESHOLD env
    Shared route failures before opening the circuit
  • KWORK_CIRCUIT_OPEN_SECONDS env
    Base shared circuit-open interval in seconds
  • KWORK_PREPARATION_TTL_SECONDS env
    Safe write preparation lifetime
  • KWORK_WRITE_LEASE_SECONDS env
    Durable one-writer lease duration in seconds
  • KWORK_RECONCILIATION_MIN_AGE_SECONDS env
    Minimum age before ambiguous-write read-back (1-300 seconds)
  • KWORK_RECONCILIATION_ABSENCE_CONFIRMATIONS env
    Complete absent observations required before a terminal result
  • KWORK_RECONCILIATION_ABSENCE_INTERVAL_SECONDS env
    Minimum interval between absent observations (1-300 seconds)
  • KWORK_STATE_RETENTION_DAYS env
    Retention for terminal durable write records
  • KWORK_LOG_LEVEL env
    Gateway 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

โดย stripe

server ทางการของ Stripe ให้ AI ดูและจัดการลูกค้า สินค้า การชำระเงิน และใบแจ้งหนี้ ต่อผ่านคลาวด์ของ Stripe และล็อกอินแบบ OAuth

รันบนคลาวด์★ 2,043MITอัปเดต 12 เดือนที่ผ่านมา
ติดตั้ง

MCP Cn Commerce

โดย TonyWang-hub

8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending

รันบนเครื่อง★ 96MITอัปเดต 28 วันที่ผ่านมา
ติดตั้ง

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

ถาม PopNx