새소식

300x250
AI/MCP

Anthropic MCP 프로토콜 1년의 진화 - OpenAI 채택부터 Linux Foundation 이관까지

  • -
728x90

안녕하세요. 갓대희 입니다.

오늘은 MCP가 출시된지 1년여 지나는 시점에서 어떤 발전이 있었고, 어떠한 흐름으로 이어져 나가고 있는지 정리하는 것을 목표로 해봤다. 

( 글작성 시점은 출시된지 약 1년 지난 2025년 12월 이다. )

왜 지금 MCP를 알아야 하는가?

2025년 12월, AI 에이전트 개발의 판도가 바뀌었다. Anthropic이 만든 MCP를 OpenAI가 채택하고, Linux Foundation이 공식 표준으로 인정했다. 이제 MCP는 특정 회사의 프로토콜이 아니라 AI 업계의 공용어가 되었다.

Claude, ChatGPT, Gemini 어디서든 동작하는 AI 도구를 만들고 싶다면? MCP 하나만 구축하면 된다.

 

MCP(Model Context Protocol) 1년간의 진화
2024년 11월 Anthropic이 오픈소스로 공개한 MCP가 2025년 12월 Linux Foundation 이관까지, AI와 외부 시스템을 연결하는 산업 표준으로 자리잡기까지의 핵심 업데이트를 정리한다. Streamable HTTP, MCP Connector, OAuth 인증, Code Execution 통합까지 개발자가 반드시 알아야 할 변화를 다룬다.

AI 에이전트 개발에서 가장 까다로운 문제 중 하나는 외부 시스템과의 통합이다. GitHub, Slack, 데이터베이스, 사내 API 등 다양한 서비스와 AI를 연결하려면 각각의 인증 방식, 데이터 포맷, 에러 처리를 개별적으로 구현해야 했다. Model Context Protocol(MCP)은 이 파편화된 통합 문제를 해결하기 위해 Anthropic이 2024년 11월 25일 오픈소스로 공개한 표준 프로토콜이다.

 

공개 1년 만에 MCP는 OpenAI, Google, Microsoft, AWS, Cloudflare 등 주요 기업이 채택하고 10,000개 이상의 MCP 서버(출처: Linux Foundation)가 구축되는 사실상의 산업 표준이 되었다. 2025년 12월에는 Linux Foundation 산하 Agentic AI Foundation(AAIF)에 기부되면서 중립적인 거버넌스 체계를 갖추게 되었다. 이 글에서는 개발자 관점에서 MCP의 핵심 업데이트와 실전 활용 방안을 상세히 살펴보자.

3줄 요약 (TL;DR)
  • MCP 1년: OpenAI, Google, Microsoft 채택 → 10,000+ 서버 생태계로 성장
  • 핵심 변화: Streamable HTTP + OAuth 2.1 + MCP Connector = 원격 MCP 인프라 완성
  • 실전 효과: Code Execution 결합으로 토큰 98.7% 절감 가능
이 글의 구성
  1. MCP 기본 개념 - MCP란 무엇인가, 아키텍처 개요
  2. 1년간의 변화 - Before & After, 타임라인, 로컬 vs 원격
  3. 4가지 핵심 업데이트 - Streamable HTTP, MCP Connector, OAuth 2.1, Code Execution
  4. OpenAI의 MCP 통합 - Agents SDK, ChatGPT MCP, AGENTS.md
  5. Linux Foundation 이관 - AAIF 설립, 거버넌스 변화
  6. 실전 가이드 - 시작하기, 요금제, 구축 권장사항
  7. 마무리 & FAQ - 개발자 제언, 자주 묻는 질문

 

MCP란 무엇인가 

MCP(Model Context Protocol)는 AI 애플리케이션과 외부 시스템을 연결하는 범용 오픈 표준이다. Anthropic 공식 발표에 따르면, MCP는 "콘텐츠 저장소, 비즈니스 도구, 개발 환경 등 데이터가 있는 시스템에 AI 어시스턴트를 연결하기 위한 새로운 표준"으로 정의된다.

MCP 출시와 함께 Anthropic은 Google Drive, Slack, GitHub, Git, Postgres, Puppeteer 등을 위한 사전 구축된 MCP 서버를 오픈소스로 공개했다. 초기 파트너로는 Block, Apollo가 실제 통합을, Zed, Replit, Codeium, Sourcegraph가 개발 도구 협력에 참여했다.

 

