@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에 새로운 장기 임대 자산 추가해 줘"

사용 가능한 도구

활동

자산

활동 카테고리

• Management & Operations (관리 및 운영)

• Maintenance & Repairs (유지보수 및 수리)

• Development & Construction (개발 및 건설)

• Acquisition & Brokerage (취득 및 중개)

• Administrative & Compliance (행정 및 규정 준수)

증빙 파일

활동을 생성하거나 업데이트할 때 로컬 파일 시스템에서 증빙 파일을 첨부할 수 있습니다:

• 지원 형식: JPEG, PNG, WebP, PDF

• 활동당 최대 3개 파일

• 파일당 최대 10MB

예시: "유지보수 활동을 기록하고 /Users/me/Downloads/receipt.jpg에서 영수증을 첨부해 줘"

이동(Trips)

활동에 최대 3개의 이동을 연결할 수 있습니다. 이동 시간은 활동 기간에 자동으로 추가됩니다.

환경 변수

API 문서

대화형 API 문서는 api.rephelper.ai/docs에서 확인할 수 있습니다.

OpenAPI 사양은 api.rephelper.ai/openapi.yaml에서 확인할 수 있습니다.

문제 해결

"REPHELPER_API_TOKEN 환경 변수가 필요합니다"

• MCP 구성의 env 블록에 토큰을 추가했는지 확인하세요.

"토큰이 유효하지 않거나 찾을 수 없습니다"

• 토큰 값을 다시 확인하세요. rh_live_로 시작해야 합니다.

• 토큰이 취소되었을 수 있습니다. REP Helper에서 새로 생성하세요.

"권한 거부: 토큰에 X 권한이 없습니다"

• 토큰에 필요한 권한이 없습니다. REP Helper → API 토큰에서 토큰을 편집하여 권한을 추가하세요.

"API 액세스에는 Elite 구독이 필요합니다"

• API 토큰은 Elite 플랜에서 사용할 수 있습니다. rephelper.ai에서 업그레이드하세요.

"요금 제한: 요청이 너무 많습니다"

• 잠시 후 다시 시도하세요. 제한: 읽기 60회/분, 쓰기 30회/분, 삭제 5회/분.

라이선스

MIT