SmartAgent CRM

---

这是什么？

SmartAgent 是一款专为房地产中介机构打造的 CRM。它处理经纪业务的日常工作：新线索、Agent 任务、销售管道、房源信息及其在分类信息平台上的发布、客户备注、保存的搜索以及团队管理。

受众说明： SmartAgent 是一款俄语产品，服务于俄罗斯和独联体的房地产中介机构。CRM 界面、工具描述和返回的数据均为俄语。由于 MCP 目录和客户端面向国际用户，本 README 使用英语编写；但如果您不是 SmartAgent 客户，此服务对您并无用处。

此仓库发布 SmartAgent 的 MCP（Model Context Protocol）服务清单。该服务让任何兼容 MCP 的 AI 助手——Claude Desktop、Claude Code 或您自己的 Agent——都能代表您读取并操作 CRM 数据：查找线索、创建任务、推进销售管道中的交易、查询房源信息、添加备注等。

连接后，您可以向助手提出以下问题：

• “本周有哪些新线索还没人联系？”
• “为这笔交易创建一个明天跟进的任务，并添加通话备注。”
• “显示这个区域里我们所有低于 1500 万的两居室房源。”
• “哪些交易在‘已安排看房’阶段停留超过 10 天了？”

此仓库仅包含公开清单、图标和文档。 CRM 和 MCP 服务实现均为闭源，不在此处发布。

服务详情

端点	https://mcp.smartagent.ru/
传输方式	Streamable HTTP（MCP 修订版 2025-06-18）
身份验证	API 密钥，通过标头发送
可用工具	200+
托管方式	完全由 SmartAgent 托管——无需安装或自托管
访问权限	仅限 SmartAgent 企业版套餐

访问权限与限制

MCP 访问权限包含在 SmartAgent 企业版套餐中。试用版、免费版或普通套餐签发的密钥会被拒绝，并返回 403。

限制	数值
请求数	每分钟 60 次、每小时 1,000 次、每天 5,000 次（每家公司）
返回的房源记录数	每天 50,000 条（每家公司）
业主电话号码	受套餐的电话号码查询限制约束

如需开通企业版套餐，请联系我们（参见支持与联系）。

获取 API 密钥

1. 登录您的 SmartAgent 账户，访问 smartagent.ru（公司必须使用企业版套餐）。
2. 在 CRM 中打开 菜单 → API 密钥。
3. 创建密钥并复制。密钥格式为 sa_mcp_ 后跟 64 个十六进制字符。

密钥拥有其所属账户的权限，可访问您公司的 CRM 数据——请像保护密码一样妥善保管。不要将其提交到代码仓库、粘贴到共享聊天中；如果密钥泄露，请在同一页面将其撤销。

连接 MCP 客户端

此服务是远程服务——无需安装任何内容。将客户端指向该 URL，并在 Authorization 标头中传递密钥。

Claude Desktop / Claude Code

将以下内容添加到 MCP 客户端配置中（Claude Desktop 使用 claude_desktop_config.json）：

{
  "mcpServers": {
    "smartagent": {
      "type": "http",
      "url": "https://mcp.smartagent.ru/",
      "headers": {
        "Authorization": "Bearer sa_mcp_YOUR_KEY_HERE"
      }
    }
  }
}

之后重启客户端。SmartAgent 工具应会出现在工具列表中。

不支持原生远程服务的客户端

如果客户端只能启动本地（stdio）服务，可使用 mcp-remote 桥接到远程端点：

{
  "mcpServers": {
    "smartagent": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.smartagent.ru/",
        "--header", "Authorization: Bearer sa_mcp_YOUR_KEY_HERE"
      ]
    }
  }
}

身份验证说明

API 密钥可通过以下任一形式提供：

Header	Value
Authorization	Bearer sa_mcp_...
Authorization	sa_mcp_...（Bearer 前缀可选）
X-Api-Key	sa_mcp_...

使用客户端支持的任一形式即可。推荐默认使用 Authorization: Bearer ...。

工具涵盖的内容

200 多种工具，按所操作的 CRM 实体分组：

Category	What it covers
Leads	潜在客户和客户——搜索、读取、创建、更新、分配、跟踪状态
Tasks	Agent 待办事项和提醒——创建、重新安排、完成，按负责人和截止日期筛选
Sales pipelines	交易及其阶段——推动交易沿销售漏斗推进，查看阶段历史
Property listings	房地产对象及其分类广告——搜索数据库、读取详情、管理发布
Notes & attachments	附加到潜在客户、交易和房源的评论、通话记录和文件
Saved searches	存储在 CRM 中的客户搜索请求，以及与房源数据库的匹配结果
Tags & labels	使用公司自有标签对记录分类和筛选
Buildings & calls	楼宇／综合楼查询，以及关联到潜在客户的通话记录
Ad platforms	房源在各分类门户（Avito、CIAN 等）上的发布和联合分发设置
Reports	汇总的 CRM 报告（例如某房源的竞争对手数量）
Company & employees	公司资料、团队成员、角色和分配

MCP 客户端会通过 tools/list 自动发现工具名称和参数——无需记忆。每个工具均以俄语描述，与 CRM 自身的术语一致。

安全与隐私

• 访问范围仅限于签发 API 密钥的账户：助手只能看到贵公司的数据，无法访问其他数据。
• 可随时在 菜单 → API 密钥 中撤销密钥。
• 数据处理受我们的 隐私政策 约束。
• 仅将密钥提供给您信任的 AI 客户端——持有此密钥的助手不仅能读取 CRM 记录，还能修改记录。

支持与联系方式

我们提供俄语和英语支持。

Channel
🌐 网站	smartagent.ru
✉️ 电子邮件	[email protected]
☎️ 电话	+7 (495) 988-93-91
💬 WhatsApp	+7 (495) 988-93-91
✈️ Telegram 支持机器人	@SmartAgentSupportBot
📣 Telegram 频道	@SmartAgent_ru
🅜 MAX 支持机器人	max.ru/id7725737972_bot

发现 MCP 服务存在 Bug，或希望添加尚不存在的工具？请在此代码库中提交 issue，或发送邮件至 [email protected]。

许可证

本代码库的内容（清单、图标、文档）依据 MIT 许可证 发布。SmartAgent CRM 和 MCP 服务的实现本身为专有软件，不受此许可证约束。

---