이번 글에서는 간단히 넘어가는데, 예전에 썼던 글도 참고 가능하다.

MCP란? Claude Desktop MCP 서버 설정하는 법 - Model Context Protocol 초보 가이드

MCP 아키텍처 개요

  1. MCP Host: Claude Desktop, IDE, AI 애플리케이션 등 MCP를 지원하는 클라이언트
  2. MCP Client: Host 내에서 MCP 서버와 통신하는 컴포넌트
  3. MCP Server: 외부 시스템(GitHub, Slack, DB 등)과 연결된 서버
  4. Transport Layer: 클라이언트-서버 간 통신 계층
    • stdio: 로컬 MCP 서버용 (Claude Desktop에서 주로 사용)
    • Streamable HTTP: 원격 MCP 서버용 (2025년 3월 도입)

MCP 아키텍처 다이어그램

┌─────────────────────────────────────────────────────────────────────┐
│                         MCP Host                                    │
│            (Claude Desktop, ChatGPT, IDE, Custom App)               │
│  ┌───────────────────────────────────────────────────────────────┐  │
│  │                      MCP Client                               │  │
│  │              (Host 내 MCP 통신 담당 컴포넌트)                  │  │
│  └───────────────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────────────┘
                                  │
                    ┌─────────────┼─────────────┐
                    │             │             │
                    ▼             ▼             ▼
          ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
          │   stdio     │ │ Streamable │ │   SSE      │
          │   (로컬)    │ │    HTTP    │ │  (레거시)  │
          │             │ │   (원격)    │ │             │
          └──────┬──────┘ └──────┬──────┘ └──────┬──────┘
                 │               │               │
                 ▼               ▼               ▼
┌─────────────────────────────────────────────────────────────────────┐
│                        MCP Server(s)                               │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐            │
│  │  GitHub  │  │  Slack   │  │ Database │  │  Custom  │  ...       │
│  │  Server  │  │  Server  │  │  Server  │  │  Server  │            │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘  └────┬─────┘            │
└───────┼─────────────┼─────────────┼─────────────┼──────────────────┘
        │             │             │             │
        ▼             ▼             ▼             ▼
   ┌─────────┐   ┌─────────┐   ┌─────────┐   ┌─────────┐
   │ GitHub  │   │  Slack  │   │ Postgres│   │  사내   │
   │   API   │   │   API   │   │   DB    │   │   API   │
   └─────────┘   └─────────┘   └─────────┘   └─────────┘

▲ MCP는 Host와 외부 시스템 사이의 표준화된 인터페이스 역할을 한다

MCP의 핵심 가치는 "한 번 구축하면 어디서든 연결"이라는 원칙에 있다. 기존에는 Claude용 GitHub 통합, ChatGPT용 GitHub 통합을 각각 별도로 구현해야 했다면, MCP 서버를 한 번 구축하면 MCP를 지원하는 모든 AI 클라이언트에서 재사용할 수 있다.

 

1년간의 변화 : Before & After

MCP가 출시된 2024년 11월과 1년이 지난 2025년 12월을 비교하면, 프로토콜의 성숙도와 생태계 확장을 한눈에 파악할 수 있다.

항목 2024.11 (출시) 2025.12 (현재)
전송 방식 stdio, HTTP+SSE + Streamable HTTP
인증 사양에 미포함 OAuth 2.1 + PKCE
API 통합 직접 클라이언트 구현 MCP Connector 자동화
거버넌스 Anthropic 단독 Linux Foundation AAIF
생태계 초기 파트너 6개사 10,000+ MCP 서버
주요 채택사 Anthropic + OpenAI, Google, Microsoft, AWS

 

MCP 발전 타임라인

