VBAFerry
Connect

연결 방법

처음 한 번만 하면 됩니다. 순서대로 따라 하세요. 10분 정도 걸립니다.

1. AI 앱에 연결하기

Claude Code

  1. 터미널에서 실행
    claude mcp add --transport http --scope user vbaferry https://vbaferry.ilhae.ai/mcp
  2. Claude Code에서 /mcp → vbaferry → 로그인(Authenticate)
  3. 브라우저에 동의 화면이 뜨면 허용하고 GitHub 로그인

claude.ai · Claude 데스크톱

  1. 설정 → 커넥터 → 사용자 지정 커넥터 추가
  2. 주소에 https://vbaferry.ilhae.ai/mcp 를 넣고 연결
  3. 동의 화면에서 허용하고 GitHub으로 로그인

원격 MCP 서버를 지원하는 다른 앱도 같은 주소로 연결합니다. GitHub에서는 이름과 id만 확인합니다.

2. Excel 준비하기 (Windows)

  1. 매크로 파일을 받습니다.
  2. Excel 옵션 → 보안 센터 → 보안 센터 설정 → 매크로 설정에서 "VBA 프로젝트 개체 모델에 안전하게 액세스할 수 있음"을 켭니다.
  3. 빈 통합 문서를 하나 만들어 Builder용으로 저장(.xlsm)하고, VBE(Alt+F11)에서 [파일] → [파일 가져오기]로 Builder 3개 + modCloudSync.bas 를 넣습니다.
  4. 또 하나를 Restorer용으로 만들어 Restorer 2개를 넣습니다. Restorer는 작업할 통합 문서와 다른 파일에 있어야 합니다.

작업할 통합 문서는 반드시 복사본으로 먼저 시험하세요. 가져오기(Restorer)는 기존 모듈을 교체합니다.

3. 처음 올리기

  1. AI에게 말합니다: "VBAFerry에 '매출보고서' 프로젝트를 만들고 동기화 토큰을 줘"
  2. 작업할 통합 문서를 저장하고 활성화한 상태에서 Builder 통합 문서의 CloudSyncSetup 매크로를 실행해 서버 주소(https://vbaferry.ilhae.ai)와 토큰을 넣습니다. 토큰은 Windows 사용자 레지스트리에 저장되고 통합 문서에는 들어가지 않습니다.
  3. ExportRepositoryForActiveWorkbook (Builder)로 내보낸 뒤 CloudPush 를 실행합니다.

4. 평소에는 이렇게

  1. AI에게 일을 맡깁니다: "매출보고서 프로젝트에서 월별 집계가 느린 원인을 찾아 고쳐줘. 다 고치면 validate_project로 검사해줘"
  2. 바뀐 내용을 확인합니다: "diff_since_sync로 바뀐 내용 보여줘"
  3. 작업할 통합 문서를 활성화하고 CloudPull → 이어서 Restorer로 가져오기
  4. VBE에서 [디버그] → [VBAProject 컴파일], 실제 동작 확인

Excel에서 직접 코드를 고쳤다면 Builder로 다시 내보내고 CloudPush 하세요. AI가 고친 내용을 아직 받지 않았다면 덮어쓰기 전에 경고가 뜹니다.

이렇게 말해 보세요

  • "VBAFerry 프로젝트 목록 보여줘"
  • "Module1의 For 반복문을 배열로 바꿔서 빠르게 해줘"
  • "UserForm1의 버튼들을 오른쪽 아래로 정렬해줘"
  • "어제 고치기 전 버전으로 Module2를 되돌려줘"
  • "동기화 토큰을 모두 폐기해줘"