# 엑셀 VBA 자동화 코드 점검 담당 (RC-127) 사용 설명서

영역: O. 문서와 데이터를 정리하고 싶다

> 에이전트 가이드는 전문가를 대체하지 않습니다. 결과물은 초안이며, 최종 판단과 외부 실행은 사용자와 전문가가 합니다.

## 무엇을 해 주나요
실제 데이터 대신 시트 구조만 설명받아 엑셀 VBA 코드 초안을 쓰거나 기존 코드를 점검하는 AI 직원입니다. 데이터가 내 컴퓨터 밖으로 나가지 않도록 돕고, 실행은 사용자가 백업본에서 직접 합니다.

결과물: VBA 코드 초안, 코드 점검 결과, 실행 전 안전 체크리스트

성공 기준: VBA 코드 초안, 코드 점검 결과, 실행 전 안전 체크리스트가 모두 들어 있고, 검수 포인트의 ✗ 항목이 해소되었으며, 확인 필요 사항이 사용자 자료나 사내 IT·보안 담당자 확인으로 정리된 상태.

## 추천 방식: ChatGPT (지시문 복사)
일반 업무 문서·점검표 작업이라 지시문과 자료를 붙여넣는 ChatGPT 방식이 가장 간단합니다. (업무 흐름 기준 추천이며 모델 성능 비교가 아닙니다.)

## 준비물

| 항목 | 필수 | 용도 | 준비 방법 | 단계 | 상태 |
|---|---|---|---|---|---|
| 웹 브라우저 | 필수 | 초안용 | 설치할 앱 없음. 최신 브라우저로 접속 | 준비 | 사용 가능 |
| 자료: 하려는 작업과 시트 구조 | 필수 | 초안용 | 예: 시트 이름, 열 구성, 원하는 결과 (실제 데이터 값은 넣지 않기) | 자료 연결 | 사용자가 직접 준비 |
| 자료: 점검할 기존 코드 | 선택 | 초안용 | 예: 이미 가지고 있는 VBA 코드 | 자료 연결 | 사용자가 직접 준비 |
| Microsoft Excel(데스크톱) | 필수 | 실행용 | 사용자가 VBA 편집기에서 직접 붙여넣고 실행, 매크로 설정은 [공식 문서 확인] | 실행 | 사용자가 직접 준비 |
| 사내 IT·보안 담당자 검토 | 필수 | 검토용 | 최종 사용·제출 전 사용자가 직접 의뢰. 필요하면 전문가 상담 연결 요청 | 검수/상담 | 사용자가 직접 준비 |

## 입력 예시

- **하려는 작업과 시트 구조** (필수): 지점별 시트 5개(강남, 판교, 수원, 인천, 대전), 열: 날짜, 품목, 수량, 금액. 모든 시트를 "취합" 시트에 아래로 이어 붙이고 품목별 합계 표 만들기
- **점검할 기존 코드** (선택): Sub 취합() 으로 시작하는 30줄 코드, 실행하면 머리글이 반복해서 붙는 문제

## 빠진 자료 점검

- 하려는 작업과 시트 구조 항목이 비어 있거나 예시 그대로가 아닌지
- 파일 삭제·외부 전송·자동 저장 덮어쓰기 코드가 없는지 확인
- 시트 이름이 사용자 입력과 정확히 일치하는지 확인

## 자료·기준 준비

- 공유·사용 권한이 있는 자료만 씁니다(사내 매뉴얼, 자문 결과 요약, 판단 기준, 과거 승인 사례).
- 주민등록번호·계좌번호·고객 연락처 등 민감정보는 지우거나 가립니다.
- 회사 기준은 회사 전문성 팩(업무 절차·판단 기준·양식·사례)에 넣으면 사이트 실행에서 기본 지침보다 우선 적용됩니다. 편집은 구독 중일 때 가능합니다.
- 이 에이전트의 핵심 전문성: 절차·양식. 해당 기준 자료를 우선 준비합니다.

## 작업 순서

1. 시트 이름·열 구성·원하는 결과를 정리해 처리 흐름을 단계로 적음
2. 각 단계를 Sub 단위 VBA 코드 초안으로 작성하고 줄마다 주석 추가
3. 기존 코드가 있으면 반복 실행·빈 행·머리글 중복 같은 문제를 찾아 점검 결과 작성
4. 백업, 매크로 보안, 테스트 실행 순서를 담은 실행 전 안전 체크리스트 작성

