Propstack MCP

Propstack MCP服务器

将AI助手（Claude、ChatGPT）连接到您的Propstack房地产CRM。

将 AI 助手连接到您的 Propstack CRM — 通过语言或聊天管理联系人、搜索物品、维护交易、安排访问和创建搜索配置文件。

What You Can Do / 你能做什么

• 联系人管理 --使用GDPR跟踪功能搜索、创建、更新和标记联系人
• 物业搜索与管理 --按价格、房间、面积、状态过滤；创建和更新列表
• 交易管道 --创建交易、经历阶段、跟踪输赢率
• 买家匹配 --使用自然语言创建搜索配置文件（“3-Zimmer in Berlin，bis 400k，mit Balkon”），并自动匹配新房源
• 任务和日历 --记录通话记录、设置后续提醒、安排查看
• 电子邮件 --发送链接到联系人和房产的模板电子邮件
• 360度接触视图 --每次通话前都要得到一份完整的简报
• 管道仪表板 --每个阶段的交易计数和值、过时交易警报
• 铅摄入 --一个通话工作流：数据消除、创建联系人、记录笔记、创建交易、设置提醒
• 大容量导出 --用于报告、备份或迁移的完整数据转储

快速开始

1.设置API密钥

export PROPSTACK_API_KEY=your_api_key_here

2a。克劳德桌面版

添加到您的Claude桌面配置(claude_desktop_config.json):

{
  "mcpServers": {
    "propstack": {
      "command": "npx",
      "args": ["-y", "propstack-mcp-server"],
      "env": {
        "PROPSTACK_API_KEY": "your_api_key_here"
      }
    }
  }
}

2b。克劳德代码（CLI）

添加到您的项目 .mcp.json:

{
  "mcpServers": {
    "propstack": {
      "command": "npx",
      "args": ["-y", "propstack-mcp-server"],
      "env": {
        "PROPSTACK_API_KEY": "your_api_key_here"
      }
    }
  }
}

2c。ChatGPT

1. 首选 设置>连接器>开发人员模式
2. 添加新的MCP连接器
3. 将命令设置为 npx -y propstack-mcp-server
4. 添加环境变量 PROPSTACK_API_KEY

2d。光标IDE

1. 打开 设置 （Ctrl+，）→ 搜索“MCP”
2. 编辑 MCP服务器 JSON，或添加 mcp.json 在项目根中/ .cursor/

选项A——本地项目 （之后 npm run build):

{
  "mcpServers": {
    "propstack": {
      "command": "node",
      "args": ["./dist/index.js"],
      "cwd": "C:/Users/you/path/to/propstack_mcp",
      "env": {
        "PROPSTACK_API_KEY": "your_api_key_here"
      }
    }
  }
}

或使用 .env 在项目根目录中，服务器会自动加载它；你可以省略 env 块。

选项B--npx （已发布的包或 npx 来自当地）：

{
  "mcpServers": {
    "propstack": {
      "command": "npx",
      "args": ["-y", "propstack-mcp-server"],
      "env": {
        "PROPSTACK_API_KEY": "your_api_key_here"
      }
    }
  }
}

2e。直接运行

npm install propstack-mcp-server
PROPSTACK_API_KEY=your_key npx propstack-mcp-server

API密钥/API-Schluessel

获取Propstack API密钥：

1. 登录 crm.propstack.de
2. 首选 管理 > API 密钥 （管理>API密钥）
3. 创建或复制您的V1 API密钥

注释： API 密钥决定权限。确保已启用所需终端的读写访问。

可用工具（50）

联系人（kontakte）

属性（Objects）

任务（任务和笔记）

交易（管道）

搜索配置文件（Sucprofile）

项目（Projects）

活动与事件（Aktivitaeten和Termine）

电子邮件（E-Mails）

文档

关系（Relationships）

查找（ 配置）

智能复合材料（智能工作流程）

管理员（Admin）

Example Conversations / 例子对话

晨间简报/摩根简报

你： 今天我的日历上有什么？ 人工智能： *电话 list_events 根据今天的日期范围* --您已安排了3次观看。..

杜： 昨天有新的线索吗？ KI： *呼唤 search_contacts created_at_from=昨天* 5个新联系人..

铅摄入量/铅摄入

你： 我刚和玛丽亚·施密特通了电话，+49 157 1234 5678。她正在柏林寻找一套三居室公寓，预算为300-400k，必须有阳台。她在ImmoScourt上找到了我们。 人工智能： *电话 smart_lead_intake* --已创建联系人（ID:4521），记录通话记录，为明天9:00设置跟进提醒。你想让我为她的条件创建一个搜索配置文件吗？

属性匹配/对象匹配

杜： 我们有一个新的上市：在夏洛滕堡的3间卧室公寓，385000欧元。 KI： *呼唤 match_contacts_to_property 在* - 找到 12 个匹配的搜索配置文件。前三名：韦伯先生（得分95%），穆勒女士（得分88%），金先生（得分85%）。..

管道审查

你： 我们的销售渠道怎么样？有什么过时的交易吗？ 人工智能： *电话 pipeline_summary* --47笔活跃交易，总价值1230万欧元。5笔交易已超过14天未更新。..

通话前简报 / Pre-Call Briefing

杜： 把3847号联系方式告诉我，我马上给你打电话。 KI： *呼唤 full_contact_360 在* —韦伯先生，评级3星级，在柏林/波茨坦寻找3间客房400k。2 活动交易， 最后一次活动 3 天前...

发展

git clone 
cd propstack-mcp-server
npm install
npm run build    # tsc → dist/
npm start        # requires PROPSTACK_API_KEY

项目结构

src/
  index.ts                 # Server entry point (stdio transport)
  propstack-client.ts      # HTTP client with auth, retry, error handling
  types/
    propstack.ts           # TypeScript interfaces for all API responses
  tools/
    helpers.ts             # Shared formatting utilities
    contacts.ts            # 7 contact tools
    properties.ts          # 5 property tools
    tasks.ts               # 3 task tools (polymorphic: note/todo/event/cancel)
    deals.ts               # 3 deal pipeline tools
    search-profiles.ts     # 4 search profile tools
    projects.ts            # 2 project tools
    activities.ts          # 2 activity/event tools
    emails.ts              # 2 email tools
    documents.ts           # 2 document tools
    relationships.ts       # 2 relationship tools (ownership/partnership)
    lookups.ts             # 8 lookup/config tools
    composites.ts          # 5 smart composite tools
    admin.ts               # 5 admin tools (webhooks, export, favorites)

许可证

麻省理工学院