시점 주요 이벤트 의미
2024.11.25 MCP 오픈소스 공개 Anthropic이 프로토콜 사양, SDK, 샘플 서버 공개
2025.03.26 OpenAI MCP 채택 발표 Agents SDK MCP 지원, Streamable HTTP 사양 공개 (공식 문서)
2025.05.21 OpenAI Responses API MCP 지원 OpenAI API에서 MCP 공식 지원 시작 (관련 기사)
2025.05.22 Anthropic API 4대 기능 발표 MCP Connector, Code Execution, Files API, Extended Caching
2025.06.18 OAuth 2.1 인증 사양 공식화 엔터프라이즈 환경 지원 본격화
2025.08 OpenAI AGENTS.md 공개 AI 코딩 에이전트 가이드 표준 발표, 60,000+ 프로젝트 채택 (AAIF 발표)
2025.09.09 ChatGPT Developer Mode MCP 지원 ChatGPT에서 MCP 완전 지원 발표, 읽기/쓰기 모두 가능 (InfoQ)
2025.11.04 Code Execution with MCP 발표 토큰 98.7% 절감 사례 공개
2025.12.09 Linux Foundation AAIF 설립 Anthropic, Block, OpenAI 공동 설립. MCP 기부 (공식 발표)
공식 문서 출처
위 타임라인은 Anthropic 공식 블로그, MCP 사양 문서(modelcontextprotocol.io), GitHub 블로그의 Linux Foundation 발표를 기반으로 작성되었다.
Anthropic MCP 공식 발표 →
Sam Altman (OpenAI CEO), 2025년 3월 26일 X 포스트
"People love MCP and we are excited to add support across our products. [It's] available today in the Agents SDK and support for [the] ChatGPT desktop app [and] Responses API [is] coming soon!"
(사람들은 MCP를 매우 좋아하고 있으며, 저희도 전반적인 제품군에 MCP 지원을 추가하게 되어 매우 기대하고 있습니다. MCP는 현재 Agents SDK에서 바로 사용 가능하며, ChatGPT 데스크톱 앱과 Responses API에 대한 지원도 곧 제공될 예정입니다.)
후속 업데이트 (2025년 12월 기준)
Sam Altman이 예고한 기능들이 모두 출시되었다:
2025년 5월 21일: Responses API MCP 지원 (출처)
2025년 9월 9일: ChatGPT Developer Mode MCP 지원 발표
2025년 10월: ChatGPT MCP 정식 베타 출시 - 읽기/쓰기 모두 지원 (InfoQ)

 

로컬 MCP vs 원격 MCP : 무엇이 다른가

MCP 서버는 실행 위치에 따라 로컬 MCP원격 MCP로 구분된다.

개발 시나리오에 따라 적합한 방식이 다르므로 차이점을 이해하는 것이 중요하다.

구분 로컬 MCP 원격 MCP
전송 방식 stdio (표준 입출력) Streamable HTTP
실행 위치 사용자 로컬 머신 클라우드/외부 서버
인증 불필요 (로컬 실행) OAuth 2.1 권장
사용 예시 로컬 파일 시스템, Git, 개인 DB Zapier, Asana, 팀 공유 서비스

언제 무엇을 선택해야 하나?

로컬 MCP 선택:
  • 로컬 파일이나 Git 저장소를 AI로 제어할 때
  • 개인 프로젝트 또는 개발 환경에서
  • 민감한 데이터가 로컬에만 있어야 할 때
  • 네트워크 없이 작동해야 할 때
원격 MCP 선택:
  • 팀원들과 동일한 MCP 서버를 공유할 때
  • SaaS 서비스(Slack, Notion 등)와 연동할 때
  • 여러 디바이스에서 접근해야 할 때
  • 엔터프라이즈 인증(OAuth)이 필요할 때

💡 Tip: 처음 시작한다면 로컬 MCP(stdio)로 프로토타입을 만들고, 프로덕션에서 원격 MCP(Streamable HTTP)로 전환하는 것이 일반적인 패턴이다.

 

핵심 업데이트 #1 : Streamable HTTP 전송

2025년 3월 26일 발표된 Protocol Revision 2025-03-26에서 가장 중요한 변화는 Streamable HTTP 전송 메커니즘의 도입이다. 이는 기존의 HTTP+SSE(Server-Sent Events) 전송을 대체하며, 원격 MCP 서버 구축의 새로운 표준이 된다.

 

기존 HTTP+SSE의 한계

기존 방식에서는 클라이언트가 SSE 연결을 위한 엔드포인트와 요청을 보내는 엔드포인트를 별도로 관리해야 했다. 이는 연결 상태 관리의 복잡도를 높이고, 네트워크 불안정 시 복구가 어려웠다.

 

Streamable HTTP의 핵심 개선점

Streamable HTTP 요청 예시

POST /mcp HTTP/1.1
Host: example.com
Accept: application/json, text/event-stream
Content-Type: application/json
Mcp-Session-Id: "550e8400-e29b-41d4-a716-446655440000"

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_weather",
    "arguments": {"city": "Seoul"}
  }
}

