Developer Center

PlanV2 Open API
& AI Integration

REST API, MCP Server, AI Agent 엔드포인트를 통해 인테리어 견적·자재·시공 데이터에 프로그래밍 방식으로 접근하세요. ChatGPT, Claude 등 AI와 직접 연동됩니다.

12+REST API 엔드포인트
7MCP Tools
200+자재 데이터
14공사 카테고리

3가지 연동 방식

용도에 맞는 최적의 방식으로 PlanV2 플랫폼에 연동할 수 있습니다.

REST API

표준 RESTful 엔드포인트로 견적 계산, 자재 검색, 시공팀 조회, 상담 접수 등 모든 핵심 기능에 접근합니다. OpenAPI 3.0 스펙 문서와 Swagger UI를 제공합니다.

OpenAPI 3.0Swagger UIJSONNestJS
MCP

MCP Server

Model Context Protocol 기반으로 Claude Desktop, Claude Code 등 AI 도구에서 PlanV2 기능을 직접 호출합니다. 7개 Tool을 표준 MCP 프로토콜로 제공합니다.

MCP 1.0stdioClaudeZod Schema
AI

AI Agent API

자연어 입력을 GPT-4o-mini로 구조화된 액션으로 변환합니다. ChatGPT 웹 브라우징, 커스텀 GPT, AI 에이전트에서 URL 호출만으로 연동됩니다.

자연어 처리GPT-4oChatGPT 연동GET/POST

AI ↔ PlanV2 연동 흐름

🤖AI ClientChatGPT · Claude · 커스텀 Agent
🔌MCP / REST APIMCP Server · AI Agent API
⚙️PlanV2 BackendNestJS · TypeORM · MySQL
📊Data Response견적 · 자재 · 시공팀 · 사례

MCP Tool 목록

Claude Desktop/Code에서 MCP 프로토콜로 직접 호출할 수 있는 7개 도구입니다.

estimate_calculate
건물 유형·면적·등급·항목을 입력하면 항목별 예상 견적을 즉시 산출합니다.
buildingTypeareacategories[]tier
materials_search
200+ 자재 데이터베이스에서 카테고리·브랜드·키워드로 자재를 검색합니다.
search?category?brand?
materials_detail
특정 자재의 상세 스펙, 가격, 이미지 정보를 조회합니다.
materialId
contractors_list
검증된 11개 협력 시공팀의 전문분야·지역·실적·평점을 조회합니다.
cases_list
30+ 실제 시공사례 포트폴리오(사진, 면적, 스타일)를 조회합니다.
consultation_create
이름·연락처를 입력하면 시공 상담을 접수하고 담당자가 연락합니다.
namephonemessage?
planv2_info
PlanV2 서비스의 전체 기능 목록과 사이트 정보를 반환합니다.
claude_desktop_config.json
{
  "mcpServers": {
    "planv2": {
      "command": "npx",
      "args": ["tsx", "packages/mcp-server/src/index.ts"],
      "env": {
        "PLANV2_API_URL": "https://planv2.com/api-backend"
      }
    }
  }
}

API 엔드포인트

모든 엔드포인트는 OpenAPI 3.0 스펙으로 문서화되어 있으며, 공개 API는 인증 없이 즉시 호출할 수 있습니다.

POST
/api-backend/ai-agent/action
AI Agent 통합 — 자연어 또는 구조화된 요청 처리
GET
/api-backend/ai-agent/estimate
견적 계산 (URL 파라미터)
GET
/api-backend/ai-agent/materials
자재 검색 (키워드/브랜드 필터)
GET
/api-backend/ai-agent/contractors
시공팀 목록 조회
GET
/api-backend/ai-agent/schema
AI Agent용 기능 스키마 정의
GET
/api-backend/ai-agent/estimate-page
AI 읽기용 견적 HTML 페이지
GET
/api-backend/materials
자재 카탈로그 목록 (페이징, 필터)
GET
/api-backend/materials/:id
자재 상세 조회 (스펙, 이미지)
GET
/api-backend/contractors
시공팀 전체 목록
GET
/api-backend/construction-cases
시공사례 갤러리
POST
/api-backend/consultations
상담 신청 접수
POST
/api-backend/diagnosis/analyze
AI 계약서·견적서 진단
API 호출 예시 — 자연어 견적 요청
// POST /api-backend/ai-agent/action
const response = await fetch('https://planv2.com/api-backend/ai-agent/action', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    naturalLanguage: '30평 아파트 욕실+주방 고급 리모델링 견적'
  })
});

// 응답: { action: "estimate", success: true, data: { totalMin: 628, totalMax: 824, ... } }

활용 시나리오

PlanV2 API와 MCP를 활용한 다양한 연동 시나리오입니다.

💬

ChatGPT 커스텀 GPT

OpenAPI 스펙을 등록하면 ChatGPT가 사용자의 자연어 요청에 따라 자동으로 견적을 계산하고 자재를 추천합니다.

🧩

Claude MCP 연동

Claude Desktop에서 MCP Server를 등록하면 대화 중 실시간으로 견적 산출, 자재 검색, 시공팀 조회가 가능합니다.

🏗️

시공사 ERP 연동

시공사의 기존 ERP 시스템에서 REST API를 통해 PlanV2의 견적 데이터와 자재 카탈로그를 직접 조회·활용합니다.

📱

서드파티 앱 개발

모바일 앱, 웹 위젯 등 외부 서비스에서 PlanV2 견적 엔진과 자재 데이터를 임베드하여 사용자에게 제공합니다.

기술 스펙

Backend

NestJS 프레임워크 기반의 TypeScript 서버로, TypeORM + MySQL 데이터베이스, JWT 인증, Swagger 문서 자동 생성을 제공합니다.

NestJSTypeScriptTypeORMMySQLJWT

Frontend

Next.js 16 (App Router) 기반 SSR/SSG 웹 애플리케이션으로, 반응형 디자인과 SEO 최적화를 구현합니다.

Next.js 16React 19TypeScriptCSS Modules

Infrastructure

AWS EC2 + Nginx 리버스 프록시, Let's Encrypt SSL, PM2 프로세스 관리, pnpm 모노레포 구조로 운영됩니다.

AWS EC2NginxPM2Let's EncryptMonorepo

특허 기술

📜

공정별 단가 분해 및 면적 기반 비선형 스케일링 견적 자동 산출

출원번호 10-2026-0038483 | 14개 공사 카테고리의 공정별 단가를 면적 기반 비선형 스케일링(지수 0.85) 알고리즘으로 자동 산출하는 기술

비선형 스케일링공정별 단가 분해14개 카테고리3단계 등급

지금 바로 연동하세요

공개 API는 인증 없이 즉시 사용할 수 있습니다. Swagger UI에서 직접 테스트하거나, MCP Server를 설정해보세요.