MCP 서버 통합
모델 컨텍스트 프로토콜을 사용하여 Claude 및 기타 AI 어시스턴트를 Fixatia의 부동산 데이터베이스에 연결합니다.
MCP란 무엇인가요?
모델 컨텍스트 프로토콜(MCP)은 Claude와 같은 AI 어시스턴트가 외부 데이터 소스에 안전하게 접근할 수 있도록 하는 개방형 표준입니다. Fixatia의 MCP 서버는 유럽 부동산 경매 데이터베이스에 실시간으로 접근할 수 있게 하여 AI 어시스턴트가 부동산을 검색하고, 세부 정보를 검색하며, 사용 가능한 필터를 발견할 수 있도록 합니다.
고급 필터를 사용하여 6개 유럽 국가의 수천 개 경매 부동산을 검색하세요.
개조 추정치, ROI 계산 및 다국어 설명을 포함한 종합적인 부동산 세부 정보를 얻으세요.
강력한 검색 쿼리를 구축하기 위해 동적으로 사용 가능한 필터 옵션을 발견하세요.
빠른 시작
1서버 URL
Fixatia MCP 서버는 다음에서 사용할 수 있습니다:
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 이하의 포르투갈 부동산 중에서 최소 20% ROI 잠재력이 있는 것을 찾아줘"
사용 가능한 도구
Fixatia MCP 서버는 우리 부동산 데이터베이스와 상호작용하기 위한 세 가지 강력한 도구를 제공합니다:
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- 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 오류 응답을 반환합니다. 여기 일반적인 오류 코드가 있습니다:
| 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 서버와 통합하는 데 질문이 있거나 문제가 발생하면, 저희 개발자 지원 팀이 도와드리겠습니다.