## 넘기기 전 점검

- [ ] 파일 삭제·외부 전송·자동 저장 덮어쓰기 코드가 없는지 확인
- [ ] 시트 이름이 사용자 입력과 정확히 일치하는지 확인
- [ ] 빈 시트나 빈 행에서 오류가 나지 않도록 처리했는지 확인
- [ ] 매크로 보안 설정 안내는 [공식 문서 확인]으로 남김

## 결과물 소제목

- 처리 흐름
- VBA 코드 초안
- 코드 점검 결과
- 실행 전 안전 체크리스트

## 결과 예시 (견본, 실제 실행 결과 아님)

지점 5개 시트 취합 VBA 초안과 점검 예시

### VBA 코드 초안
- Sub 취합(): 각 지점 시트를 순서대로 읽음
- 머리글은 첫 시트에서 한 번만 복사
- 품목별 합계 표는 별도 Sub로 분리

### 코드 점검 결과
- 기존 코드: 반복문마다 1행 복사 -> 머리글 중복 원인
- 수정: 2행부터 복사하도록 변경

### 실행 전 안전 체크리스트
- 백업본에서 실행
- 취합 시트 기존 내용 지움 여부 확인

## 자주 생기는 문제

- **필수 항목이 비어 실행되지 않음** → 필수 입력 항목(하려는 작업과 시트 구조)을 채웁니다. 무엇을 넣을지 모르면 "예시로 채우기"를 먼저 봅니다.
- **"AI 제공자가 연결되지 않아 실행하지 않았습니다"** → 운영자가 AI 제공자를 연결하기 전입니다. 차감되지 않았으니 GPT·Claude 지시문 방식으로 진행할 수 있습니다.
- **무료 체험 1회를 사용함** → 개별 구독 월 19,000원(월 50회) · 문서·데이터 직무 영역 팀 월 99,000원 · 전체 월 990,000원 중 하나로 계속 씁니다. 카드 결제는 가능입니다.
- **MCP·API에서 401 또는 구독 오류** → 키 범위(mcp, runs:write)와 이 에이전트를 포함하는 구독(개별·직무 영역·전체)이 활성인지 확인합니다. 개별 구독은 기간당 50회입니다.
- **결과에 "처리 흐름" 같은 소제목이 빠짐** → "답변 형식 그대로 다시 써 줘" 또는 수정 요청으로 다시 받습니다.
- **사내 IT·보안 담당자 판단이 필요한 내용이 결론처럼 보임** → 초안으로만 쓰고 사내 IT·보안 담당자 검토 또는 전문가 상담 연결을 요청합니다.

## 가장 짧은 시작

하려는 작업과 시트 구조에 다음처럼 적고 실행해 보세요: 지점별 시트 5개(강남, 판교, 수원, 인천, 대전), 열: 날짜, 품목, 수량, 금액. 모든 시트를 "취합" 시트에 아래로 이어 붙이고 품목별 합계 표 만들기

## 사람이 직접 하는 일

- 엑셀 파일이나 실제 데이터를 받지 않으며 시트 구조 설명만 받음
- 매크로를 실행하거나 파일을 수정하지 않음
- 회사 보안 정책 위반 여부를 판단하지 않음
- 외부 전송·파일 삭제 코드는 작성하지 않음
- 외부 도구·계정에서의 실제 실행·설치·발송 (사용자가 검토 후 직접 진행)
- 사내 IT·보안 담당자의 최종 판단

## 이용 조건

- 공개 사용 설명서와 업무 지시문은 무료입니다.
- 사이트 무료 체험은 에이전트마다 1회(AI 실행 연결 시).
- 구독: 개별 구독 월 19,000원(월 50회) · 문서·데이터 직무 영역 팀 월 99,000원 · 전체 월 990,000원. 모든 레벨 1회 호출 = 1회, 후속 질문도 1회.
- 여러 상품을 함께 구독할 수 있고, 직무 영역·전체 구독이 있으면 개별 구독의 50회보다 우선해 호출 총량 제한 없이 씁니다(남용 방지용 속도 제한은 있음).
- MCP 연결·실행 API·회사 팩 편집: 구독 중. 개인 팩: 직무 영역·전체 구독. 사용자 초대(5명): 전체 구독.
- 카드 결제: 가능.
- ChatGPT·Claude 이용 요금은 Recrua 결제에 포함되지 않습니다.

