2024년 11월에 Anthropic에서 발표한 AI 모델과 AI가 사용하는 도구를 연결하는 프로토콜. AI 도구가 많아지면서 난립하는 연동 방식을 정리하기 위해 고안되었다.
프로토콜이 고안되기 이전에는 function-calling, tool-calling 등 다양한 이름으로 ollama, phidata 등 AI toolkit에서 제공했다.
개발 환경 세계를 통일한 Language Server Protocol와 유사한데, 실제로 영감을 받았다고 한다:
MCP takes some inspiration from the Language Server Protocol, which standardizes how to add support for programming languages across a whole ecosystem of development tools.
프로토콜의 사양은 modelcontextprotocol.io에서 관리한다. AI가 사용할 수 있는 도구를 정의한 MCP 서버, 사용자와 대면하는 Host, Host에서 서버와 통신하는 Client가 JSON-RPC 2.0 메시지로 통신한다.
사용자 입장에서 선택할 것은, MCP Client를 제공하는 Host와 MCP 서버이다. Client는 VSCode, IntelliJ(2025.1 부터) 등이 지원한다. MCP 서버는 Awesome MCP Servers에 정리되어 있다.
VSCode에서 playwright-mcp를 사용하는 예시로, Copilot Chat을 통해 Playwright를 실행, 대화를 통해서 브라우저를 조작할 수 있다. 예를들어 "브라우저를 열고 네이버에서 조선호텔 연락처를 검색해서 알려줘'라던가 "AI 기초 레벨을 다루는 아티클 5개만 탭으로 열어놔줘' 같은 명령을 내릴 수 있다.
다만 한 응답에서 도구 사용 제한이 있는 것으로 보인다. JetBrains나 VSCode + GitHub Copilot Chat 모두에서 발생한 현상인데, URL 40개를 던져주고 확인하고 보고하라고 하면 5개 정도만 확인하고 나머지는 어떻게든 무시한다. JetBrains AI는 6번째에 도구 사용 횟수에 제한이 있다고 말하며 응답을 종료하고, Copilot Chat은 도구 사용하지 않고 확인했다며 환각을 보인다. 모델은 모두 Claude 3.7 Sonnet을 사용했다.
아래는 JetBrains AI의 응답 일부:
네, 남은 엔드포인트들에 대한 Datadog 트레이스 검색을 진행하기 위한 URL 목록을 준비했습니다. 도구 호출 제한으로 인해 모든 URL을 직접 브라우저에서 열지는 못하지만, 각 API 엔드포인트에 대한 Datadog 검색 URL을, 라인마다 하나씩 제공해드리겠습니다.
MCP 서버는 누구나 제공할 수 있지만, 반면에 클라이언트는 그렇지 않다. AI 도구 제공자가 MCP 클라이언트를 제공하는 것이 일반적이다.
25년 6월 기준, ChatGPT는 MCP를 지원하지 않는다. 반면에 프로토콜을 고안한 Anthropic의 Claude Desktop은 MCP 클라이언트를 제공한다.
Claude Code는 셸 환경에서 동작해서 더 많은 도구를 사용할 수 있다.
Claude Desktop으로 서버를 구현하면서 정리한 내용.
프로토콜은 JSON-RPC 2.0 메시지로 통신한다.
initialize는 MCP 서버와 클라이언트가 처음 연결할 때 호출한다. 이 단계에서는 프로토콜 버전과 기능 등을 서버와 클라이언트가 협상하는 단계이다.
클라이언트 요청 예시:
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2024-11-05",
"capabilities": {
}
}
}서버는 다음과 같이 응답한다:
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"protocolVersion": "2024-11-05",
"capabilities": {
"tools": {}
},
"serverInfo": {
"name": "simple-mcp-server",
"version": "1.0.0"
}
}
}성공적으로 초기화가 완료되면, 클라이언트는 notifications/initialized를 호출한다.
{
"jsonrpc": "2.0",
"method": "notifications/initialized"
}이 단계가 완료되기 전에는 ping, 로깅 등 다른 요청을 하지 말아야 한다.
tools/list는 서버가 제공하는 도구 목록을 요청한다.
요청 예시:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list",
}응답 예시:
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"tools": [
{
"name": "hello",
"description": "Returns a hello message",
"inputSchema": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Name to greet (optional)"
}
}
}
}
]
}
}MCP 그룹에서 공식 제공하는 디버깅 및 개발 도구.
npx @modelcontextprotocol/inspector <command> <args>서버 시작 명령어를 함께 넘겨주거나, npx @modelcontextprotocol/inspector로 실행하면 MCP Inspector가 시작된다.
로컬 환경에서 서버가 시작되면, 웹 브라우저에서 서버를 테스트할 수 있다. 일종의 Web UI 기반 MCP 클라이언트인 셈.
Claude Desktop에서 설정에 진입하면 확장 프로그램을 관리할 수 있다. 사실상 MCP 서버를 쉽게 추가할 수 있도록 도와주는 기능이다.
MCP 서버 개발자가 .dxt 파일을 만들어서 배포하면, 사용자는 이 파일을 확장 프로그램에 드래그 앤 드롭으로 설치할 수 있다.
.dxt 파일은 MCP 서버의 코드(의존성 포함)와 manifest를 포함하는 압축 파일이다.
anthropics/dxt는 DXT 파일을 쉽게 만들 수 있는 도구이다.
dxt init으로 manifest를 생성하고, dxt pack으로 .dxt 파일을 생성한다.
별도 빌드 프로세스는 없으므로, 개발 의존성을 제외한 상태에서 dxt pack을 실행하자.
2025-07-23, 클라이언트가 MCP 서버를 제대로 호출하지 못하는 문제가 발생했다.
Reddit 에서도 같은 문제를 겪는 사용자들이 많다.
도구 호출 자체는 정상적이나, arguments를 전달하지 않는 문제다. 사용자의 승인 창에서는 전달한다고 보여주지만, 실제로는 전달하지 않는다.
실행되지 않는 것과 별개로, 사용자가 보는 입력과 실제 입력이 다른 것은 문제가 될 여지가 있다. \n
이 이슈는 Anthropic의 Status 페이지에 기록되어 있다.