1. 단일 엔드포인트 통합: 모든 통신이 하나의 HTTP 엔드포인트(예: https://example.com/mcp)를 통해 이루어진다. 요청과 응답을 별도 엔드포인트로 분리할 필요가 없다.

 

2. 세션 관리(Mcp-Session-Id): 서버가 초기화 시 세션 ID를 발급하면, 클라이언트는 모든 후속 요청에 이 ID를 포함한다. 이를 통해 상태 유지 세션을 구현할 수 있다.

 

3. 연결 복구(Last-Event-ID): 네트워크 장애 후 클라이언트가 마지막으로 수신한 이벤트 ID를 전송하면, 서버가 해당 지점 이후의 메시지를 재전송한다.

연결 복구 요청 예시

GET /mcp HTTP/1.1
Host: example.com
Accept: text/event-stream
Last-Event-ID: event-42
Mcp-Session-Id: "550e8400-e29b-41d4-a716-446655440000"

 

4. 양방향 통신: 서버가 클라이언트로 알림(notification)이나 요청을 보낼 수 있다.

예를 들어, 외부 시스템에서 데이터가 변경되었을 때 서버가 클라이언트에게 실시간으로 알릴 수 있다. 기존에는 클라이언트 → 서버 단방향이었다면, 이제 서버도 능동적으로 메시지를 전송할 수 있다.

SSE 지원 중단 예정
공식 문서에 따르면 Claude는 SSE 및 Streamable HTTP 기반 원격 서버를 모두 지원하지만, SSE 지원은 "향후 몇 개월 내에 중단될 수 있다(may be deprecated)"고 명시되어 있다. 새로운 MCP 서버를 구축한다면 Streamable HTTP를 사용하는 것이 권장된다.

> Streamable HTTP로 원격 통신 문제를 해결했다면, 다음 과제는 연결 자동화다.

 

핵심 업데이트 #2 : MCP Connector

2025년 5월 22일 Anthropic이 발표한 API 신기능 중 개발자에게 가장 큰 영향을 미치는 것은 MCP Connector이다.

이전까지 MCP 서버에 연결하려면 개발자가 직접 클라이언트 하네스(harness)를 구축해야 했다. 연결 관리, 도구 검색, 에러 처리를 모두 직접 구현해야 했던 것이다.

 

MCP Connector는 이 복잡도를 완전히 제거한다. Anthropic API가 모든 연결 관리, 도구 검색, 에러 처리를 자동으로 수행하므로, 개발자는 API 요청에 원격 MCP 서버 URL만 추가하면 된다.

MCP Connector의 장점
• 클라이언트 코드 작성 불필요
• 연결 관리 자동화
• 도구 검색 및 스키마 처리 자동화
• Zapier, Asana 등 서드파티 MCP 서버 즉시 통합 가능

MCP Connector API 요청 예시 (Python)

실행 환경: Python 3.10+ | pip install anthropic>=0.30.0 | ANTHROPIC_API_KEY 환경변수 필요
import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    mcp_servers=[
        {
            "type": "url",
            "url": "https://mcp.zapier.com/api/mcp/s/your-server-id",
            "authorization_token": "Bearer your_oauth_token"
        }
    ],
    messages=[
        {"role": "user", "content": "오늘 일정을 확인해줘"}
    ]
)
📌 [실제 테스트 필요]
• 위 코드 예시는 공식 문서 구조를 기반으로 한 예시이며, 실제 API 호출 시 정확한 파라미터명과 형식은 최신 API 문서 확인 필요
• OAuth 토큰 획득 및 갱신 로직은 별도 구현 필요
• Zapier MCP 서버 URL 형식은 Zapier 공식 가이드 참조 필요

> 연결이 자동화되었다면, 이제 보안이 핵심이다.

 

핵심 업데이트 #3 : OAuth 2.1 인증

MCP 초기 버전(2024-11-05 사양)에서는 인증이 사양에 포함되지 않았다. 사용자가 로컬에서 MCP 서버를 직접 실행하는 방식이었기 때문이다. 그러나 원격 MCP 서버가 확산되면서 엔터프라이즈 수준의 인증이 필수가 되었다.

