MCP サーバー統合
モデルコンテキストプロトコルを使用して、Claude および他の AI アシスタントを Fixatia の不動産データベースに接続します
MCP とは？
モデルコンテキストプロトコル (MCP) は、Claude のような AI アシスタントが外部データソースに安全にアクセスできるオープンスタンダードです。Fixatia の MCP サーバーは、私たちのヨーロッパの不動産オークションデータベースへのリアルタイムアクセスを提供し、AI アシスタントが物件を検索し、詳細を取得し、利用可能なフィルターを発見できるようにします。
高度なフィルターを使用して、6 ヨーロッパ諸国のオークション物件を数千件検索
リノベーション見積もり、ROI 計算、マルチリンガルの説明を含む包括的な物件詳細を取得
強力な検索クエリを構築するために動的に利用可能なフィルターオプションを発見
クイックスタート
1サーバー URL
Fixatia MCP サーバーは以下の URL で利用可能です:
https://mcp.fixatia.com/api/mcp2Claude Desktop の設定
次の内容を Claude Desktop の設定ファイルに追加します:
Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"fixatia": {
"url": "https://mcp.fixatia.com/api/mcp"
}
}
}3使用開始
Claude Desktop を再起動し、物件について質問を始めます。Claude は自動的に Fixatia ツールを使用して物件情報を検索し、取得します。
次のように質問してみてください: "ポルトガルで€150,000未満の物件を、ROI ポテンシャルが20%以上のものを見つけて"
利用可能なツール
Fixatia MCP サーバーは、私たちの不動産データベースと対話するための 3 つの強力なツールを提供します:
search_properties
ヨーロッパ全体の不動産オークション物件を検索します。国、都市、価格、物件タイプ、ROIの可能性などでフィルタリングできます。オークション価格、市場価値、投資指標を含む重要な詳細を持つ一致する物件のリストを返します。
パラメータ
| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | オプション | 物件タイトル、都市、または地域のテキスト検索 |
| country | string | オプション | 国コード: es (スペイン), pt (ポルトガル), it (イタリア), fr (フランス), de (ドイツ), hr (クロアチア) |
| region | string | オプション | 国内の地域名 |
| city | string | オプション | 都市名 |
| propertyType | string | オプション | 物件の種類: アパートメント、家、ヴィラ、土地、または商業 |
| minPrice | number | オプション | EURでの最低オークション価格 |
| maxPrice | number | オプション | EURでの最高オークション価格 |
| minRoi | number | オプション | 最低ROIパーセンテージ（例: 20は20%を意味します） |
| bedrooms | number | オプション | 最低寝室数 |
| maxResults | number | オプション | 返す最大結果数（デフォルト: 10, 最大: 50） |
| sortBy | string | オプション | ソート順: 最新、価格の低い順、価格の高い順、ROIの高い順、またはオークションが最も近い順 |
| locale | string | オプション | タイトル/説明の言語（デフォルト: en）。18言語に対応。 |
リクエストの例
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "search_properties",
"arguments": {
"country": "pt",
"maxPrice": 150000,
"minRoi": 20,
"maxResults": 5
}
},
"id": 1
}レスポンスの例
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [{
"type": "text",
"text": {
"totalCount": 12,
"results": [
{
"id": "b45dc4fc14134da69e9f800f8",
"title": "2-Bedroom Apartment · Lisbon",
"country": "pt",
"city": "Lisboa",
"propertyType": "APARTMENT",
"auctionPrice": 120000,
"marketValue": 165000,
"potentialRoi": 26.5,
"bedrooms": 2,
"squareMeters": 75
}
]
}
}]
}
}get_property
特定の物件のIDによる詳細情報を取得します。多言語の説明、画像、位置座標、改修見積もり、オークションの詳細、投資指標を含む包括的な情報を返します。
パラメータ
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | 必須 | 物件ID（検索結果から取得） |
| locale | string | オプション | タイトル/説明の言語（デフォルト: en）。18言語に対応。 |
リクエストの例
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "get_property",
"arguments": {
"id": "b45dc4fc14134da69e9f800f8",
"locale": "en"
}
},
"id": 2
}get_filter_options
利用可能なフィルタオプションを取得します。国、地域、都市、物件タイプ、価格/ROI範囲のリストを含みます。利用可能な検索パラメータを理解し、動的フィルタインターフェースを構築するのに役立ちます。
このツールはパラメータを必要としません。
リクエストの例
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "get_filter_options",
"arguments": {}
},
"id": 3
}レスポンスの例
{
"countries": [
{ "code": "pt", "name": "Portugal", "propertyCount": 45 },
{ "code": "es", "name": "Spain", "propertyCount": 120 },
{ "code": "it", "name": "Italy", "propertyCount": 89 }
],
"propertyTypes": [
{ "type": "APARTMENT", "count": 156 },
{ "type": "HOUSE", "count": 78 }
],
"priceRange": { "min": 5000, "max": 800000 },
"roiRange": { "min": -5, "max": 45 }
}send_property_inquiry
OAuth 2.1物件について問い合わせを送信して関心を表明します。このツールにはPKCEを使用したOAuth 2.1認証が必要です。
認証が必要です（OAuth 2.1）
このツールは安全な認証のためにPKCEを使用したOAuth 2.1を使用します。フローは:
- ユーザーが「認証」をクリックしてブラウザでログイン
- 認証コードがアクセストークンと交換されます（PKCE保護）
- mcp.tools.sendPropertyInquiry.oauthStep3
パラメータ
| Parameter | Type | Required | Description |
|---|---|---|---|
| propertyId | string | 必須 | 問い合わせる物件のID |
| message | string | 必須 | 問い合わせメッセージ、最低10文字 |
リクエストの例
// Requires Bearer token authentication
// curl -X POST https://mcp.fixatia.com/api/mcp \
// -H "Authorization: Bearer YOUR_TOKEN" \
// -H "Content-Type: application/json" \
// -d '...'
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "send_property_inquiry",
"arguments": {
"propertyId": "b45dc4fc14134da69e9f800f8",
"message": "I'm interested in this property. Is it still available?"
}
},
"id": 4
}レスポンスの例
{
"jsonrpc": "2.0",
"id": 4,
"result": {
"content": [{
"type": "text",
"text": "Inquiry sent successfully! The property owner will be notified and may contact you."
}]
}
}HTTP API リファレンス
MCPサーバーは、プログラムによるアクセスのために直接HTTP APIも公開しています。すべてのリクエストはJSON-RPC 2.0プロトコルを使用します。
エンドポイント
/api/mcpヘルスチェックとサーバー情報。サーバー名、バージョン、プロトコルバージョン、および利用可能なツールを返します。
/api/mcpツール実行のためのJSON-RPC 2.0リクエスト。initialize、tools/list、tools/call、およびpingメソッドをサポートします。
サポートされているメソッド
initialize- MCPセッションを初期化し、サーバーの機能を取得しますtools/list- スキーマ付きのすべての利用可能なツールをリストしますtools/call- 引数を指定して特定のツールを実行しますping- ヘルスチェックping
cURLの例
curl -X POST https://mcp.fixatia.com/api/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "search_properties",
"arguments": {
"country": "pt",
"maxPrice": 150000
}
},
"id": 1
}'試してみる
ブラウザから直接MCPサーバーをテストします。ツールを選択してパラメータを設定してください。
ツールを選択
エラーハンドリング
サーバーは標準のJSON-RPC 2.0エラー応答を返します。以下は一般的なエラーコードです：
| Code | Message | Description |
|---|---|---|
| -32600 | 無効なリクエスト | 送信されたJSONは有効なリクエストオブジェクトではありません |
| -32601 | メソッドが見つかりません | リクエストされたメソッドは存在しないか、利用できません |
| -32602 | 無効なパラメータ | 無効なメソッドパラメータ - 必要なフィールドとタイプを確認してください |
| -32603 | 内部エラー | 内部JSON-RPCエラーまたはサーバー側の問題 |
エラー応答の例
{
"jsonrpc": "2.0",
"id": 1,
"error": {
"code": -32602,
"message": "Invalid params: Property ID is required"
}
}サポートされている言語
物件のタイトルと説明は18言語で利用可能です。localeパラメータを使用して、希望の言語でコンテンツを取得します：
英語 (en), ドイツ語 (de), フランス語 (fr), スペイン語 (es), イタリア語 (it), ポルトガル語 (pt), オランダ語 (nl), ポーランド語 (pl), ギリシャ語 (el), ルーマニア語 (ro), チェコ語 (cs), ハンガリー語 (hu), 中国語 (zh), アラビア語 (ar), ロシア語 (ru), 日本語 (ja), 韓国語 (ko), クロアチア語 (hr)
機械可読ドキュメント
AIアシスタントと自動化ツール向けに、llms.txt標準に準拠したプレーンテキストドキュメントファイルを提供しています：
llms.txt標準の詳細は llmstxt.org
助けが必要ですか？
Fixatia MCPサーバーとの統合に関する質問や問題がある場合は、私たちの開発者サポートチームがサポートいたします。