## AI 어시스턴트 안내

이 에이전트는 업무를 돕는 AI 어시스턴트입니다. 결과의 정확성·완결성이나 최종 확정을 보장하지 않으며, 중요한 판단은 관련 전문가의 검토가 필요합니다.
전문가 상담 연결: /consultation?agent=RC-127&area=%EB%AC%B8%EC%84%9C%C2%B7%EB%8D%B0%EC%9D%B4%ED%84%B0

## 우리 사이트에서 쓰기

로그인한 내 워크스페이스에서 엑셀 VBA 자동화 코드 점검 담당을(를) 내 팀에 추가하고 채팅으로 맡깁니다. 대화·첨부 자료·사용량이 이 사이트에 남습니다.

1. **준비 · 에이전트와 상태 확인** — 프로필에서 하는 일·하지 않는 일을 보고, AI 실행 상태(연결 안 됨)와 무료 체험 1회를 확인합니다.
2. **자료 연결 · 입력과 기준 연결** — 필수 입력 항목(하려는 작업과 시트 구조)을 채웁니다. "예시로 채우기"로 형식을 익히고, 요금제가 있으면 회사 팩에 판단 기준을 등록합니다.
3. **실행 · 채팅으로 맡기기** — VBA 코드 초안, 코드 점검 결과, 실행 전 안전 체크리스트 초안을 받고 후속 질문으로 고칩니다. 메시지 1개 = 1회 호출, 제공자 오류 시 복구.
4. **검수/상담 · 검수·승인** — 검수 포인트 표에서 "파일 삭제·외부 전송·자동 저장 덮어쓰기 코드가 없는지 확인" 등을 확인하고 승인·반려합니다. 최종 사용 전 사내 IT·보안 담당자 검토.

- 가입·로그인한 뒤 프로필에서 "내 팀에 추가"를 누릅니다.
- /agents/127/chat 에서 대화를 시작하고 필수 자료(하려는 작업과 시트 구조)를 메시지로 쓰거나 파일로 첨부합니다.
- 답변을 보고 후속 질문으로 고칩니다. 메시지마다 1회 호출이며, AI 제공자 오류로 실패하면 차감을 되돌립니다.
- 무료 체험 1회 뒤에는 개별 구독 월 19,000원(월 50회) · 문서·데이터 직무 영역 팀 월 99,000원 · 전체 월 990,000원 중 하나로 계속 씁니다. 구조화된 입력 화면은 /agents/127/work 에 그대로 있습니다.

## GPT에서 쓰기

지시문을 복사해 ChatGPT에 붙여 쓰는 방법이 기본입니다. 결과·사용량·팩은 Recrua에 기록되지 않습니다.

1. **준비 · ChatGPT 계정** — 사용 중인 ChatGPT 계정을 씁니다. 외부 AI 요금은 Recrua 결제에 포함되지 않습니다.
2. **자료 연결 · 지시문 + 내 자료** — 아래 지시문을 붙이고 필수 입력 항목(하려는 작업과 시트 구조)을 채웁니다. 파일 첨부 시 민감정보를 가립니다.
3. **실행 · ChatGPT에서 작성** — VBA 코드 초안 등 결과물을 받습니다. Recrua 실행 기록·사용량과는 별개입니다.
4. **검수/상담 · 점검표 대조** — "매크로 보안 설정 안내는 [공식 문서 확인]으로 남김"를 포함한 점검 기준으로 직접 확인하고, 남는 판단은 전문가 상담을 요청합니다.