2025년 6월 18일 공개된 MCP 사양에서 OAuth 2.1 + PKCE 기반 인증이 공식화되었다. 이는 기존 엔터프라이즈 인증 스택과의 통합을 크게 단순화한다.

 

OAuth 인증 핵심 사항

1. PKCE(Proof Key for Code Exchange): 공개 클라이언트(데스크톱 앱 등)에서도 안전하게 OAuth 플로우를 수행할 수 있다. 코드 인터셉션 공격을 방지한다.

2. 토큰 만료 및 갱신: Claude는 토큰 만료와 갱신을 지원한다. 공식 문서에 따르면 "서버가 이 기능을 지원해야 최상의 사용자 경험을 제공할 수 있다"고 권장한다.

3. OAuth Callback URL : Claude의 OAuth callback URL은 https://claude.ai/api/mcp/auth_callback이다. 향후 https://claude.com/api/mcp/auth_callback로 변경될 수 있으므로, 두 URL 모두 허용하는 것이 권장된다.

공식 문서 출처
OAuth 인증 사양은 MCP Authorization Spec에서 상세히 다루고 있다. AWS도 MCP 인증 구현에 기여하며 Java SDK PR을 제출했다.
AWS MCP 인증 가이드 →
💡팁
IP 허용목록(allowlist)만으로는 보안이 충분하지 않다. 공식 문서에서는 "가능한 경우 항상 OAuth 2.0을 인증에 사용하라"고 권장한다. 특히 원격 MCP 서버를 퍼블릭 인터넷에 노출하는 경우 OAuth 인증은 필수로 고려해야 한다.

> 인증 체계가 갖춰졌으니, 이제 성능 최적화를 살펴보자.

 

핵심 업데이트 #4 : Code Execution + MCP

2025년 5월 발표된 Code Execution Tool과 11월 4일에 공개된 "Code Execution with MCP" 접근법의 조합을 살펴보자.

Anthropic 엔지니어링 블로그에서 공개한 사례에 따르면, 이 조합으로 토큰 사용량을 98.7% 절감할 수 있다.

지표 기존 방식 Code Execution + MCP 개선율
토큰 사용량 약 150,000 토큰 약 2,000 토큰 98.7% 절감

※ 이 수치는 Anthropic 엔지니어링 블로그(2025.11.04)에서 발표한 특정 워크플로우 사례이며, 실제 환경에 따라 결과가 달라질 수 있다.

 

작동 원리

기존 방식에서는 도구 호출 결과와 중간 데이터를 모두 모델의 컨텍스트로 전달해야 했다. 대용량 데이터셋을 처리할 경우 토큰이 급격히 증가한다.

Code Execution with MCP 접근법은 다르게 작동한다:

Code Execution + MCP 워크플로우

  1. 데이터 접근: Claude가 파일시스템 기반 MCP API를 통해 데이터에 접근
  2. 코드 생성: 데이터 처리를 위한 Python 코드 생성
  3. 샌드박스 실행: 생성된 코드를 격리된 샌드박스에서 실행
  4. 결과 전달: 최종 결과만 모델 컨텍스트로 반환 (중간 데이터 제외)

핵심은 "대용량 중간 데이터가 모델 컨텍스트를 거치지 않는다"는 점이다. 데이터는 샌드박스 내 파일시스템에 머물고, 모델은 코드와 최종 결과만 처리한다.

 

Code Execution Tool 가격

Anthropic 공식 발표에 따르면:

  • 무료 제공: 일일 50시간 (조직 기준)
  • 추가 사용: 시간당 $0.05 (컨테이너 기준)
  • 최소 과금 단위: 5분

 

Files API & Extended Prompt Caching

2025년 5월 22일 Anthropic은 MCP Connector, Code Execution과 함께 두 가지 기능을 추가로 발표했다.

 

Files API

Files API는 문서를 한 번 업로드한 후 여러 대화에서 반복 참조할 수 있게 한다. 기존에는 매 요청마다 파일을 업로드해야 했지만, 이제 파일 ID로 참조할 수 있다. 지식 베이스, 기술 문서, 데이터셋을 다루는 애플리케이션에서 개발 워크플로우가 단순화된다.

Files API는 Code Execution Tool과 통합되어, 업로드된 파일을 코드 실행 중 직접 접근하고 처리할 수 있다. 차트나 그래프를 생성해 응답에 포함하는 것도 가능하다.

 

Extended Prompt Caching

