AI > 엑셀 MCP 만들기 > AI-Excel 연동 5강 - 예제로 Claude Desktop에 연결하기

AI-Excel 연동 5강 - 예제로 Claude Desktop에 연결하기

이번 글에서는 예제 파일을 다운로드받아서, 간단한 MCP 서버를 Claude Desktop에 연결해 보겠습니다. 아직 엑셀은 다루지 않고, 연결이 되는지만 확인합니다.

1. 예제 파일 다운로드

예제 파일은 GitHub 저장소에 있습니다.

GitHub 저장소 https://github.com/xlworksnet/excel-mcp-tutorial

저장소 화면에서 Code > Download ZIP을 눌러 다운로드하고, 압축을 풀어서 원하는 폴더(예: C:\excel-mcp-tutorial)에 둡니다.

※ 참고 : 폴더 경로에 한글이나 띄어쓰기가 없는 것이 좋습니다.

폴더에는 다음 파일들이 들어 있습니다.

  • steps/hello.js : 이번 글에서 사용할 연결 확인용 서버
  • src/index.js, excel.js, backup.js : MCP 서버(6강~12강에서 설명)
  • examples/업무일정.xlsx : 예제 엑셀 파일
  • examples/UpdateSchedule.bas : 예제 파일에 넣을 VBA 모듈(9강)
  • package.json : 필요한 패키지 목록
  • manifest.json : .mcpb 파일을 만들 때 사용(13강)

 

2. 패키지 설치

VS Code에서 C:\excel-mcp-tutorial 폴더를 열고 Terminal에 다음과 같이 입력합니다.

npm install

package.json에 적힌 패키지들이 다운로드되어 node_modules 폴더에 설치됩니다.

"dependencies": {
  "@modelcontextprotocol/server": "^2.4.0",
  "zod": "^4.2.0"
}
  • @modelcontextprotocol/server : MCP 서버를 만드는 SDK입니다.
  • zod : 도구의 입력값 형식(문자, 숫자, 날짜 등)을 정하는 데 사용합니다.

정상적으로 설치되면 그림과 같이 node_modules 폴더와 package-lock.json 파일이 만들어집니다.

MCP Tutorial 폴더

 

3. 연결 확인용 서버

steps폴더의 hello.js는 이름을 받아서 인사말을 돌려주는 도구 하나만 있는 서버입니다.

import { McpServer } from '@modelcontextprotocol/server';
import { serveStdio } from '@modelcontextprotocol/server/stdio';
import { z } from 'zod';

function createServer() {
  const server = new McpServer({ name: 'hello', version: '1.0.0' });

  server.registerTool(
    'say_hello',
    {
      description: '이름을 받아 인사말을 돌려줍니다.',
      inputSchema: z.object({ name: z.string().describe('인사할 사람 이름') })
    },
    async ({ name }) => ({
      content: [{ type: 'text', text: `${name}님, 안녕하세요! MCP 서버가 잘 연결되었습니다.` }]
    })
  );

  return server;
}

serveStdio(createServer);
console.error('hello 서버가 시작되었습니다.');   // 확인용 출력은 console.error로!
  • new McpServer() : 서버를 만듭니다.
  • registerTool() : 도구를 등록합니다. 2강에서 본 네 부분(이름, 설명, 입력값, 처리)으로 되어 있습니다.
  • serveStdio() : Claude Desktop과 연결을 시작합니다.

hello는 서버 이름이고, say_hello는 서버 안에 있는 도구 이름입니다. 서버 하나에 도구를 여러 개 넣을 수 있어서 이름을 따로 붙입니다. 이 강좌에서 만들 excel-schedule 서버에도 list_tasks, add_task 등 도구가 6개 들어갑니다.

※ 주의 : MCP 서버는 표준 입출력(stdio)으로 Claude Desktop과 대화합니다. console.log로 무엇인가를 출력하면 대화 내용에 섞여서 연결이 끊어집니다. 확인용 출력은 반드시 console.error를 사용합니다.

 

4. Claude Desktop에 연결

① Windows 키+R을 눌러 실행 창을 열고 %LOCALAPPDATA%\Claude-Data를 입력한 후 [확인]을 누릅니다. claude_로 시작하는 폴더(예: claude_pzs8sxrjxfjjc)를 열면 claude_desktop_config.json 파일이 있습니다.

※ 참고 : 파일이 없으면 VS Code에서 File > New File로 새 파일을 만들고, 이 폴더에 claude_desktop_config.json이라는 이름으로 저장합니다. 메모장으로 저장할 때는 파일 형식을 '모든 파일'로 바꿔야 .txt가 붙지 않습니다.

