Fixatia
Для разработчиков

Интеграция сервера MCP

Подключите Claude и других AI-ассистентов к базе данных недвижимости Fixatia с помощью Протокола Контекста Модели

Что такое MCP?

Протокол Контекста Модели (MCP) - это открытый стандарт, который позволяет AI-ассистентам, таким как Claude, безопасно получать доступ к внешним источникам данных. Сервер MCP Fixatia предоставляет доступ в реальном времени к нашей базе данных аукционов недвижимости в Европе, позволяя AI-ассистентам искать объекты, получать детали и находить доступные фильтры.

Ищите тысячи аукционных объектов в 6 европейских странах с помощью расширенных фильтров

Получите полные детали объектов, включая оценки ремонта, расчеты ROI и многоязычные описания

Динамически находите доступные варианты фильтров для создания мощных поисковых запросов

Узнайте больше о MCP

Быстрый старт

1URL сервера

Сервер MCP Fixatia доступен по адресу:

https://mcp.fixatia.com/api/mcp

2Настройка Claude 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 с потенциальной доходностью не менее 20%"

Доступные инструменты

Сервер Fixatia MCP предоставляет три мощных инструмента для взаимодействия с нашей базой данных недвижимости:

поиск_недвижимости

Ищите объекты недвижимости на аукционах по всей Европе. Фильтруйте по стране, городу, цене, типу недвижимости, потенциальной доходности и другим параметрам. Возвращает список соответствующих объектов с ключевыми деталями, включая цены на аукционах, рыночные стоимости и инвестиционные показатели.

Параметры

ParameterTypeRequiredDescription
querystringНеобязательныеТекстовый поиск по названию объекта, городу или региону
countrystringНеобязательныеКод страны: es (Испания), pt (Португалия), it (Италия), fr (Франция), de (Германия), hr (Хорватия)
regionstringНеобязательныеНазвание региона в стране
citystringНеобязательныеНазвание города
propertyTypestringНеобязательныеТип недвижимости: КВАРТИРА, ДОМ, ВИЛЛА, УЧАСТОК или КОММЕРЧЕСКАЯ
minPricenumberНеобязательныеМинимальная цена на аукционе в EUR
maxPricenumberНеобязательныеМаксимальная цена на аукционе в EUR
minRoinumberНеобязательныеМинимальный процент доходности (например, 20 для 20%)
bedroomsnumberНеобязательныеМинимальное количество спален
maxResultsnumberНеобязательныеМаксимальное количество результатов для возврата (по умолчанию: 10, максимум: 50)
sortBystringНеобязательныеПорядок сортировки: новейшие, цена-низкая, цена-высокая, roi-высокая или аукцион-скоро
localestringНеобязательныеЯзык для заголовков/описаний (по умолчанию: 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
          }
        ]
      }
    }]
  }
}

получить_объект

Получите полные данные о конкретном объекте по его ID. Возвращает исчерпывающую информацию, включая многоязычные описания, изображения, координаты местоположения, оценки ремонта, детали аукциона и инвестиционные показатели.

Параметры

ParameterTypeRequiredDescription
idstringОбязательныеID объекта (полученный из результатов поиска)
localestringНеобязательныеЯзык для заголовка/описания (по умолчанию: en). Поддерживает 18 языков.

Пример запроса

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_property",
    "arguments": {
      "id": "b45dc4fc14134da69e9f800f8",
      "locale": "en"
    }
  },
  "id": 2
}

получить_опции_фильтра

Получите доступные параметры фильтра, включая список стран, регионов, городов, типов недвижимости и диапазонов цен/доходности. Полезно для понимания доступных параметров поиска и создания динамических интерфейсов фильтрации.

Этот инструмент не принимает параметры.

Пример запроса

{
  "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

Отправьте запрос о недвижимости, чтобы выразить интерес. Этот инструмент требует аутентификации OAuth 2.1 с PKCE.

Требуется аутентификация (OAuth 2.1)

Этот инструмент использует OAuth 2.1 с PKCE для безопасной аутентификации. Процесс:

  • Пользователь нажимает 'Авторизовать' и входит через браузер
  • Код авторизации обменивается на токен доступа (защита PKCE)
  • mcp.tools.sendPropertyInquiry.oauthStep3

Параметры

ParameterTypeRequiredDescription
propertyIdstringОбязательныеID недвижимости для запроса
messagestringОбязательныеВаше сообщение-запрос, минимум 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.

Конечные точки

GET
/api/mcp

Проверка работоспособности и информация о сервере. Возвращает имя сервера, версию, версию протокола и доступные инструменты.

POST
/api/mcp

Запросы JSON-RPC 2.0 для выполнения инструментов. Поддерживает методы initialize, tools/list, tools/call и ping.

Поддерживаемые методы

  • initialize - Инициализировать сессию MCP и получить возможности сервера
  • tools/list - Список всех доступных инструментов с их схемами
  • tools/call - Выполнить конкретный инструмент с аргументами
  • 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. Вот распространенные коды ошибок:

CodeMessageDescription
-32600Неверный запросОтправленный JSON не является допустимым объектом запроса
-32601Метод не найденЗапрашиваемый метод не существует или недоступен
-32602Неверные параметрыНеверные параметры метода - проверьте обязательные поля и типы
-32603Внутренняя ошибкаВнутренняя ошибка JSON-RPC или проблема на стороне сервера

Пример ответа об ошибке

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params: Property ID is required"
  }
}

Поддерживаемые языки

Названия и описания объектов недвижимости доступны на 18 языках. Используйте параметр локали, чтобы получить контент на вашем предпочтительном языке:

Английский (en), Немецкий (de), Французский (fr), Испанский (es), Итальянский (it), Португальский (pt), Нидерландский (nl), Польский (pl), Греческий (el), Румынский (ro), Чешский (cs), Венгерский (hu), Китайский (zh), Арабский (ar), Русский (ru), Японский (ja), Корейский (ko), Хорватский (hr)

Машиночитаемая документация

Для ИИ-ассистентов и автоматизированных инструментов мы предоставляем текстовые файлы документации в соответствии со стандартом llms.txt:

llms.txt

Краткая документация с URL сервера, конфигурацией и обзорами инструментов

llms-full.txt

Полная документация со всеми параметрами, примерами запросов/ответов и кодами ошибок

Узнайте больше о стандарте llms.txt на llmstxt.org

Нужна помощь?

Если у вас есть вопросы по интеграции с сервером Fixatia MCP или возникли какие-либо проблемы, наша команда поддержки разработчиков готова помочь.

Связаться с поддержкой разработчиковСообщить о проблеме на GitHub