기존 프롬프트 캐싱의 TTL(Time-To-Live)이 5분이었다면, Extended Prompt Caching은 1시간 TTL을 제공한다. 장기 실행 에이전트 워크플로우에서:

  • 비용 절감: 최대 90%
  • 지연 시간 감소: 최대 85%

MCP 기반 에이전트에서 동일한 시스템 프롬프트와 도구 정의를 반복 사용하는 경우, 1시간 캐싱은 상당한 비용 최적화 효과를 가져온다.

 

핵심 업데이트 #5 : OpenAI의 MCP 통합

2025년 3월 26일, OpenAI CEO Sam Altman이 MCP 지원을 발표하면서 MCP는 명실상부한 업계 표준이 되었다. OpenAI는 Agents SDK, Responses API, ChatGPT 데스크톱 앱 전반에 걸쳐 MCP를 통합했다.

 

OpenAI Agents SDK MCP 통합

OpenAI Agents SDK는 4가지 방식으로 MCP 서버와 연결할 수 있다:

통합 방식 설명 사용 시나리오
MCPServerStdio 로컬 프로세스 (stdin/stdout) 로컬 개발, 파일 시스템 접근
MCPServerSse HTTP+SSE 기반 원격 서버 기존 SSE 서버 연결
MCPServerStreamableHttp Streamable HTTP 기반 원격 서버 최신 원격 MCP 서버 (권장)
HostedMCPTool OpenAI 호스팅 MCP 서버 인프라 관리 없이 즉시 사용

OpenAI Agents SDK MCP 사용 예시 (Python)

실행 환경: Python 3.10+ | pip install openai-agents | Node.js (npx 사용 시) | OPENAI_API_KEY 환경변수 필요
from agents import Agent
from agents.mcp import MCPServerStdio

# 로컬 MCP 서버 연결 (Filesystem 예시)
async with MCPServerStdio(
    params={
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
    }
) as server:
    tools = await server.list_tools()
    agent = Agent(
        name="File Assistant",
        instructions="You help manage files",
        mcp_servers=[server]
    )
    # agent 사용...
공식 문서 출처
OpenAI Agents SDK MCP 문서 →

 

ChatGPT MCP 지원

ChatGPT의 MCP 지원은 단계적으로 출시되었다:

  • 2025년 9월 9일 (Developer Mode): Plus/Pro 사용자 대상 베타 출시. 로컬 stdio MCP 서버 연결 가능
  • 2025년 10월 13일 (공식 출시): 읽기/쓰기 모두 지원. 로컬 및 원격 MCP 서버 연결 가능

ChatGPT MCP는 Claude Desktop과 유사하게 chatgpt_config.json 파일로 설정하며, 설정 경로는 플랫폼에 따라 다르다:

  • macOS: ~/Library/Application Support/com.openai.chat/chatgpt_config.json
  • Windows: %LOCALAPPDATA%\com.openai.chat\chatgpt_config.json
ChatGPT MCP의 장점
• Claude와 동일한 MCP 서버를 재사용 가능
• 읽기/쓰기 양방향 지원 (Tool 호출 완전 지원)
• 로컬 및 원격 서버 모두 지원
(출처: InfoQ)

 

AGENTS.md: AI 코딩 에이전트 표준

OpenAI는 MCP 채택과 함께 AGENTS.md라는 새로운 표준도 발표했다. AGENTS.md는 프로젝트 루트에 배치하는 마크다운 파일로, AI 코딩 에이전트가 프로젝트를 어떻게 다뤄야 하는지 가이드를 제공한다.

AGENTS.md의 역할

  • 프로젝트 가이드: AI 에이전트에게 프로젝트 구조, 코딩 컨벤션, 테스트 방법 등을 알려줌
  • 도구 통합: MCP와 함께 사용하여 에이전트의 작업 범위와 방식을 정의
  • 표준화: 다양한 AI 코딩 도구에서 통일된 지침 사용 가능

2025년 8월 공개 이후 AGENTS.md는 60,000개 이상의 오픈소스 프로젝트에서 채택되었으며, Linux Foundation AAIF의 창립 프로젝트로 포함되었다.

> OpenAI의 적극적인 MCP 채택은 프로토콜의 산업 표준화를 가속화했다.

 

Linux Foundation 이관의 의미