- 아래 "업무 지시문"을 복사해 새 대화에 붙여 넣습니다.
- [여기에 입력] 자리를 내 자료로 바꿉니다. 회사 기준이 있으면 지시문 끝에 덧붙입니다.
- 답변이 네 제목 형식을 지키지 않으면 "답변 형식 그대로 다시 써 줘"라고 요청합니다.
- ChatGPT 웹 앱에서 Recrua MCP 직접 연결은 준비 중입니다. ChatGPT의 사용자 정의 MCP는 OAuth 또는 인증 없음 방식만 문서화되어 있고, Recrua는 Bearer 키 방식이라 지금은 연결할 수 없습니다.
- Codex(CLI)는 Bearer 키를 환경 변수로 읽는 HTTP MCP 설정을 지원합니다. 아래 설정은 공식 문서 기준 예시이며 실제 계정 연결로 검증하지 않았습니다. 이 방식은 Recrua 서버에서 실행·기록·사용량 차감이 일어납니다(이 에이전트를 포함하는 구독 필요).

### 업무 지시문 (ChatGPT·Claude 공용) (사용 가능)

공개 기본 지시문입니다. 결제 없이 쓸 수 있습니다.

```
당신은 "엑셀 VBA 자동화 코드 점검 담당" 역할로 일합니다.
맡은 과제: 데이터 업로드 없이 엑셀 VBA로 취합을 자동화하고 싶어요
만들 결과물: VBA 코드 초안, 코드 점검 결과, 실행 전 안전 체크리스트

[작업 순서]
1. 시트 이름·열 구성·원하는 결과를 정리해 처리 흐름을 단계로 적음
2. 각 단계를 Sub 단위 VBA 코드 초안으로 작성하고 줄마다 주석 추가
3. 기존 코드가 있으면 반복 실행·빈 행·머리글 중복 같은 문제를 찾아 점검 결과 작성
4. 백업, 매크로 보안, 테스트 실행 순서를 담은 실행 전 안전 체크리스트 작성

[넘기기 전 점검]
- 파일 삭제·외부 전송·자동 저장 덮어쓰기 코드가 없는지 확인
- 시트 이름이 사용자 입력과 정확히 일치하는지 확인
- 빈 시트나 빈 행에서 오류가 나지 않도록 처리했는지 확인
- 매크로 보안 설정 안내는 [공식 문서 확인]으로 남김

[답변 형식] "## 핵심 결론", "## 본문", "## 확인 필요 사항", "## 다음 단계" 네 제목을 이 순서로 쓰고, "## 본문" 안에서 다음 소제목을 씁니다: 처리 흐름 / VBA 코드 초안 / 코드 점검 결과 / 실행 전 안전 체크리스트

[지켜야 할 것]
- 근거 없는 수치·조문·사례를 만들지 말고, 확실하지 않은 내용은 "확인 필요 사항"에 분리합니다.
- '보장', '완벽', '100%' 같은 단정 표현을 쓰지 않습니다.
- 결과물은 초안입니다. 발송·제출·게시·설치·실행을 했다고 쓰지 않습니다. 그 일은 사용자가 검토 후 직접 합니다.
- 이 업무는 사내 IT·보안 담당자 검토가 필요합니다. 첫 줄에 "초안·참고용, 사내 IT·보안 담당자 검토 필요"를 적습니다.
- 하지 않는 일: 엑셀 파일이나 실제 데이터를 받지 않으며 시트 구조 설명만 받음, 매크로를 실행하거나 파일을 수정하지 않음, 회사 보안 정책 위반 여부를 판단하지 않음, 외부 전송·파일 삭제 코드는 작성하지 않음, 외부 도구·계정에서의 실제 실행·설치·발송 (사용자가 검토 후 직접 진행), 사내 IT·보안 담당자의 최종 판단

[내 자료] 아래 항목을 채워 함께 보냅니다. 주민등록번호·계좌번호 등 민감정보는 가립니다.
- 하려는 작업과 시트 구조 (필수): [여기에 입력 — 예: 지점별 시트 5개(강남, 판교, 수원, 인천, 대전), 열: 날짜, 품목, 수량, 금액. 모든 시트를 "취합" 시트에 아래로 이어 붙이고 품목별 합계 표 만들기]
- 점검할 기존 코드 (선택): [여기에 입력 — 예: Sub 취합() 으로 시작하는 30줄 코드, 실행하면 머리글이 반복해서 붙는 문제]
```

### ChatGPT 웹 MCP 연결 (준비 중)

지원되지 않는 방식(키를 다른 칸에 넣기 등)을 쓰지 마세요.
공식 문서: https://developers.openai.com/api/docs/guides/custom-mcp-server

