@rephelper/mcp-server

REP Helper 用のMCPサーバー — AIエージェントに不動産活動や物件を管理させ、IRSのREP（不動産専門家）資格の追跡を行いましょう。

前提条件

• Node.js 20+ — ダウンロード

• REP Helper Eliteアカウント — rephelper.ai

• APIトークン — REP Helperの「設定」→「APIトークン」から作成してください

クイックスタート

1. APIトークンの作成

REP Helperアプリで、「設定」→「APIトークン」→「トークンを作成」に移動します。必要な権限（例：活動の読み取り/作成、物件の読み取り）を付与します。トークンをコピーしてください（一度しか表示されません）。

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"
      }
    }
  }
}

3. 利用開始

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

"今日、123 Main Stの物件管理に2時間記録して"

"先週の活動をすべて見せて"

"456 Oak Ave, Austin, TX 78701 に新しい長期賃貸物件を追加して"

利用可能なツール

活動 (Activities)

物件 (Properties)

活動カテゴリ

• Management & Operations (管理・運営)

• Maintenance & Repairs (保守・修理)

• Development & Construction (開発・建設)

• Acquisition & Brokerage (取得・仲介)

• Administrative & Compliance (管理・コンプライアンス)

証拠ファイル

活動の作成や更新時に、ローカルファイルシステムから証拠ファイルを添付できます：

• 対応フォーマット: JPEG, PNG, WebP, PDF

• 1活動につき最大3ファイルまで

• 1ファイルにつき最大10MBまで

例: "保守活動を記録して、/Users/me/Downloads/receipt.jpg の領収書を添付して"

移動 (Trips)

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

環境変数

APIドキュメント

インタラクティブなAPIドキュメントは api.rephelper.ai/docs で確認できます。

OpenAPI仕様は api.rephelper.ai/openapi.yaml で公開されています。

トラブルシューティング

"REPHELPER_API_TOKEN environment variable is required"

• MCP設定の env ブロックにトークンを追加したか確認してください。

"Token is invalid or not found"

• トークンの値を確認してください。rh_live_ で始まる必要があります。

• トークンが無効化されている可能性があります。REP Helperで新しく作成してください。

"Permission denied: Token lacks X permission"

• トークンに必要な権限がありません。REP Helperの「APIトークン」からトークンを編集して権限を追加してください。

"API access requires an Elite subscription"

• APIトークンはEliteプランで利用可能です。rephelper.ai でアップグレードしてください。

"Rate limited: Too many requests"

• しばらく待ってから再試行してください。制限: 読み取り60回/分、書き込み30回/分、削除5回/分。

ライセンス

MIT