클로드 엑셀 MCP, 맥에서도 될까 — 엑셀 for Mac·넘버스에 직접 붙여 봤습니다
「클로드한테 엑셀 시키기」 글을 따라 해 보려다 멈추신 적 있으세요?
화면이 전부 윈도우입니다.
시작 메뉴, 파워셸, C:\Users\… 경로가 나와요.
맥북을 쓰는 입장에선 첫 줄부터 막힙니다.
저도 그랬습니다.
그래서 오늘 제 맥북에 공식 설치 방법 그대로 깔아 봤어요.
상위 글들이 쓰는 도구, pyhub-mcptools 입니다.
먼저 결과부터요. 설치는 됩니다.
엑셀에 붙는 순간 오류가 나요. macOS 27 이 바뀐 탓입니다.
이 글에는 세 가지를 적었습니다.
어디서 왜 막히는지, 고치면 실제로 되는지, 넘버스는 어떤지.
전부 제 맥에서 찍은 화면입니다.
시험 파일은 아래의 작은 과일가게 표예요.
클로드에게 시키기 전입니다.
매출 칸이 비어 있어요.
이걸 채우게 하는 게 이번 시험입니다
1. 결론부터 — 맥에서 된 것, 안 된 것
2026년 9월 29일, macOS 27.0 맥북에서 확인한 결과입니다.
| 해 본 것 | 결과 |
|---|---|
| 공식 설치 한 줄(macOS 용) | 된다 — 체크섬 검사까지 통과 |
| 도구 목록 보기 | 된다 — 엑셀 도구 15개 |
| 열린 엑셀 읽기·쓰기 | 안 된다 — 모든 엑셀 도구가 같은 오류 |
| 부품 하나 바꿔서 다시 | 된다 — 매출·마진 수식까지 들어감 |
| 넘버스 | 안 된다 — 넘버스용 도구가 아예 없음 |
MCP 란 «클로드에 바깥 도구를 붙이는 규격»이라는 뜻입니다.
pyhub-mcptools 는 그 약속으로 엑셀을 조종하는 도구예요.
한국 개발자 커뮤니티(파이썬사랑방)가 만들었습니다.
이 도구의 저장소는 어제(2026년 9월 28일) «보관» 처리됐습니다. 더는 고쳐지지 않는다는 뜻이에요.
오늘 난 오류도 공식 업데이트로는 안 풀립니다.
뒤에서 자세히 봅니다.
2. 준비물 — 네 가지
| 확인할 것 | 왜 |
|---|---|
| 엑셀 for Mac | 공식 문서가 «엑셀 2016 이상»을 요구합니다. 제 맥은 16.93 이에요 |
| 클로드 데스크톱 앱 | 내 맥의 앱을 부르는 도구는 데스크톱 앱에만 붙습니다. 웹은 안 돼요 |
| 터미널 | 응용 프로그램 → 유틸리티 → 터미널. 설치에 한 줄 씁니다 |
| 시험용 엑셀 파일 | 중요한 파일 말고 복사본으로. 클로드가 칸을 직접 고칩니다 |
제 맥은 애플 실리콘 맥북 프로에 macOS 27.0 입니다.
엑셀 for Mac 은 16.93, 넘버스는 14.5 예요.
클로드 데스크톱은 2.9939 입니다.
3. 따라 하기 — 공식 방법 그대로
Step 1. 설치 한 줄
공식 문서(mcp.pyhub.kr)의 macOS 설치 명령입니다.
터미널에 붙여 넣습니다.
bash <(curl -fsSL https://raw.githubusercontent.com/pyhub-kr/pyhub-mcptools/refs/heads/main/scripts/install.sh)제 맥에서는 이렇게 끝났습니다.
파일 검사(체크섬)까지 통과했어요.
설치는 30초면 끝납니다.
마지막 줄 「이미 최신 버전(0.9.8)입니다」를 기억해 두세요.
뒤에서 중요해집니다
설치 스크립트는 셸 설정 파일에 경로 한 줄을 덧붙입니다.
파일 이름은 ~/.zshrc 예요.
저는 그 부분만 빼고 돌렸어요.
설치 폴더는 홈 아래 mcptools/pyhub.mcptools 입니다.
화면의 사용자 이름은 가렸습니다.
Step 2. 도구 목록 — 넘버스는 여기서 끝납니다
cd ~/mcptools/pyhub.mcptools
./pyhub.mcptools tools-list -v 1
도구 15개가 전부 excel_ 로 시작합니다.
넘버스를 부르는 도구는 하나도 없어요
여기서 넘버스 질문의 답이 나옵니다. 이 도구는 넘버스를 모릅니다. 넘버스에 같은 파일을 열어 두고 불러도 엑셀만 찾아요.
넘버스를 쓰는 분은 7장의 우회로를 보세요.
Step 3. 클로드 데스크톱에 등록
./pyhub.mcptools setup-add설정 파일에 pyhub 항목을 알아서 넣어 줍니다.
그다음 클로드 데스크톱을 ⌘Q 로 완전히 끄고 다시 켭니다.
앱 기록에 «서버가 연결됐다»는 줄이 찍히면 붙은 겁니다.
저도 여기까지는 문제없었어요.
Step 4. 첫 호출 — 권한 창이 뜹니다
엑셀을 처음 부르면 macOS 가 이런 창을 띄웁니다. 다른 앱이 엑셀을 조종해도 되냐고 묻는 거예요.
저는 터미널 앱에서 시험해서 그 앱 이름이 떴습니다.
클로드 데스크톱에서 쓰면 이 자리에 Claude 가 나온다고 공식 문서에 적혀 있어요
「허용」을 누릅니다.
이 창에 답하지 않고 두면 도구는 60초를 기다리다 실패합니다.
제가 처음에 그랬어요.
창이 다른 창 뒤에 숨어 있었거든요.
「허용 안 함」을 눌렀어도 다시 켤 수 있습니다.
경로는 시스템 설정 → 개인정보 보호 및 보안 → 자동화예요.
공식 설치 문서 6번 항목에 나오는 방법이에요.
Step 5. 그리고 오류
권한을 주고 과일가게 파일을 연 채로 다시 불렀습니다.
열린 파일 목록 보기, 값 읽기.
둘 다 같은 오류가 났어요.
./pyhub.mcptools tools-call excel_get_opened_workbooks
«숫자로 바꿀 수 없는 글자»라는 오류입니다.
엑셀 도구 15개가 전부 이 자리에서 멈춰요
클로드 데스크톱이 받는 답도 이것과 같습니다.
앱이 도구를 부르는 통로(MCP)로 직접 불러 봤어요.
똑같은 오류 문장이 돌아왔습니다.
채팅창에서 시키면 클로드는 이 오류를 그대로 받습니다.
그러니 엑셀을 만질 수가 없어요.
4. 왜 막히나 — macOS 27 이 바꾼 한 줄
그림으로 보면 이렇습니다.
끊기는 곳은 클로드도, 엑셀도 아닙니다.
가운데 부품 «xlwings» 예요
pyhub 는 엑셀을 직접 만지지 않습니다.
안에 든 xlwings 라는 부품에 맡겨요.
파이썬에서 엑셀을 다루는 오래된 부품입니다.
이 부품이 엑셀을 찾을 때 맥에 «엑셀 프로그램 번호»를 물어봅니다.
그런데 macOS 27 에서 그 대답 모양이 바뀌었습니다. 원래는 번호 한 줄만 돌려줬어요.
지금은 이런 여러 줄을 돌려줍니다.
제 맥에서 같은 질문을 직접 던져 본 결과입니다.
[ NULL ] [ NULL ]
bundleID=[ NULL ]
bundle path=[ NULL ]
executable path=[ NULL ]
pid = 39878 !cgsConnection ...옛 xlwings 는 «= 뒤가 번호»라고 믿고 잘랐습니다.
그러니 번호 대신 [ NULL ] 이라는 글자를 집어 들었죠.
오류 문장에 보이던 바로 그 글자입니다.
xlwings 쪽에도 같은 신고가 올라와 있습니다.
9월 22일 신고, 27일에 고친 0.37.5 가 나왔어요
xlwings 는 이미 고쳤습니다. 문제는 pyhub 쪽이에요.
pyhub 설치본은 옛 xlwings 를 통째로 품고 있습니다.
그리고 그 pyhub 가 어제 보관 처리됐어요.
「읽기 전용」 표시가 붙었습니다.
마지막 릴리스 v0.9.8 은 2025년 6월 것이에요
그래서 업데이트 명령을 쳐도 「이미 최신 버전」이라고만 나옵니다. 공식 경로로는 이 오류가 안 풀립니다.
5. 고치면 되나 — 부품만 새것으로 바꿔 봤습니다
pyhub 는 설치 파일 말고 파이썬 패키지로도 올라가 있습니다.
그 방식이면 xlwings 만 새것으로 끼울 수 있어요.
고친 버전 0.37.5 입니다.
해 봤습니다.
필요한 건 uv 라는 파이썬 실행 도구 하나입니다.
저는 이미 깔려 있었어요.
없으면 공식 안내(docs.astral.sh/uv)의 한 줄로 깝니다.
curl -LsSf https://astral.sh/uv/install.sh | sh그다음 클로드 데스크톱 설정의 pyhub 항목을 아래로 바꿉니다. 나의사용자이름 자리만 내 것으로 고치세요.
"pyhub.mcptools": {
"command": "/Users/나의사용자이름/.local/bin/uv",
"args": [
"run", "--no-project", "--python", "3.12",
"--exclude-newer", "2025-06-05",
"--with", "pyhub-mcptools[excel]==0.9.8",
"--with", "xlwings @ https://files.pythonhosted.org/packages/a9/70/caf4374cc3f21a3c6143de61dbf520a333e55616f25e07fb17a7f90bc858/xlwings-0.37.5-cp312-cp312-macosx_11_0_arm64.whl",
"python", "-m", "pyhub.mcptools.microsoft.excel", "run", "stdio"
]
}왜 이렇게 길어졌나. 날짜 옵션(2025-06-05)은 pyhub 가 마지막으로 나온 때에 맞춰 다른 부품을 고정합니다.
이걸 빼고 돌렸더니 부품끼리 안 맞아 아예 켜지지 않았어요. 대신 xlwings 만 새 파일 주소로 콕 집어 끼웠습니다.
이 주소는 애플 실리콘 맥 + 파이썬 3.12 용입니다.
앱을 다시 켜니 이번엔 서버가 정상으로 붙었습니다.
같은 파일을 읽어 보니 표가 그대로 나왔어요.
같은 명령인데 이번엔 값이 읽힙니다.
화면에서는 긴 주소 가운데를 줄였어요
이어서 매출과 마진을 수식으로 넣게 했습니다.
매출은 판매가×판매량, 마진은 (판매가−입고가)×판매량이에요.
결과는 이렇습니다.
숫자가 아니라 수식이 들어갔습니다.
E2 를 누르면 위 입력줄에 «C2 곱하기 D2» 수식이 보여요.
판매량을 고치면 매출도 따라 바뀝니다
손으로 검산했습니다.
사과 매출은 1,500원×120개 = 180,000원이에요.
마진은 700원×120개 = 84,000원이고요.
다섯 줄 모두 맞았습니다.
솔직하게 적습니다. 이번 매출·마진 입력은 클로드 채팅창이 아니라 제가 같은 도구를 직접 불러서 했습니다.
채팅창 조작이 이 맥에서 막혀서예요.
클로드 데스크톱이 이 서버를 띄우고 도구 목록을 받아 간 것까지는 앱 기록으로 확인했습니다.
채팅으로 말해서 시키는 화면은 다음에 붙이겠습니다.
6. 어떤 방식을 고를까
맥에서 클로드로 엑셀 일을 시키는 길은 네 갈래입니다.
A·B 는 공식 문서 기준, C·D 는 제 맥에서 직접 확인한 결과입니다
| A. 파일 첨부 | B. Claude for Excel | C. pyhub-mcptools | D. 넘버스 | |
|---|---|---|---|---|
| 하는 일 | xlsx 를 채팅에 올려 분석 | 엑셀 안 옆 창에서 대화 | 열린 엑셀을 밖에서 조종 | — |
| 맥 지원 | 된다(공식) | 엑셀 for Mac 16.46 이상(공식) | macOS 27 에선 그대로는 오류 | 전용 도구 없음 |
| 필요한 것 | 클로드 계정 | M365 엑셀 + 클로드 유료 요금제 | 엑셀 + 클로드 데스크톱 | 엑셀로 내보내기 |
| 앞으로 | 계속 | 계속(앤트로픽 공식) | 개발 중단(보관) | — |
| 이 글 기준 | 공식 문서 | 공식 문서 | 직접 설치·실행 | 직접 확인 |
추천을 하나만 고르면 B 입니다. 조건이 맞는다면요.
앤트로픽이 직접 만들고 맥 버전을 공식 지원 목록에 넣었습니다.
다만 저는 이번에 B 를 설치하지 않았습니다. 이 맥의 엑셀이 오피스 계정에 로그인돼 있지 않아서예요.
그래서 «된다»가 아니라 «공식 문서에 된다고 적혀 있다»까지만 씁니다.
Claude for Excel 공식 문서의 지원 버전입니다.
맥은 16.46 이상이에요.
2016·2019 영구 라이선스는 지원하지 않는다고 따로 적혀 있습니다
C 는 언제 고르나. 오피스 구독이 없고, 터미널이 무섭지 않고, 5장의 고친 설정을 넣을 수 있는 분이요.
저장소가 보관된 도구라 다음 macOS 업데이트에 또 깨질 수 있다는 건 안고 가셔야 합니다.
7. 넘버스를 쓴다면
넘버스는 이번 시험에서 가장 단순했습니다. 바로 붙는 길이 없어요.
- pyhub 엑셀 도구 15개 중 넘버스용은 0개입니다(3장 Step 2)
- 클로드 첨부 지원 목록에도 넘버스 파일(
.numbers)이 없습니다. 2026년 9월 공식 도움말에 PDF·DOCX·CSV·XLSX 등은 있어요
대신 넘버스는 엑셀 파일을 잘 엽니다. 같은 과일가게 파일을 넘버스로 열어 봤어요.
xlsx 는 넘버스에서 그대로 열립니다.
거꾸로 넘버스 표를 xlsx 로 내보내는 것도 넘버스 기본 기능이에요
그래서 넘버스 사용자의 길은 이렇습니다.
넘버스에서 파일 → 보내기 → Excel 로 xlsx 를 만듭니다.
그 파일을 클로드 채팅에 올리는 A 방식으로 시키면 돼요.
클로드가 넘버스 화면을 직접 만지는 방법은 이번에 찾지 못했습니다.
xlsx 첨부에는 조건이 하나 있습니다.
클로드 설정에서 코드 실행과 파일 만들기가 켜져 있어야 해요.
공식 도움말에 적힌 내용입니다.
8. 막히면 — 증상별 원인과 해결
아무 반응 없이 60초 뒤에 실패해요 권한 창에 아직 답하지 않은 겁니다.
창이 다른 창 뒤에 숨는 일이 많아요.
화면을 정리해서 찾고 «허용»을 누르세요.
제가 이걸로 10분을 날렸습니다.
invalid literal for int() 오류가 나요 macOS 27 에서 공식 설치본을 쓰면 항상 납니다.
설치를 다시 해도, 업데이트를 쳐도 안 풀려요.
5장의 고친 설정을 쓰거나 B·A 로 가세요.
엑셀이 안 열려 있으면요? 이 도구는 열려 있는 파일만 만집니다.
엑셀에서 파일을 먼저 열어 두세요.
엑셀이 꺼진 채로 불렀더니 60초 기다리다 실패했습니다.
엑셀이 뜨자마자 이상한 경고창이 떠요 제 맥에선 «런타임 오류 53»이 떴습니다.
예전에 깐 PDF 추가 기능이 파일을 못 찾는다는 창이었어요.
pyhub 와는 상관없습니다.
「End」를 누르고 넘어가면 됩니다.
kill claude 를 쳤는데 앱이 반쯤만 꺼졌어요 공식 문서는 ./pyhub.mcptools kill claude 로 앱을 끄라고 합니다.
제 맥에선 창만 남고 멈췄어요.
그냥 앱에서 ⌘Q 로 끄는 쪽이 확실했어요.
원본 파일에 바로 시키지 마세요. 이 도구는 칸을 직접 덮어씁니다. 복사본으로 먼저 해 보세요.
Claude for Excel 공식 문서도 «믿을 수 있는 파일에만 쓰라»고 따로 경고합니다.
남이 준 파일 속 숨은 지시에 클로드가 속을 수 있어서예요.
9. 자주 묻는 것
Q. 윈도우 글대로 하면 맥에서도 되나요? A. 설치 명령만 다르고 나머지는 같다고 공식 문서가 말합니다.
실제로 설치까지는 그랬어요.
하지만 macOS 27 에서는 엑셀에 붙는 단계에서 막힙니다.
이건 윈도우 글에 안 나오는 맥만의 문제예요.
Q. macOS 26 이하에서는 되나요? A. 오류의 원인이 macOS 27 의 바뀐 대답입니다.
그래서 그 전 버전에선 안 났을 가능성이 큽니다.
다만 저는 27 에서만 해 봤어요.
확인은 못 했습니다.
Q. 엑셀 2016·2019 도 되나요? A. pyhub 는 «엑셀 2016 이상»이라고 적혀 있습니다.
Claude for Excel 은 2016·2019 영구 라이선스를 지원하지 않습니다. 공식 문서에 그렇게 적혀 있어요.
둘이 다릅니다.
Q. 무료 클로드 계정으로도 되나요? A. pyhub 공식 문서는 무료 계정도 MCP 를 쓸 수 있다고 합니다.
대화 횟수가 적을 뿐이라고요.
Claude for Excel 은 프로 이상 유료 요금제만 됩니다.
10. 다음 단계
엑셀 도구를 붙였다면 켜 둔 도구도 한번 세어 보세요.
숫자를 다루는 일엔 안전장치도 필요합니다. «없는 걸 만들지 말라»는 한 줄이요.
- 켜 둔 MCP 점검 → MCP 뭘 켜 놨는지 세어 봤습니다 — 23개 중 절반이 일을 안 하고 있었어요
- 같은 방식의 다른 연결 → 맥에서 HWP 공문, 한글 안 사고 클로드가 표까지 읽게 하는 법
- 숫자를 지어내지 않게 → 모든 프롬프트에 넣어야 할 안전장치 3줄 — 추측 금지·없으면 없다고·근거 명시
이 글의 화면은 2026년 9월 29일 제 맥에서 직접 찍은 것입니다(macOS 27.0, 엑셀 for Mac 16.93, 넘버스 14.5, 클로드 데스크톱 2.9939, pyhub-mcptools 0.9.8, xlwings 0.37.5).
터미널 화면의 사용자 이름은 가렸습니다.
Claude for Excel 은 설치하지 않았고 공식 문서만 인용했습니다.
'Claude code' 카테고리의 다른 글
| 클로드 디자인으로 한글 슬라이드 5장 만들어 PPTX 로 내보냈습니다 — 폰트가 살아남는지부터 봤습니다 (0) | 2026.10.01 |
|---|---|
| 클로드 아티팩트로 점심 룰렛 만들어 링크로 돌렸습니다 — 공유를 거둬도 같은 링크로 다시 열립니다 (0) | 2026.09.30 |
| 맥에서 HWP 공문, 한글 안 사고 클로드가 표까지 읽게 하는 법 (0) | 2026.09.26 |
| 맥 바탕화면 정리, 코워크에 맡기되 ‘지우지 말고 표부터’라고 쓰세요 (0) | 2026.09.23 |
| MCP 뭘 켜 놨는지 세어 봤습니다 — 23개 중 절반이 일을 안 하고 있었어요 (0) | 2026.09.21 |
