REP Helper

@rephelper/mcp-server

REP Helper 用の MCP サーバーです。AI エージェントが不動産活動や物件を管理し、IRS REP（Real Estate Professional）資格の要件を満たすための記録を行えます。

前提条件

• Node.js 20+ — ダウンロード
• REP Helper Elite アカウント — rephelper.ai
• API トークン — REP Helper → Settings → API Tokens で作成します

クイックスタート

1. API トークンを作成する

REP Helper アプリで、Settings → API Tokens → Create Token に進みます。必要な権限（例：活動の読み取り／作成、物件の読み取り）を付与します。トークンをコピーしてください。トークンが表示されるのは一度だけです。

2. AI クライアントを設定する

以下をクライアントの 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"
      }
    }
  }
}

Gemini CLI — ~/.gemini/settings.json を編集します。

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

Windsurf — .windsurf/mcp.json を編集します。

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

3. 使用を開始する

AI アシスタントに不動産活動の管理を依頼します。

「今日、123 Main St の物件管理を2時間行ったと記録して」

「先週の活動をすべて表示して」

「456 Oak Ave, Austin, TX 78701 に長期賃貸物件を追加して」

利用可能なツール

活動

ツール	説明
list_activities	任意のフィルター（物件、期間、カテゴリー）を指定して活動を一覧表示します
get_activity	ID を指定して単一の活動を取得します
create_activity	任意で移動情報や証拠ファイルを添付して、新しい活動を記録します
update_activity	既存の活動を更新します
delete_activity	活動を論理削除します（72時間以内であれば復元可能です）

物件

ツール	説明
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
• 1つの活動につき最大3ファイル
• 1ファイルあたり最大10MB

例：「メンテナンス活動を記録して、/Users/me/Downloads/receipt.jpg の領収書を添付して」

移動

1つの活動に最大3件の移動を関連付けられます。移動にかかった時間は、活動時間に自動的に加算されます。

環境変数

変数	必須	デフォルト	説明
REPHELPER_API_TOKEN	はい	—	API トークン（rh_live_* 形式）
REPHELPER_API_URL	いいえ	https://api.rephelper.ai	API ベース URL の上書き

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