※ 참고 : Claude Desktop 버전이나 설치 방법에 따라 위치가 다를 수 있습니다. 파일을 찾지 못하면 PowerShell에서 다음 명령을 실행하면 위치가 출력됩니다.

Get-ChildItem $env:APPDATA, $env:LOCALAPPDATA -Recurse -Filter claude_desktop_config.json -ErrorAction SilentlyContinue | Select-Object FullName

② claude_desktop_config.json 파일을 메모장이나 VS Code로 열고 다음과 같이 입력합니다. 이미 내용이 있으면 mcpServers 부분만 추가합니다.

{
  "mcpServers": {
    "hello": {
      "command": "node",
      "args": ["C:\\excel-mcp-tutorial\\steps\\hello.js"]
    }
  }
}

mcpServers도 이미 있다면 다음과 같이 추가합니다.

Claude Desktop에 연결 설정

③ 저장하고 Claude Desktop을 완전히 종료합니다. 창만 닫으면 계속 실행중이므로, Claude Desktop에서 좌측 상단 메뉴 > 파일 > 종료를 선택합니다.

④ Claude Desktop을 다시 실행합니다.

Claude Desktop은 시작할 때 이 설정 파일을 읽고 MCP 서버를 실행합니다. 그래서 설정을 바꾸면 Claude Desktop을 다시 시작해야 합니다.

Claude Desktop이 MCP 서버를 실행하는 과정

5. 연결 확인

새 채팅에서 입력창 옆의 + > '플러그인'을 누르면 hello가 표시되어야 합니다.

Claude plugin

다음과 같이 입력해 봅니다.

say_hello 도구로 나한테 인사해줘. 내 이름은 엑셀웍스야.

처음에는 도구 사용을 허용할지 묻는 창이 나옵니다. 허용하면 "엑셀웍스님, 안녕하세요! MCP 서버가 잘 연결되었습니다."라는 결과를 받아서 Claude가 답변합니다.

※ 참고 : 도구 이름을 말하지 않고 "나한테 인사해줘. 내 이름은 엑셀웍스야."라고만 해도 Claude가 도구 설명을 보고 say_hello를 고릅니다. 여기서는 연결을 확실히 확인하려고 도구 이름을 넣었습니다.

MCP 응답

연결이 안 될 때는 다음을 확인합니다.

  • 설정 파일과 같은 폴더에 있는 logs 폴더의 mcp-server-hello.log 파일에 로그가 남습니다. console.error로 출력한 내용도 여기에 있습니다.
  • 가장 많은 원인은 JSON 문법 오류(쉼표, \)와 잘못된 경로입니다.
  • 터미널에서 node C:\excel-mcp-tutorial\steps\hello.js를 실행해서 "hello 서버가 시작되었습니다."가 나오면 서버는 정상이고 설정 파일에 문제가 있는 것입니다. (Ctrl+C로 종료)

 

6. 예제 엑셀 파일

examples/업무일정.xlsx를 열어 보면 '일정' 시트가 있습니다. 열 구성은 다음과 같습니다.

샘플 파일

  • A열 번호, B열 업무명, C열 담당, D열 시작일, E열 완료일 : 사용자가 입력
  • F열 계획진척률 : 수식
  • G열 실적진척률 : 사용자가 입력
  • H열 지연 : 수식

F열 계획진척률의 수식은 다음과 같습니다.

=IF(OR(D2="",E2=""),"",MAX(0,MIN(1,NETWORKDAYS(D2,MIN(TODAY(),E2))/NETWORKDAYS(D2,E2))))

시작일부터 오늘까지의 작업일수를 전체 작업일수로 나눈 값입니다. NETWORKDAYS 함수는 토요일과 일요일을 뺀 작업일수를 구합니다. 시작일 전이면 0%, 완료일이 지나면 100%가 되도록 MAX, MIN으로 범위를 제한했습니다.

H열 지연은 실적이 계획보다 낮으면 '지연'을 표시합니다.

=IF(OR(F2="",G2=""),"",IF(G2<F2,"지연",""))

 

다음 글에서는 열려 있는 엑셀 파일의 정보를 읽는 첫 번째 도구를 만들어 보겠습니다.

 

[ AI-Excel 연동(Claude로 Excel 연동 MCP 만들기) ]

엑셀웍스 책 출간 안내

그동안 엑셀웍스에 올린 '엑셀 강좌', '함수 사용법', 여러 '실무 예제'에서 핵심만 뽑아 '된다! 엑셀 수식 & 함수' 책으로 출간하였습니다.

 자세히 보기

온라인 구매처: 예스24   교보문고   알라딘 

댓글 남기기

위로 스크롤