Rentalot MCP

@rentalot/mcp服务器

MCP服务器 Rentalot API通过任何AI助手管理租赁物业、联系人、展示、对话等。

设置

克劳德代码

claude mcp add rentalot -e RENTALOT_API_KEY=ra_your_key -- npx -y @rentalot/mcp-server

食品法典委员会（OpenAI）

codex mcp add --env RENTALOT_API_KEY=ra_your_key -- npx -y @rentalot/mcp-server

双子星命令行工具

gemini mcp add --transport stdio rentalot -- npx -y @rentalot/mcp-server

然后将env变量添加到 ~/.gemini/settings.json:

{
  "mcpServers": {
    "rentalot": {
      "command": "npx",
      "args": ["-y", "@rentalot/mcp-server"],
      "env": { "RENTALOT_API_KEY": "ra_your_key" }
    }
  }
}

克劳德桌面/光标/风帆

这三个都使用相同的JSON格式，只是文件路径不同：

{
  "mcpServers": {
    "rentalot": {
      "command": "npx",
      "args": ["-y", "@rentalot/mcp-server"],
      "env": {
        "RENTALOT_API_KEY": "ra_your_key"
      }
    }
  }
}

开源代码

添加 ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "rentalot": {
      "type": "local",
      "command": ["npx", "-y", "@rentalot/mcp-server"],
      "environment": { "RENTALOT_API_KEY": "ra_your_key" },
      "enabled": true
    }
  }
}

获取API密钥

1. 首选 Rentalot API密钥
2. 点击 创建API密钥
3. 复制密钥（以开头 ra_)

认证

您可以通过两种方式提供API密钥。环境变量优先于配置文件。

选项A：配置文件（推荐）

保存密钥一次，每个MCP客户端都会自动拾取它——无需设置 RENTALOT_API_KEY 在每个客户端的配置中：

mkdir -p ~/.config/rentalot
cat > ~/.config/rentalot/config.yaml  尊重 `$XDG_CONFIG_HOME` --如果设置，则查找 `$XDG_CONFIG_HOME/rentalot/config.yaml` 相反。

**解决顺序：** `RENTALOT_API_KEY` 谁是 > `api_key` 在配置文件中

### AI代理技能

该项目运送了一艘 [技能.md](.skills/default/SKILL.md) 跟随 [代理技能开放标准](https://agentskills.io).安装它，以便您的编码代理了解所有65种工具、常见工作流和API模式。

**快速安装 [`skills`](https://skills.sh) 命令行界面** （Vercel Labs）：

npx skills add ariel-frischer/rentalot-mcp

Manual install

**克劳德代码** --技能生活 `~/.claude/skills/` （全球）或 `.claude/skills/` （本地项目）。

Global — available in all projects

mkdir -p ~/.claude/skills/rentalot-mcp curl -fsSL https://raw.githubusercontent.com/ariel-frischer/rentalot-mcp/main/.skills/default/SKILL.md \ -o ~/.claude/skills/rentalot-mcp/SKILL.md

Project-local — checked into this repo only

mkdir -p .claude/skills/rentalot-mcp curl -fsSL https://raw.githubusercontent.com/ariel-frischer/rentalot-mcp/main/.skills/default/SKILL.md \ -o .claude/skills/rentalot-mcp/SKILL.md

**Codex CLI** --阅读技能 `~/.codex/skills/` （全球）或 `.codex/skills/` （本地项目）。

Global

mkdir -p ~/.codex/skills/rentalot-mcp curl -fsSL https://raw.githubusercontent.com/ariel-frischer/rentalot-mcp/main/.skills/default/SKILL.md \ -o ~/.codex/skills/rentalot-mcp/SKILL.md

Project-local

mkdir -p .codex/skills/rentalot-mcp curl -fsSL https://raw.githubusercontent.com/ariel-frischer/rentalot-mcp/main/.skills/default/SKILL.md \ -o .codex/skills/rentalot-mcp/SKILL.md

或者直接通过： `codex --instructions .skills/default/SKILL.md`

### API详细技能

对于更深入的API参考（完整字段列表、状态枚举、webhook事件） `skills/rentalot/SKILL.md`.Symlink它为克劳德代码：

ln -s "$(pwd)/skills/rentalot" ~/.claude/skills/rentalot

然后调用 `/rentalot` 在任何Claude Code会话中。

## 工具（65）

|资源|工具|访问|
|----------|-------|--------|
|房产（5）| `list_properties`, `get_property`, `create_property`, `update_property`, `delete_property` |阅读：初学者+/写作：专业版+|
|联系人（5）| `list_contacts`, `get_contact`, `create_contact`, `update_contact`, `delete_contact` |阅读：初学者+/写作：专业版+|
|展览（6）| `list_showings`, `get_showing`, `create_showing`, `update_showing`, `delete_showing`, `check_showing_availability` |阅读：初学者+/写作：专业版+|
|活动（1）| `list_events` |阅读：初学者+|
|对话（4）| `list_conversations`, `get_conversation`, `search_conversations`, `list_conversation_messages` |阅读：初学者+|
|留言（1）| `send_message` |撰写：Pro+|
|草稿（6）| `list_drafts`, `get_draft`, `create_draft`, `update_draft`, `send_draft`, `delete_draft` |阅读：初学者+/写作：专业版+|
|随访（4）| `list_followups`, `get_followup`, `create_followup`, `delete_followup` |阅读：初学者+/写作：专业版+|
|工作流程（8）| `list_workflows`, `get_workflow`, `create_workflow`, `update_workflow`, `delete_workflow`, `trigger_workflow_run`, `list_workflow_runs`, `get_workflow_run` |阅读：初学者+/写作：专业版+|
|Webhooks（7）| `list_webhooks`, `create_webhook`, `get_webhook`, `update_webhook`, `delete_webhook`, `test_webhook`, `rotate_webhook_secret` |Pro+|
|设置（4）| `get_settings`, `update_settings`, `get_followup_settings`, `update_followup_settings` |阅读：初学者+/写作：专业版+|
|房产图片（9）| `list_property_images`, `presign_image_upload`, `confirm_image_upload`, `delete_property_images`, `reorder_property_images`, `presign_image_batch`, `confirm_image_batch`, `import_property_images`, `get_image_import_job` |阅读：初学者+/写作：专业版+|
|会议（3）| `list_sessions`, `get_session`, `review_session` |阅读：初学者+/写作：专业版+|
|批量进口（2）| `bulk_create_properties`, `get_bulk_import_job` |Pro+|

## 资源

- `docs://api-reference` -API完整引用（身份验证、速率限制、分页、错误、所有资源架构）

## 发展

bun install bun run build # Compile TypeScript bun run dev # Run with --watch (hot reload) bun run lint # ESLint bun run typecheck # tsc --noEmit bun run test:e2e # E2E test all 65 tools against local dev server

## 许可证

麻省理工学院