```
준비 중: Recrua MCP는 Bearer 키 인증을 쓰고, ChatGPT 사용자 정의 MCP는 OAuth/인증 없음만 지원합니다.
```

### Codex config.toml (MCP) (설정 예시 · 미검증)

RECRUA_API_KEY 환경 변수에 /settings에서 발급한 MCP 범위 키를 넣습니다. 키를 파일에 직접 쓰지 마세요.
공식 문서: https://learn.chatgpt.com/docs/extend/mcp?surface=cli

```toml
[mcp_servers.recrua]
url = "https://recrua.store/api/mcp"
bearer_token_env_var = "RECRUA_API_KEY"
```

## Claude에서 쓰기

지시문 복사로 바로 쓰거나, 권한이 있으면 Recrua MCP를 사용자 정의 커넥터·Claude Code에 연결해 Recrua 서버로 실행합니다.

1. **준비 · Claude 계정·키** — 지시문 방식은 Claude 계정만 있으면 됩니다. MCP 연결은 구독과 /settings 키가 필요합니다.
2. **자료 연결 · 지시문 또는 커넥터** — 지시문을 붙이거나, 커넥터 URL https://recrua.store/api/mcp 에 요청 헤더 Authorization: Bearer 키를 설정합니다.
3. **실행 · list_agents → run_agent** — MCP라면 run_agent에 agent_no 127와 하려는 작업과 시트 구조 입력을 넘깁니다. 실행·기록·사용량은 Recrua 서버에서 처리됩니다.
4. **검수/상담 · 검수 포인트 확인** — 결과 끝 검수 포인트에서 확인 필요 항목을 해소하고, 사내 IT·보안 담당자 검토 또는 전문가 상담을 요청합니다.

- 지시문 방식: "업무 지시문"을 복사해 Claude 대화에 붙이고 내 자료를 채웁니다. Recrua 기록·사용량과는 별개입니다.
- 사용자 정의 커넥터: Claude의 커넥터 설정에서 사용자 정의 커넥터를 추가하고 URL과 요청 헤더(Authorization: Bearer + 내 키)를 넣습니다. 이용 가능 여부는 Claude 계정·워크스페이스 권한에 따라 다릅니다.
- Claude Code: 아래 명령으로 HTTP MCP를 추가하고 /mcp로 도구 상태를 확인합니다. 키는 환경 변수로만 넘깁니다.
- 연결 후 list_agents로 번호를 확인하고 run_agent에 정확한 번호와 입력 키를 넘깁니다. 호스트(Claude)가 바뀌어도 Recrua의 생성 방식은 바뀌지 않습니다.

### 업무 지시문 (ChatGPT·Claude 공용) (사용 가능)

공개 기본 지시문입니다. 결제 없이 쓸 수 있습니다.

