@rephelper/mcp-server

MCP-сервер для REP Helper — позвольте ИИ-агентам управлять деятельностью в сфере недвижимости и объектами для отслеживания квалификации IRS REP (профессионал в сфере недвижимости).

Предварительные требования

Node.js 20+ — скачать
Учетная запись REP Helper Elite — rephelper.ai
API-токен — создайте его в REP Helper → Settings → API Tokens

Быстрый старт

1. Создайте API-токен

В приложении REP Helper перейдите в Settings → API Tokens → Create Token. Предоставьте необходимые разрешения (например, чтение/создание действий, чтение объектов). Скопируйте токен — он отображается только один раз.

2. Настройте ваш ИИ-клиент

Добавьте следующее в конфигурацию MCP вашего клиента:

Claude Desktop — отредактируйте claude_desktop_config.json:

{
  "mcpServers": {
    "rephelper": {
      "command": "npx",
      "args": ["-y", "@rephelper/mcp-server"],
      "env": {
        "REPHELPER_API_TOKEN": "rh_live_your_token_here"
      }
    }
  }
}

Claude Code — отредактируйте .claude/settings.json или используйте команду /mcp:

{
  "mcpServers": {
    "rephelper": {
      "command": "npx",
      "args": ["-y", "@rephelper/mcp-server"],
      "env": {
        "REPHELPER_API_TOKEN": "rh_live_your_token_here"
      }
    }
  }
}

Cursor — отредактируйте .cursor/mcp.json:

{
  "mcpServers": {
    "rephelper": {
      "command": "npx",
      "args": ["-y", "@rephelper/mcp-server"],
      "env": {
        "REPHELPER_API_TOKEN": "rh_live_your_token_here"
      }
    }
  }
}

3. Начните использование

Попросите вашего ИИ-ассистента управлять вашей деятельностью в сфере недвижимости:

"Запиши 2 часа управления недвижимостью для 123 Main St сегодня"

"Покажи мне все мои действия за прошлую неделю"

"Добавь новый объект долгосрочной аренды по адресу 456 Oak Ave, Austin, TX 78701"

Доступные инструменты

Действия (Activities)

Инструмент	Описание
`list_activities`	Список действий с дополнительными фильтрами (объект, диапазон дат, категория)
`get_activity`	Получить одно действие по ID
`create_activity`	Записать новое действие с дополнительными поездками и файлами доказательств
`update_activity`	Обновить существующее действие
`delete_activity`	Мягкое удаление действия (восстанавливаемо в течение 72 часов)

Объекты (Properties)

Инструмент	Описание
`list_properties`	Список объектов с дополнительным фильтром по типу
`get_property`	Получить один объект по ID
`create_property`	Добавить новый объект аренды
`update_property`	Обновить существующий объект
`delete_property`	Мягкое удаление объекта (восстанавливаемо в течение 72 часов)

Категории действий

Management & Operations (Управление и эксплуатация)
Maintenance & Repairs (Обслуживание и ремонт)
Development & Construction (Развитие и строительство)
Acquisition & Brokerage (Приобретение и брокерские услуги)
Administrative & Compliance (Администрирование и соблюдение нормативных требований)

Файлы доказательств

При создании или обновлении действий вы можете прикреплять файлы доказательств из вашей локальной файловой системы:

Поддерживаемые форматы: JPEG, PNG, WebP, PDF
Максимум 3 файла на действие
Максимум 10 МБ на файл

Пример: "Запиши действие по обслуживанию и прикрепи квитанцию из /Users/me/Downloads/receipt.jpg"

Поездки (Trips)

Свяжите до 3 поездок с действием. Время в пути автоматически добавляется к продолжительности действия.

Переменные окружения

Переменная	Обязательно	По умолчанию	Описание
`REPHELPER_API_TOKEN`	Да	—	Ваш API-токен (формат `rh_live_*`)
`REPHELPER_API_URL`	Нет	`https://api.rephelper.ai`	Переопределение базового URL API

Документация API

Интерактивная документация API доступна по адресу api.rephelper.ai/docs.

Спецификация OpenAPI доступна по адресу api.rephelper.ai/openapi.yaml.

Устранение неполадок

"REPHELPER_API_TOKEN environment variable is required"

Убедитесь, что вы добавили блок env в вашу конфигурацию MCP с вашим токеном.

"Token is invalid or not found"

Перепроверьте значение вашего токена. Он должен начинаться с rh_live_.
Токен мог быть отозван — создайте новый в REP Helper.

"Permission denied: Token lacks X permission"

У вашего токена нет необходимого разрешения. Отредактируйте токен в REP Helper → API Tokens, чтобы добавить его.

"API access requires an Elite subscription"

API-токены доступны в плане Elite. Обновите подписку на rephelper.ai.

"Rate limited: Too many requests"

Подождите немного и попробуйте снова. Лимиты: 60 чтений/мин, 30 записей/мин, 5 удалений/мин.

Лицензия

MIT

REP Helper