이번 글에서는 MCP가 무엇이고 어떻게 동작하는지 알아보겠습니다.
1. MCP란?
MCP(Model Context Protocol)는 Claude 같은 AI가 다른 프로그램을 사용할 수 있도록 정해 놓은 규칙입니다. 이 규칙에 맞게 프로그램을 만들면 Claude가 그 프로그램의 기능을 사용할 수 있습니다.
MCP에는 다음 세 가지가 나옵니다.
- 클라이언트 : 사용자와 대화하는 프로그램입니다. 이 강좌에서는 Claude Desktop입니다.
- 서버 : 기능을 제공하는 프로그램입니다. 이 강좌에서 만들 Node.js 프로그램입니다.
- 도구(tool) : 서버가 제공하는 기능 하나하나입니다. 업무 목록 읽기(list_tasks), 업무 추가(add_task) 같은 것들입니다.
서버라고 해서 인터넷에 있는 컴퓨터를 말하는 것은 아닙니다. 내 PC에서 Claude Desktop이 실행시키는 작은 프로그램입니다.
2. 동작 순서
Claude Desktop에서 "지연된 업무 알려줘"라고 입력하면 다음 순서로 처리됩니다.
① Claude Desktop은 시작할 때 MCP 서버를 실행하고 어떤 도구가 있는지 물어봅니다.
② 서버는 도구 목록을 알려 줍니다. 도구마다 이름, 설명, 입력값이 들어 있습니다.
③ 사용자가 질문하면 Claude는 도구 설명을 보고 list_tasks를 고릅니다.
④ 서버는 엑셀에서 업무 목록을 읽어 결과를 돌려줍니다.
⑤ Claude는 결과에서 지연된 업무를 찾아 정리해서 답변합니다.
여기서 어떤 도구를 언제 쓸지는 Claude가 정합니다. 서버는 도구를 만들어 두기만 하면 됩니다. 예를 들어 "매출 보고서 실적 70%로 입력해줘"라고 하면 Claude가 알아서 먼저 목록을 읽고 해당 행을 찾아서 수정합니다.
※ 참고 : Claude는 코드를 보지 않고 도구 설명만 보고 판단합니다. 그래서 도구 설명을 잘 써야 합니다. 자세한 내용은 11강에서 설명합니다.
3. 도구의 구성
도구 하나는 다음과 같이 네 부분으로 되어 있습니다. 지금은 코드를 이해하지 않아도 됩니다.
server.registerTool(
'list_tasks', // ① 이름
{
description: "'일정' 시트의 업무를 읽습니다.", // ② 설명
inputSchema: z.object({ // ③ 입력값
delayed_only: z.boolean().optional()
})
},
async (args) => { /* ④ 엑셀에서 읽어 오기 */ }
);
4. SDK 버전
MCP 서버는 SDK라는 개발 도구로 만듭니다. 이 강좌는 Node.js용 SDK v2(@modelcontextprotocol/server)를 사용합니다.
※ 참고 : 인터넷 예제 중에 @modelcontextprotocol/sdk를 쓰는 것은 이전 버전(v1)입니다. 사용법은 비슷하지만 불러오는 경로가 다르므로 섞어서 쓰면 오류가 납니다.
다음 글에서는 MCP 서버가 엑셀을 어떻게 다루는지 알아보겠습니다.
[ AI-Excel 연동(Claude로 Excel 연동 MCP 만들기) ]
