@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格式，只是文件路径不同：
| 客户端 | 配置文件 |
|---|---|
| 克劳德桌面 | ~/Library/Application Support/Claude/claude_desktop_config.json （macOS） |
| 光标 | .cursor/mcp.json （项目）或 ~/.cursor/mcp.json （全球） |
| 风帆冲浪 | ~/.codeium/windsurf/mcp_config.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密钥
- 首选 Rentalot API密钥
- 点击 创建API密钥
- 复制密钥（以开头
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
## 许可证
麻省理工学院