Immopix

Immopix MCP 连接器

Immopix 是一款面向房地产房源的 AI 照片服务。它可以优化房源照片：替换灰蒙蒙的天空、移除杂物、为空房间添加家具，并调整花园照片的季节效果。其客户是德国的房产经纪人，以及欧洲其他地区使用英语的房产经纪人。

Immopix 连接器是一个远程 MCP 服务，地址为 https://immopix.ai/mcp。它将 Immopix 账户连接到 Claude、ChatGPT 和其他支持 MCP 连接器的助手，让 Agent 能够使用该账户已有的房产和照片。

本仓库包含该连接器的分发元数据和客户端示例。托管服务本身为闭源，代码不会在此发布。

连接器的功能

该服务提供 13 个工具。根据用户的需求，它们分为以下几类：

• 房产。 列出账户中的房产、按名称搜索房产、读取房产信息、创建房产、重命名房产和删除房产。
• 照片。 列出房产的照片、读取照片及其编辑历史记录，以及删除照片。
• 优化。 开始优化账户中已有的照片，然后轮询任务，直到返回成品图片链接。
• 选项和费用。 读取可用预设、房间类型和家具风格、下次优化的积分价格，以及账户剩余积分余额。
• 新照片。 返回房产对应的 Immopix 上传页面链接。照片通过浏览器上传，不会通过连接器上传。

工具	范围	用途
immopix_list_properties	read	按时间从新到旧列出房产，可选择按名称筛选
immopix_get_property	read	读取一处房产的信息
immopix_list_property_photos	read	列出房产的照片
immopix_get_photo	read	读取一张照片、其修订版本及下次优化的费用
immopix_check_job	read	读取优化任务的状态及结果链接
immopix_list_presets	read	列出预设、房间类型和家具风格
immopix_get_account	read	读取剩余积分余额
immopix_get_upload_link	write	返回房产对应的浏览器上传链接
immopix_create_property	write	创建房产
immopix_update_property	write	重命名房产
immopix_delete_property	write	删除房产及其照片
immopix_delete_photo	write	删除照片及其修订版本
immopix_enhance_photo	write	优化账户中的照片并返回任务句柄

使用 read 范围时，完整目录始终可见。调用写入工具时，会启动逐步授权，而不会静默失败。

连接

在助手内即可完成设置，大约需要一分钟。不同助手的菜单名称有所不同，但步骤相同。

1. 打开助手的连接器设置。
2. 添加自定义连接器，地址为 https://immopix.ai/mcp。
3. 在打开的浏览器窗口中使用 Immopix 账户登录。
4. 授权页面会列出应用、账户和请求的权限。请检查后再批准。

在 Claude Code 中，也可以通过命令行添加同一个连接器：

claude mcp add --transport http immopix https://immopix.ai/mcp

之后运行 /mcp 完成登录。

examples/README.md 介绍了首次对话的操作流程，并列出了客户端配置。

身份验证

该服务是受 OAuth 2.1 保护的资源。此流程中没有 API 密钥，也没有客户端密钥。

• 客户端通过 Client ID Metadata Documents（CIMD）注册为公共客户端，并使用 token_endpoint_auth_method=none。未启用动态客户端注册。
• 授权码流程要求使用 S256 进行 PKCE 验证。
• 受保护资源值准确为 https://immopix.ai/mcp，并与签发的令牌绑定。为其他资源签发的令牌会被拒绝。
• 首次授权请求 read 权限。写入工具会触发一次权限升级，申请 read write，因此 Agent 无法在只读授权下更改或扣费。
• 访问令牌有效期为一小时。刷新令牌会轮换，有效期为 30 天。
• 发现文档位于 /.well-known/oauth-protected-resource/mcp、/.well-known/oauth-protected-resource 和 /.well-known/oauth-authorization-server。

端点仅接受带有 Authorization: Bearer 的 POST 请求。带尾部斜杠的 https://immopix.ai/mcp/ 不是该端点，也不会被重定向。

照片

不会有图像数据通过 MCP 连接传输。连接器既不接受图像 URL，也不接受 base64 字节，而且所有增强操作都基于账户已有的照片进行。

如需添加新照片，请向助手索取上传链接。immopix_get_upload_link 会返回该房产的 Immopix 页面；你可以在浏览器中上传文件，然后让助手重新列出照片以获取新照片。结果会以短时有效的链接返回，因此图像不会进入模型上下文。

积分

通过助手发起的增强操作，所需积分与在 Immopix 网页界面进行同一项增强操作相同。读取、列出和搜索均不收费。

工具说明和服务指令要求助手在消费任何积分前说明价格和余额，并征求确认。immopix_get_photo 会返回按输出分辨率计算的下一次增强费用；免费修订则会如实显示费用为零。immopix_get_account 会返回余额。每次增强也都会显示在 Immopix 的照片历史记录中。

创建和增强调用都会携带由客户端提供的 operation_id。使用相同 ID 和相同参数重复调用时，会重放首次结果，且不会再次扣费。

此仓库的内容

文件	用途
server.json	官方 MCP Registry 的元数据
examples/	首次对话示例和客户端配置
CHANGELOG.md	已发布的服务和工具元数据版本
SECURITY.md	漏洞报告方式
PRIVACY.md	具有约束力的隐私政策链接

托管服务为闭源。本仓库仅包含分发元数据和客户端示例，不包含服务端代码、配置或凭据。

链接

• 帮助文档（德语）：https://immopix.ai/docs/mcp/
• 帮助文档（英语）：https://immopix.ai/en/docs/mcp/
• REST API 文档：https://immopix.ai/docs/api/
• 隐私政策（具有约束力的德语版本）：https://immopix.ai/datenschutz/
• 隐私政策（英语）：https://immopix.ai/en/privacy/
• 条款（具有约束力的德语版本）：https://immopix.ai/agb/
• 条款（英语）：https://immopix.ai/en/terms/
• 支持：[email protected]