내만집 AI 연결 안내 — MCP 서버 · REST API · llms.txt

Claude·ChatGPT·Cursor·Gemini CLI 같은 AI 에이전트가 내만집의 반셀프 인테리어 데이터를 도구로 읽을 수 있습니다.

무인증 · 읽기 전용 · 공개 문서만. 설정은 URL 한 줄이면 끝납니다. 내 견적·공사 진행까지 보려면 「내 계정」 서버(https://nmjib.com/api/mcp-me, 로그인 필요)를 추가하세요.

개발자가 아니라면 ChatGPT·Claude에 내만집 연결하기(3단계) 안내가 더 쉽습니다.

핵심만 먼저

연결 방법

Claude (claude.ai · Claude Desktop)

설정 → 커넥터 → 「커스텀 커넥터 추가」 → 이름 nmjib, URL https://nmjib.com/api/mcp, 인증 없음. 대화에서 「내만집 도구로 30평 반셀프 공정 순서와 기간 알려줘」처럼 부르면 됩니다.

Claude Code

claude mcp add --transport http nmjib https://nmjib.com/api/mcp

Cursor · Windsurf (mcp.json)

{ "mcpServers": { "nmjib": { "url": "https://nmjib.com/api/mcp" } } }

ChatGPT

설정 → 커넥터 → 고급 → 「개발자 모드」 켜기 → 「만들기」 → 이름 nmjib, MCP 서버 URL https://nmjib.com/api/mcp, 인증 「없음」. 딥리서치·회사 지식에서 요구하는 search·fetch 도구를 그대로 제공합니다. 커넥터를 못 쓰는 플랜은 GPT 만들기 → 작업(Actions) → 스키마 URL 에 https://nmjib.com/openapi.json 을 넣으세요.

Gemini CLI (~/.gemini/settings.json)

{ "mcpServers": { "nmjib": { "httpUrl": "https://nmjib.com/api/mcp" } } }

Codex CLI

codex mcp add nmjib --url https://nmjib.com/api/mcp

REST 로 바로 부르기

curl "https://nmjib.com/api/ai/search?q=30%ED%8F%89+%EB%B0%98%EC%85%80%ED%94%84+%EB%B9%84%EC%9A%A9"
curl "https://nmjib.com/api/ai/process?pyeong=30"
curl "https://nmjib.com/api/ai/checklist?phase=during&process=%EB%AA%A9%EA%B3%B5"
curl "https://nmjib.com/api/ai/cost?topic=%EC%9A%95%EC%8B%A4"

도구 목록

도구입력돌려주는 것
searchquery, limit, kind문서 목록 {results:[{id,title,url}]} — 매거진 165편·안내 4·가이드 19(데이터 6 + 질문형 13)
fetchid 또는 URL문서 본문(마크다운) {id,title,text,url,metadata}
nmjib_process_guidepyeong22공정 순서·단계·설명 + 평형별 막대 영업일·일차·배치(병행 여부) + 임계 경로·예비·공기 + 순서 규칙
nmjib_checklistphase(pre·during·post), process공사 전 36항목 · 공정별(22공정) · 공사 후 검수 22항목
nmjib_cost_referencetopic평형·공간·공정 30개 주제의 후기 집계 범위 + 기준일 + 출처 URL
nmjib_faq_searchquery, limit질문에 가장 가까운 FAQ 답 + 출처 URL
nmjib_material_catalogcategory, brand, query, limit자재 상품 목록 — 브랜드·품명·규격·상태만(가격·재고 수량 없음). 구매·견적은 nmjib_material_request 또는 앱
nmjib_worker_applyname, phone, consent, trades[], regions, career_years…접수(쓰기 전용) — 시공 작업자 등록 신청. 접수번호와 다음 단계만 돌려주고 아무것도 되읽지 않음
nmjib_consult_requestname, phone, consent, region, pyeong, scope, timing, trades[]접수(쓰기 전용) — 집주인 상담·작업자 매칭 문의(trades 에 작업자가 필요한 공정). 금액 산출 도구 아님, 작업자 명단·연락처 미제공
nmjib_material_requestname, phone, consent, items, quantity, brand_pref, region, pyeong, timing접수(쓰기 전용) — 자재 구매·견적 문의(품목·수량·지역). 가격·재고·상품 목록은 돌려주지 않음, 담당자가 견적 회신
nmjib_partner_inquiryname, phone, consent, company, category, items, email접수(쓰기 전용) — 자재·가전 업체 입점 문의. 매입 단가·마진·거래 조건은 제공하지 않음
nmjib_verify_codeticket, code | resend접수 2단계 — 문자로 받은 6자리 확인번호 대조(5회 잠금·10분 만료) 또는 재발송(3회). 성공해야 담당자에게 전달

리소스(nmjib://doc/{id}, nmjib://llms.txt)와 프롬프트(nmjib_banself_plan: 평수·범위를 넣으면 순서·기간·체크리스트·비용 범위로 계획을 짜는 템플릿)도 제공합니다. 읽기 도구 7개는 readOnlyHint=true, 접수 도구 4개(+확인)는 readOnlyHint=false·destructiveHint=false·idempotentHint=true(같은 전화·종류는 7일 내 같은 접수번호)로 표시되어 클라이언트가 실행 전 사용자 확인을 띄웁니다.

「내 계정」 서버 — https://nmjib.com/api/mcp-me (OAuth 2.1, 로그인 필요)

공개 서버의 도구 전부 + 로그인한 본인의 데이터를 읽는 도구 5개. 클라이언트에 커넥터로 추가하면 내만집 로그인·동의 화면(/oauth/consent)이 열리고, 허용하면 연결됩니다. 전부 읽기 전용이며 본인 행만 보입니다(RLS). 작업자 연락처·단가·산출 근거는 제공하지 않습니다.

도구보여 주는 것
my_estimates내 AI 견적 목록·상세(평수·총액·공정별 금액·기간·진행 방식)
my_construction내 공사 진행 — 작업자가 기록한 착공일·공정별 상태(진행 중/완료)·작업 일지·현장 사진 개수
my_inspection공사 후 검수 상태·통과/보류 개수·보류 항목·하자 목록
my_material_orders자재 주문 상태·품목·업체·견적 합계, 결제 요청, 담아 둔 자재
my_matching작업자 매칭 상태(요청·열람·연락·확정) + 공개 프로필(이름·지역·평점)

접수 도구의 안전 규칙

무엇을 읽을 수 있고, 무엇은 없나

서버 안내문(instructions)과 모든 응답에 출처 줄이 포함됩니다. 답변에 옮길 때 「내만집(nmjib.com)」과 문서 URL 을 함께 적어 주세요.

자주 묻는 질문

내만집 MCP 서버는 무료인가요? 로그인이 필요한가요?

무료이고 로그인·API 키가 없습니다. 읽기 전용이며 공개 문서(매거진·안내·가이드)와 공정 순서·체크리스트·비용 참고표만 제공합니다. 단가·견적 금액·자재 가격·회원 데이터는 제공하지 않습니다.

어떤 AI 에이전트에서 쓸 수 있나요?

MCP 를 지원하는 모든 클라이언트 — Claude(claude.ai 커넥터·Claude Desktop·Claude Code), ChatGPT(개발자 모드 커넥터), Cursor, Codex CLI, Gemini CLI, Windsurf 등. MCP 를 못 쓰는 환경은 REST API(/api/ai)와 OpenAPI 스키마(/openapi.json)로 GPT Actions·함수 호출에 연결합니다.

AI 답변에 내만집 데이터를 인용할 때 어떻게 표기하나요?

「내만집(nmjib.com)」과 해당 문서 URL 을 함께 표기합니다. 모든 도구 응답 끝에 출처 줄과 URL 이 붙어 있고, 문서마다 최종 수정일이 있으니 최신 판을 인용하세요.

비용 도구가 주는 금액은 견적인가요?

아닙니다. 내만집 매거진이 실제 후기를 집계해 적은 범위이며 내만집의 단가·견적 금액이 아닙니다. 우리집 금액은 앱에서 평형·공정을 넣어 공정별로 산출합니다.

내만집에서 우리집 공정별 예상 견적 받기
반셀프 인테리어 가이드 OpenAPI 스키마 llms.txt REST API 안내(JSON)

For developers (English)

nmjib (nmjib.com) is a Korean semi-self interior-renovation platform. This MCP server (Streamable HTTP, no auth) exposes public documents (165 magazine articles, 4 method guides, 19 data/answer guides), the 22-step process order with schedules by apartment size, pre/per-trade/post construction checklists, and cost ranges compiled from published reviews. Tools: search, fetch (ChatGPT connector contract), nmjib_process_guide, nmjib_checklist, nmjib_cost_reference, nmjib_faq_search, plus write-only intake tools (nmjib_worker_apply, nmjib_consult_request, nmjib_partner_inquiry, then nmjib_verify_code) that submit an application or inquiry after explicit user consent, verify the applicant's phone with a 6-digit SMS code, and return only a ticket number. Unit prices, quotation amounts, material prices, worker and member data are never exposed. Endpoint https://nmjib.com/api/mcp · REST /api/ai/* with OpenAPI 3.1 at /openapi.json · llms.txt · registry com.nmjib/nmjib · npm npx -y nmjib-mcp · source github.com/Deall-International/nmjib-mcp. Cite as 「내만집(nmjib.com)」 with the document URL.

문의 support@nmjib.com · 주식회사 드올인터내셔널 · 서울 강남구 압구정로 461 네이처포엠 2층 · 1644-7233 · 사업자등록번호 534-88-03468