# Kwork

MCP-сервер Kwork для Claude Code подключает профиль биржи фриланса к агенту. Помогает искать проекты, читать диалоги и готовить отклики.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 у репозитория
- Автор: simonether
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/simonether/kwork-mcp
- Обновлён: 2026-11-15
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/kwork

## Что делает

Сервер связывает ИИ-ассистента с аккаунтом биржи через локальный stdio-транспорт. Инструменты дают агенту возможность просматривать ленту заказов, проверять остаток коннектов, читать входящие сообщения и формировать черновики предложений с нужной ценой и сроком.

Запись данных контролирует переменная `KWORK_WRITES`. В стандартном значении `confirm` агент обязан показать сформированный текст и параметры, отправляя их только после явного одобрения. При значении `off` доступен исключительно режим чтения, а при `auto` агент отправляет ответы самостоятельно.

Для запуска нужны macOS или Linux, Python версии 3.12–3.14 и утилита `uv`. Windows не поддерживается. Логин и пароль запрашиваются однократно командой входа и не хранятся в открытых конфигурационных файлах. Сервер по умолчанию взаимодействует с площадкой kwork.ru, переключение на kwork.com задаётся через флаг `KWORK_SITE=com`.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `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` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env KWORK_EXPECTED_USER_ID=<KWORK_EXPECTED_USER_ID> --env KWORK_EXPECTED_USERNAME=<KWORK_EXPECTED_USERNAME> --env KWORK_WRITES=<KWORK_WRITES> --env KWORK_SITE=<KWORK_SITE> --env KWORK_TIMEOUT=<KWORK_TIMEOUT> --transport stdio kwork -- uvx kwork-mcp
```
Вместо <…> подставьте свои значения. Ещё 20 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from kwork-mcp <команда>

### Codex

**Командой платформы**
```bash
codex mcp add kwork --env KWORK_EXPECTED_USER_ID=<KWORK_EXPECTED_USER_ID> --env KWORK_EXPECTED_USERNAME=<KWORK_EXPECTED_USERNAME> --env KWORK_WRITES=<KWORK_WRITES> --env KWORK_SITE=<KWORK_SITE> --env KWORK_TIMEOUT=<KWORK_TIMEOUT> -- uvx kwork-mcp
```
Вместо <…> подставьте свои значения. Ещё 20 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from kwork-mcp <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "kwork": {
            "command": "uvx",
            "args": [
                "kwork-mcp"
            ],
            "env": {
                "KWORK_EXPECTED_USER_ID": "<KWORK_EXPECTED_USER_ID>",
                "KWORK_EXPECTED_USERNAME": "<KWORK_EXPECTED_USERNAME>",
                "KWORK_WRITES": "<KWORK_WRITES>",
                "KWORK_SITE": "<KWORK_SITE>",
                "KWORK_TIMEOUT": "<KWORK_TIMEOUT>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 20 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from kwork-mcp <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "kwork": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "kwork-mcp"
            ],
            "env": {
                "KWORK_EXPECTED_USER_ID": "<KWORK_EXPECTED_USER_ID>",
                "KWORK_EXPECTED_USERNAME": "<KWORK_EXPECTED_USERNAME>",
                "KWORK_WRITES": "<KWORK_WRITES>",
                "KWORK_SITE": "<KWORK_SITE>",
                "KWORK_TIMEOUT": "<KWORK_TIMEOUT>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 20 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from kwork-mcp <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e KWORK_EXPECTED_USER_ID=<KWORK_EXPECTED_USER_ID> -e KWORK_EXPECTED_USERNAME=<KWORK_EXPECTED_USERNAME> -e KWORK_WRITES=<KWORK_WRITES> -e KWORK_SITE=<KWORK_SITE> -e KWORK_TIMEOUT=<KWORK_TIMEOUT> kwork uvx kwork-mcp
```
Вместо <…> подставьте свои значения. Ещё 20 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from kwork-mcp <команда>

## Когда брать
- находить подходящие заказы на бирже по ключевым словам и бюджету
- составлять проекты откликов с указанием цены и сроков выполнения
- отслеживать входящие непрочитанные сообщения в чатах с заказчиками
- проверять статус активных заказов и остаток свободных коннектов

## Примеры запросов агенту
- Найди свежие заказы по разработке ботов с ценой от 20000 рублей
- Покажи входящие сообщения от заказчиков и подготовь ответы
- Сделай отклик на проект 3257238: 15000 рублей, срок 5 дней

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