```
당신은 "엑셀 VBA 자동화 코드 점검 담당" 역할로 일합니다.
맡은 과제: 데이터 업로드 없이 엑셀 VBA로 취합을 자동화하고 싶어요
만들 결과물: VBA 코드 초안, 코드 점검 결과, 실행 전 안전 체크리스트

[작업 순서]
1. 시트 이름·열 구성·원하는 결과를 정리해 처리 흐름을 단계로 적음
2. 각 단계를 Sub 단위 VBA 코드 초안으로 작성하고 줄마다 주석 추가
3. 기존 코드가 있으면 반복 실행·빈 행·머리글 중복 같은 문제를 찾아 점검 결과 작성
4. 백업, 매크로 보안, 테스트 실행 순서를 담은 실행 전 안전 체크리스트 작성

[넘기기 전 점검]
- 파일 삭제·외부 전송·자동 저장 덮어쓰기 코드가 없는지 확인
- 시트 이름이 사용자 입력과 정확히 일치하는지 확인
- 빈 시트나 빈 행에서 오류가 나지 않도록 처리했는지 확인
- 매크로 보안 설정 안내는 [공식 문서 확인]으로 남김

[답변 형식] "## 핵심 결론", "## 본문", "## 확인 필요 사항", "## 다음 단계" 네 제목을 이 순서로 쓰고, "## 본문" 안에서 다음 소제목을 씁니다: 처리 흐름 / VBA 코드 초안 / 코드 점검 결과 / 실행 전 안전 체크리스트

[지켜야 할 것]
- 근거 없는 수치·조문·사례를 만들지 말고, 확실하지 않은 내용은 "확인 필요 사항"에 분리합니다.
- '보장', '완벽', '100%' 같은 단정 표현을 쓰지 않습니다.
- 결과물은 초안입니다. 발송·제출·게시·설치·실행을 했다고 쓰지 않습니다. 그 일은 사용자가 검토 후 직접 합니다.
- 이 업무는 사내 IT·보안 담당자 검토가 필요합니다. 첫 줄에 "초안·참고용, 사내 IT·보안 담당자 검토 필요"를 적습니다.
- 하지 않는 일: 엑셀 파일이나 실제 데이터를 받지 않으며 시트 구조 설명만 받음, 매크로를 실행하거나 파일을 수정하지 않음, 회사 보안 정책 위반 여부를 판단하지 않음, 외부 전송·파일 삭제 코드는 작성하지 않음, 외부 도구·계정에서의 실제 실행·설치·발송 (사용자가 검토 후 직접 진행), 사내 IT·보안 담당자의 최종 판단

[내 자료] 아래 항목을 채워 함께 보냅니다. 주민등록번호·계좌번호 등 민감정보는 가립니다.
- 하려는 작업과 시트 구조 (필수): [여기에 입력 — 예: 지점별 시트 5개(강남, 판교, 수원, 인천, 대전), 열: 날짜, 품목, 수량, 금액. 모든 시트를 "취합" 시트에 아래로 이어 붙이고 품목별 합계 표 만들기]
- 점검할 기존 코드 (선택): [여기에 입력 — 예: Sub 취합() 으로 시작하는 30줄 코드, 실행하면 머리글이 반복해서 붙는 문제]
```

### Claude 사용자 정의 커넥터 (설정 예시 · 미검증)

키는 커넥터 설정 칸에만 넣고 대화·문서에 붙이지 마세요.
공식 문서: https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp

```
URL: https://recrua.store/api/mcp
요청 헤더: Authorization = Bearer <설정에서 발급한 rk_ 키>
```

### Claude Code 명령 (설정 예시 · 미검증)

실행 후 Claude Code에서 /mcp로 연결 상태를 확인합니다.
공식 문서: https://code.claude.com/docs/en/mcp

```bash
export RECRUA_API_KEY="<설정에서 발급한 키>"
claude mcp add --transport http recrua https://recrua.store/api/mcp --header "Authorization: Bearer $RECRUA_API_KEY"
```

### run_agent 호출 예 (설정 예시 · 미검증)

필수 입력 키만 담은 예시입니다. 실제 값은 내 자료로 바꿉니다.

```json
{
 "name": "run_agent",
 "arguments": {
  "agent_no": 127,
  "inputs": {
   "situation": "지점별 시트 5개(강남, 판교, 수원, 인천, 대전), 열: 날짜, 품목, 수량, 금액. 모든 시트를 \"취합\" 시트에 아래로 이어 붙이고 품목별 합계 표 만들기"
  }
 }
}
```

## 실행 API (구독 중, 공통)

### 실행 API 요청 (구독 중) (설정 예시 · 미검증)

runs:write 범위 키가 필요합니다. 요청 본문은 recrua-request.json 파일로 내려받아 값을 바꿉니다.

```bash
curl -X POST https://recrua.store/api/v1/runs \
  -H "Authorization: Bearer $RECRUA_API_KEY" \
  -H "Content-Type: application/json" \
  --data @recrua-request.json
```

### recrua-request.json (설정 예시 · 미검증)

agent_no와 입력 키는 이 에이전트의 실제 입력 항목입니다.

```json
{
 "agent_no": 127,
 "inputs": {
  "situation": "지점별 시트 5개(강남, 판교, 수원, 인천, 대전), 열: 날짜, 품목, 수량, 금액. 모든 시트를 \"취합\" 시트에 아래로 이어 붙이고 품목별 합계 표 만들기",
  "code": "Sub 취합() 으로 시작하는 30줄 코드, 실행하면 머리글이 반복해서 붙는 문제"
 }
}
```