2025년 12월 9일, Anthropic은 MCP를 Linux Foundation 산하 Agentic AI Foundation(AAIF)에 기부했다. AAIF는 Anthropic, Block, OpenAI가 공동 설립했으며, Google, Microsoft, AWS, Cloudflare, Bloomberg가 Platinum 멤버로 지원하고 있다.

AAIF에는 MCP 외에도 Block의 goose(오픈소스 AI 에이전트 프레임워크)와 OpenAI의 AGENTS.md(프로젝트별 AI 코딩 에이전트 가이드 표준)가 창립 프로젝트로 포함되었다.

이 이관이 개발자에게 의미하는 것:

  • 중립성: 특정 기업에 종속되지 않는 거버넌스
  • 장기 안정성: Linux Foundation의 검증된 오픈소스 관리 체계
  • 산업 표준화: 경쟁사들의 공동 참여로 사실상 표준 확립
  • 생태계 확장: 더 많은 기업과 개발자의 기여 예상
  • 기존 거버넌스 유지: 기존 SEP(Specification Enhancement Proposal) 프로세스와 메인테이너 체계 계속 유지

 

개발자를 위한  가이드

MCP 시작하기

MCP를 처음 접하는 개발자라면 다음 단계로 시작할 수 있다:

MCP 시작하기

  1. Claude Desktop 설치: claude.ai/download에서 다운로드
  2. 공식 MCP 서버 확인: github.com/modelcontextprotocol/servers에서 사전 구축된 서버 탐색
  3. 퀵스타트 가이드: modelcontextprotocol.io/quickstart에서 첫 MCP 서버 구축
  4. SDK 선택: Python, TypeScript, Java, C# 등 다양한 언어 SDK 제공

 

요금제별 MCP 지원 범위

MCP 지원은 로컬/원격 여부와 요금제에 따라 달라진다:

  • 로컬 MCP (stdio): Claude Desktop에서 모든 사용자 이용 가능
  • 원격 MCP (Streamable HTTP): Pro, Max, Teams, Enterprise 요금제 지원

iOS 및 Android용 Claude 앱도 원격 MCP 서버를 지원하며, claude.ai에서 이미 추가한 원격 서버의 도구, 프롬프트, 리소스를 사용할 수 있다.

 

MCP 서버 구축 시 권장사항

💡 팁
1. Streamable HTTP 사용: 새로 구축하는 원격 MCP 서버는 SSE 대신 Streamable HTTP를 사용하라. SSE 지원 중단이 예고되어 있다.

2. OAuth 인증 구현: 퍼블릭 인터넷에 노출되는 서버라면 OAuth 2.1 + PKCE 인증을 구현하라.

3. 토큰 갱신 지원: access token 만료와 refresh token을 지원하여 사용자 경험을 개선하라.

4. 세션 관리: Mcp-Session-Id를 활용해 상태 유지 세션을 구현하라.

5. 로컬 서버 시작: 처음이라면 stdio 기반 로컬 서버로 시작해 MCP 개념을 익힌 후 원격 서버로 확장하라.

 

기존 MCP 서버 호스팅 옵션

직접 MCP 서버를 구축하지 않고도 사용할 수 있는 옵션이 있다. 공식 문서에 따르면 Cloudflare는 자동 확장, OAuth 토큰 관리, 배포 기능을 갖춘 원격 MCP 서버 호스팅을 제공한다. Cloudflare Workers 기반으로 SSE와 Streamable HTTP 전송을 모두 지원한다.

 

트러블슈팅 : 흔히 겪는 문제와 해결법

MCP 서버 구축 시 자주 발생하는 문제와 해결 방법

문제 1: "MCP server not found" 또는 연결 실패

원인: 서버 경로가 잘못되었거나 필요한 런타임이 설치되지 않음

해결:

  • stdio 서버: command 경로가 절대 경로인지 확인 (예: /usr/local/bin/python)
  • npx 사용 시: Node.js 18+ 설치 여부 확인 (node --version)
  • Python 서버: 가상환경 활성화 여부 확인

문제 2: "Tool execution failed" 또는 도구 호출 실패

원인: 도구 함수 내 예외 발생, 파라미터 타입 불일치, 또는 권한 문제

해결:

  • 도구 함수 내에 try-except 구문 추가하여 상세 에러 로깅
  • Pydantic 모델로 파라미터 검증 (Field 타입 명시)
  • 파일 접근 시 권한 확인 (chmod, chown)

 문제 3: 원격 MCP 연결 시 "401 Unauthorized"

