IBSheet8을 사용하시는 개발자분들이 Claude Code · Cursor · GitHub Copilot 등 AI 코딩 도구와 함께 IBSheet8을 보다 정확하게 개발하실 수 있도록, IBSheet8 공식 MCP 서버를 오픈하였습니다.

01MCP 서버란

MCP(Model Context Protocol)는 AI 도구가 외부의 지식·기능을 표준 방식으로 호출할 수 있도록 정의된 개방형 프로토콜입니다.

IBSheet8 MCP 서버는 이 규격에 따라 만들어진 IBSheet8 전용 지식 서버로, AI 코딩 도구가 코드를 작성하는 도중 IBSheet8 공식 매뉴얼을 실시간으로 검색·조회할 수 있게 합니다.

한 번 등록해 두면 AI가 코드를 작성할 때마다 매뉴얼을 참조하므로, 존재하지 않는 API를 임의로 생성하지 않고 실제 매뉴얼에 있는 API·옵션만 사용하게 됩니다.

02도입 배경

Claude, Copilot, Cursor 등 AI 코딩 도구가 널리 사용되고 있으나, 이러한 도구는 IBSheet8을 별도로 학습한 적이 없어 다음과 같은 문제가 발생하곤 합니다.

  • 존재하지 않는 API·속성을 그럴듯하게 지어냄 (할루시네이션)
  • IBSheet 이전 버전의 이벤트·API를 최신 버전인 것처럼 사용
  • 매뉴얼상 정확한 옵션 대신 유사해 보이는 이름으로 코드 작성

본 서버는 AI 도구가 매뉴얼을 직접 참조할 수 있는 경로를 제공하여 이러한 문제를 해결합니다.

03동작 방식

개발자가 AI 도구에게 IBSheet8 관련 요청을 하면, AI는 필요에 따라 MCP 서버를 호출하여 매뉴얼을 조회한 뒤 응답을 생성합니다.

개발자     "달력에 오늘 버튼 넣어줘"
   ↓
AI 도구  ──▶  MCP 서버   search_docs("달력 버튼")
   ↓
AI 도구  ◀──  MCP 서버   "CalendarButtons 속성. 1=오늘, 2=취소..."
   ↓
개발자     매뉴얼 기반의 정확한 코드

제공되는 도구(tool)는 다음 3종입니다.

도구역할
search_docs매뉴얼 키워드 검색 (한/영 동의어 지원)
get_apiAPI 문서 원문 조회
list_apis전체 API 목록 조회
? 본 서버는 자체 LLM을 포함하지 않으며, 매뉴얼 검색·조회 기능만 제공합니다. 추론은 개발자가 연결한 AI 도구에서 수행되므로 별도의 API 키·토큰 비용은 발생하지 않습니다.

04도입 효과 (실제 검증 사례)

동일한 AI 모델, 동일한 프롬프트, 동일한 입력 자료를 기준으로, MCP 서버 연결 여부만을 변수로 두고 진행한 검증 결과 중 일부입니다.

사례 1. 엑셀 파일로 시트 생성
"다운로드 폴더에 test1.xlsx 파일을 IBSheet8로 만들어줘. sheet_div에 넣을 거야."
❌ 연결 전
존재하지 않는 HeaderMode, Body 등의 속성을 지어냈으며, css·locale 파일을 import하지 않아 실행 시 오류 발생
✅ 연결 후
요청한 엑셀 파일에 맞춰 시트 생성 로직을 정확히 작성하고, 스스로 판단하여 유용한 HeaderMerge 속성까지 추가
사례 2. 조건부 행 색상 (수식)
 "데이터 조회할 때 시작일이 2001년 전이면 행을 빨간색으로 칠해줘."
❌ 연결 전
IBSheet 7의 onSearchEnd 이벤트를 사용하여 실제로 동작하지 않는 코드 작성
✅ 연결 후
attribute + formula를 이용해 요청 사항을 정확히 구현
사례 3. 트리 시트의 DataMerge (실제 기술지원 문의)
 "index.html 파일에 지금 DataMerge 했는데 머지가 이상해. 버그야?"
❌ 연결 전
"undefined/null 값은 병합 대상으로 처리하지 않는 경우가 있다"는 사실과 다른 원인을 안내하고 DefaultValue를 추가
✅ 연결 후
트리 시트에서는 같은 depth 안에서만 머지되며 레벨이 다르면 머지가 분리된다는 실제 동작 원리를 정확히 설명
사례 4. 언어(locale) 설정 UI
 "왼쪽 상단에 select 박스 만들고, 시트 언어 설정 가능하게 만들어줘."
❌ 연결 전
존재하지 않는 loadLocale API를 사용하여 구현
✅ 연결 후
setLocale로 정확히 구현하고, 언어팩 파일의 인코딩 문제까지 파악해 안내
총 7종의 시나리오에 대해 검증한 결과, 연결 전에는 존재하지 않는 API·속성이 반복적으로 생성된 반면, 연결 후에는 모든 시나리오에서 실제 매뉴얼에 근거한 코드가 생성되었습니다.

05지원 도구

MCP를 지원하는 대부분의 AI 코딩 도구에서 사용하실 수 있습니다.

  • Claude Code
  • Cursor
  • Visual Studio Code (GitHub Copilot · Agent Mode)
  • Windsurf
  • Gemini CLI
  • Codex CLI (OpenAI)
  • Claude Desktop
  • JetBrains IDE (IntelliJ IDEA 등)

06서버 정보 및 등록 방법

서버 주소 (시범운영)https://mcp.ibsheet.com/ibsheet8
전송 방식Streamable HTTP
인증없음 (별도 키·로그인 불필요)
비용무료
⚠️ 본 서버는 현재 사내 시범운영 중입니다.
MCP 서버 URL이 매뉴얼상의 표기와 다르니 반드시 위 시범운영 주소를 사용해 주시기 바랍니다.

등록 예시 · Claude Code

터미널에서 아래 명령을 한 줄 입력하시면 등록됩니다.

claude mcp add --transport http ibsheet8 https://mcp.ibsheet.com/ibsheet8
? 등록 후에는 AI 도구를 재시작(새 세션 시작) 해야 서버가 인식됩니다.

Claude Code 외 도구(Cursor · GitHub Copilot · Windsurf · Gemini CLI · Codex CLI · Claude Desktop · JetBrains IDE)의 등록 방법은 아래 매뉴얼을 참고해 주시기 바랍니다.

IBSheet8 매뉴얼 — AI 코딩 도구 연동 (MCP)

⚠️ 매뉴얼상의 URL(https://mcp.ibsheet.com/mcp) 대신 시범운영 주소(https://mcp.ibsheet.com/ibsheet8)를 사용해 주십시오.

07사용 방법

MCP 서버가 등록되면 별도의 설정 없이 AI 도구를 사용하실 수 있습니다. AI는 IBSheet8 관련 요청을 인식하면 자체적으로 매뉴얼을 검색합니다.

프롬프트 예시

 "IBSheet8로 조회 그리드 만들어줘. 컬럼은 이름/부서/입사일이고, 입사일엔 달력 버튼."

매뉴얼 참조를 명시적으로 유도하고 싶으신 경우에는 프롬프트에 "IBSheet8 매뉴얼을 검색해서" 라는 문구를 덧붙여 주시면 됩니다.

08피드백 및 문의

시범운영 기간 동안 사용 중 발생한 문제나 개선 의견이 있으시면 1:1 문의로 접수해 주시기 바랍니다. 품질 개선 및 매뉴얼 보강에 반영하도록 하겠습니다.