@rephelper/mcp-server

Servidor MCP para REP Helper: permita que los agentes de IA gestionen las actividades y propiedades inmobiliarias para el seguimiento de la calificación de REP (Profesional de Bienes Raíces) del IRS.

Requisitos previos

• Node.js 20+ — descargar

• Cuenta REP Helper Elite — rephelper.ai

• Token de API — Cree uno en REP Helper → Ajustes → Tokens de API

Inicio rápido

1. Crear un token de API

En la aplicación REP Helper, vaya a Ajustes → Tokens de API → Crear token. Conceda los permisos que necesite (p. ej., lectura/creación de actividades, lectura de propiedades). Copie el token; solo se muestra una vez.

2. Configurar su cliente de IA

Agregue lo siguiente a la configuración MCP de su cliente:

Claude Desktop — Edite claude_desktop_config.json:

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

Claude Code — Edite .claude/settings.json o use el comando /mcp:

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

Cursor — Edite .cursor/mcp.json:

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

3. Empiece a usarlo

Pídale a su asistente de IA que gestione sus actividades inmobiliarias:

"Registra 2 horas de gestión de propiedad para 123 Main St hoy"

"Muéstrame todas mis actividades de la semana pasada"

"Añade una nueva propiedad de alquiler a largo plazo en 456 Oak Ave, Austin, TX 78701"

Herramientas disponibles

Actividades

Propiedades

Categorías de actividad

• Management & Operations (Gestión y Operaciones)

• Maintenance & Repairs (Mantenimiento y Reparaciones)

• Development & Construction (Desarrollo y Construcción)

• Acquisition & Brokerage (Adquisición y Corretaje)

• Administrative & Compliance (Administración y Cumplimiento)

Archivos de evidencia

Al crear o actualizar actividades, puede adjuntar archivos de evidencia desde su sistema de archivos local:

• Formatos admitidos: JPEG, PNG, WebP, PDF

• Máximo 3 archivos por actividad

• Máximo 10 MB por archivo

Ejemplo: "Registra una actividad de mantenimiento y adjunta el recibo de /Users/me/Downloads/receipt.jpg"

Viajes

Asocie hasta 3 viajes con una actividad. El tiempo de viaje se añade automáticamente a la duración de la actividad.

Variables de entorno

Documentación de la API

La documentación interactiva de la API está disponible en api.rephelper.ai/docs.

La especificación OpenAPI está disponible en api.rephelper.ai/openapi.yaml.

Solución de problemas

"REPHELPER_API_TOKEN environment variable is required"

• Asegúrese de haber añadido el bloque env a su configuración MCP con su token.

"Token is invalid or not found"

• Compruebe el valor de su token. Debe comenzar con rh_live_.

• Es posible que el token haya sido revocado; cree uno nuevo en REP Helper.

"Permission denied: Token lacks X permission"

• Su token no tiene el permiso requerido. Edite el token en REP Helper → Tokens de API para añadirlo.

"API access requires an Elite subscription"

• Los tokens de API están disponibles en el plan Elite. Actualice en rephelper.ai.

"Rate limited: Too many requests"

• Espere un momento e inténtelo de nuevo. Límites: 60 lecturas/min, 30 escrituras/min, 5 eliminaciones/min.

Licencia

MIT