Immopix

Immopix MCP コネクター

Immopix は、不動産物件の掲載向けの AI 写真サービスです。掲載写真を改善し、曇った空を差し替えたり、散らかったものを取り除いたり、何もない部屋に家具を追加したり、庭の写真の季節を変更したりできます。顧客はドイツの不動産業者と、英語圏ではヨーロッパ各地の不動産業者です。

Immopix コネクターは、https://immopix.ai/mcp にあるリモート MCP サーバーです。Immopix アカウントを Claude、ChatGPT などの MCP コネクターに対応したアシスタントに接続し、エージェントがそのアカウントにすでに保存されている物件や写真を操作できるようにします。

このリポジトリには、このコネクターの配布メタデータとクライアントの使用例が含まれています。ホストされているサーバー自体はクローズドソースであり、そのコードはここでは公開されていません。

コネクターでできること

サーバーは 13 個のツールを公開します。ユーザーの依頼内容ごとに分類すると、次の操作ができます。

• 物件。 アカウント内の物件の一覧表示、名前での検索、物件 1 件の読み取り、物件の作成、名前の変更、削除。
• 写真。 物件の写真一覧の表示、編集履歴を含む写真 1 枚の読み取り、写真の削除。
• 補正。 アカウント内にある写真の補正を開始し、完成した画像へのリンクが返されるまでジョブの状態を確認。
• オプションと費用。 利用可能なプリセット、部屋の種類、家具のスタイル、次回の補正に必要なクレジット数、アカウントの残りクレジット残高の確認。
• 新しい写真。 物件用の Immopix アップロードページへのリンクを返します。写真はブラウザーでアップロードし、コネクター経由ではアップロードしません。

ツール	スコープ	目的
immopix_list_properties	read	物件を新しい順に一覧表示し、任意で名前による絞り込みを行う
immopix_get_property	read	物件 1 件を読み取る
immopix_list_property_photos	read	物件の写真を一覧表示する
immopix_get_photo	read	写真 1 枚、その改訂履歴、次回の補正にかかる費用を読み取る
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 分で完了します。メニュー名はアシスタントによって異なりますが、手順は同じです。

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 の許可を得るための追加ステップが一度発生するため、エージェントが読み取り専用の許可で変更や課金を行うことはできません。
• アクセストークンの有効期間は1時間です。リフレッシュトークンはローテーションされ、有効期間は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 と同じ引数で呼び出しを繰り返すと、最初の結果が再現され、2回目の課金は発生しません。

このリポジトリの内容

ファイル	用途
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]