@rephelper/mcp-server

MCP-Server für REP Helper — lassen Sie KI-Agenten Immobilienaktivitäten und -objekte für die Nachverfolgung der IRS REP (Real Estate Professional)-Qualifikation verwalten.

Voraussetzungen

• Node.js 20+ — download

• REP Helper Elite-Konto — rephelper.ai

• API-Token — Erstellen Sie eines in REP Helper → Einstellungen → API-Token

Schnellstart

1. Erstellen Sie ein API-Token

Gehen Sie in der REP Helper-App zu Einstellungen → API-Token → Token erstellen. Erteilen Sie die benötigten Berechtigungen (z. B. Aktivitäten lesen/erstellen, Immobilien lesen). Kopieren Sie das Token – es wird nur einmal angezeigt.

2. Konfigurieren Sie Ihren KI-Client

Fügen Sie Folgendes zur MCP-Konfiguration Ihres Clients hinzu:

Claude Desktop — Bearbeiten Sie claude_desktop_config.json:

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

Claude Code — Bearbeiten Sie .claude/settings.json oder verwenden Sie den Befehl /mcp:

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

Cursor — Bearbeiten Sie .cursor/mcp.json:

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

3. Starten Sie die Nutzung

Bitten Sie Ihren KI-Assistenten, Ihre Immobilienaktivitäten zu verwalten:

"Log 2 hours of property management for 123 Main St today"

"Show me all my activities from last week"

"Add a new long-term rental property at 456 Oak Ave, Austin, TX 78701"

Verfügbare Tools

Aktivitäten

Immobilien

Aktivitätskategorien

• Management & Operations

• Maintenance & Repairs

• Development & Construction

• Acquisition & Brokerage

• Administrative & Compliance

Nachweisdateien

Beim Erstellen oder Aktualisieren von Aktivitäten können Sie Nachweisdateien aus Ihrem lokalen Dateisystem anhängen:

• Unterstützte Formate: JPEG, PNG, WebP, PDF

• Maximal 3 Dateien pro Aktivität

• Maximal 10 MB pro Datei

Beispiel: "Log a maintenance activity and attach the receipt from /Users/me/Downloads/receipt.jpg"

Fahrten

Verknüpfen Sie bis zu 3 Fahrten mit einer Aktivität. Die Reisezeit wird automatisch zur Aktivitätsdauer addiert.

Umgebungsvariablen

API-Dokumentation

Interaktive API-Dokumentation finden Sie unter api.rephelper.ai/docs.

Die OpenAPI-Spezifikation finden Sie unter api.rephelper.ai/openapi.yaml.

Fehlerbehebung

"REPHELPER_API_TOKEN environment variable is required"

• Stellen Sie sicher, dass Sie den env-Block mit Ihrem Token zur MCP-Konfiguration hinzugefügt haben.

"Token is invalid or not found"

• Überprüfen Sie Ihren Token-Wert. Er sollte mit rh_live_ beginnen.

• Das Token wurde möglicherweise widerrufen – erstellen Sie ein neues in REP Helper.

"Permission denied: Token lacks X permission"

• Ihr Token verfügt nicht über die erforderliche Berechtigung. Bearbeiten Sie das Token in REP Helper → API-Token, um sie hinzuzufügen.

"API access requires an Elite subscription"

• API-Token sind im Elite-Plan verfügbar. Führen Sie ein Upgrade unter rephelper.ai durch.

"Rate limited: Too many requests"

• Warten Sie einen Moment und versuchen Sie es erneut. Limits: 60 Lesezugriffe/Min, 30 Schreibzugriffe/Min, 5 Löschvorgänge/Min.

Lizenz

MIT