원인: OAuth 토큰 만료, 잘못된 인증 헤더, 또는 CORS 설정 문제

해결:

  • 토큰 만료 시간 확인 및 자동 갱신 로직 구현
  • Authorization 헤더 형식 확인: Bearer {token}
  • 서버에서 Access-Control-Allow-Origin 헤더 설정

문제 4: "Session expired" 또는 세션 유지 실패

원인: Mcp-Session-Id 누락 또는 서버 재시작으로 세션 소실

해결:

  • 모든 요청에 Mcp-Session-Id 헤더 포함 확인
  • 세션 저장소를 Redis 등 외부 스토리지로 분리 (서버 재시작 대비)
  • 세션 만료 시 자동 재초기화 로직 구현

💡 디버깅 팁: Claude Desktop 사용 시 ~/Library/Logs/Claude/mcp*.log (macOS) 또는 %APPDATA%\Claude\logs\ (Windows)에서 MCP 로그를 확인할 수 있다. 서버 측 로깅을 활성화하면 문제 진단이 훨씬 쉬워진다.

 

마무리 : 개발자를 위한 제언

MCP는 1년 만에 Anthropic의 실험적 프로토콜에서 AI 업계의 사실상 표준으로 성장했다. OpenAI, Google, Microsoft의 채택과 Linux Foundation 이관은 이 프로토콜의 장기적 안정성을 보장한다.

지금 시작하기 좋은 이유

  • 생태계 성숙: 10,000+ 서버, 다양한 SDK(Python, TypeScript, Java, C#)
  • 문서 풍부: 공식 퀵스타트, 튜토리얼, 예제 코드 완비
  • 중립 거버넌스: Linux Foundation 이관으로 벤더 락인 우려 해소
  • 실질적 효과: Code Execution 결합으로 토큰 비용 대폭 절감 가능

권장 첫 단계: Claude Desktop에서 로컬 MCP 서버로 시작 → 개념 익힌 후 원격 MCP로 확장. 공식 퀵스타트 가이드(modelcontextprotocol.io/quickstart)에서 30분 내에 첫 MCP 서버를 구축할 수 있다.

 

자주 묻는 질문 ❓

Q: 기존 SSE 기반 MCP 서버를 당장 마이그레이션해야 하는가?
A: 즉시 마이그레이션이 필수는 아니다. 공식 문서에 따르면 SSE 지원은 "향후 몇 개월 내에 중단될 수 있다"고 되어 있어 정확한 시점은 미정이다. 그러나 새로운 서버를 구축한다면 Streamable HTTP를 사용하는 것이 권장된다.
Q: MCP Connector와 직접 MCP 클라이언트 구현, 어떤 것을 선택해야 하는가?
A: Anthropic API를 사용하는 경우 MCP Connector가 대부분의 시나리오에서 더 간단하다. 연결 관리, 도구 검색, 에러 처리를 API가 자동으로 수행한다. 자체 호스팅 환경이나 커스텀 클라이언트 로직이 필요한 경우에만 직접 구현을 고려하라.
Q: Code Execution + MCP의 98.7% 토큰 절감을 모든 케이스에서 기대할 수 있는가?
A: 아니다. 이 수치는 Anthropic 엔지니어링 블로그에서 발표한 특정 워크플로우(대용량 데이터셋 처리)의 사례이다. 토큰 절감 효과는 워크플로우의 특성, 중간 데이터 크기, 처리 로직에 따라 크게 달라질 수 있다.
Q: 무료 요금제에서도 MCP를 사용할 수 있는가?
A: 로컬 MCP 서버(stdio 전송)는 Claude Desktop 무료 사용자도 이용 가능하다. 원격 MCP 서버(Streamable HTTP)는 Pro, Max, Teams, Enterprise 요금제에서 지원된다.
Q: MCP가 Linux Foundation으로 이관되면 기존 코드가 영향을 받는가?
A: 아니다. 기존 거버넌스 모델과 메인테이너 체계가 그대로 유지된다. 개발자 입장에서 코드 변경 없이 계속 사용할 수 있다.

참고 자료

300x250
Contents

포스팅 주소를 복사했습니다

이 글이 도움이 되었다면 공감 부탁드립니다.

💡 AI 관련 질문이 있나요? 눌러보세요!