AI 시스템 간 효율적 연결의 핵심

소개

AI와 외부 시스템, 도구, 데이터베이스를 안정적으로 효율적으로 연결하려면 표준화된 프로토콜이 필수입니다.
MCP(Model Context Protocol)는 이러한 연결을 위한 핵심 표준으로, 프로토콜 협상 및 기능 교환 과정을 통해 다양한 AI와 도구가 유연하게 통신할 수 있게 해줍니다.

MCP(Model Context Protocol)는 이러한 연결을 위한 핵심 표준으로, 프로토콜 협상 및 기능 교환 과정을 통해 다양한 AI와 도구가 유연하게 통신할 수 있게 해줍니다.

이번 포스팅에서는 MCP의 프로토콜 협상 절차와 기능 교환 방식, 그리고 실무 적용 시 주의할 점을 살펴 정리합니다.

MCP 프로토콜 협상이란?

MCP 프로토콜 협상은 클라이언트와 서버가 연결을 시작할 때, 서로 지원 가능한 프로토콜 버전과 기능(도구, 리소스)을 자동으로 맞추는 과정입니다.

이 과정을 통해 버전 불일치, 기능 미지원 등으로 인한 오류를 사전에 방지하고, 실제 사용할 수 있는 기능만 활성화하여 안정적인 통합을 보장합니다.

프로토콜 협상 단계별 흐름

1. 연결 초기화(Handshake)

• 클라이언트 → 서버: initialize 요청
  • 클라이언트가 지원하는 프로토콜 버전과 기능(capabilities)을 서버에 전달합니다.
  • 예시

{
  "method": "initialize",
  "params": {
    "protocolVersion": ["1.0", "2.0"],
    "capabilities": {
      "tools": ["search", "fileRead"],
      "resources": ["documents", "images"]
    },
    "clientInfo": {"name": "MyAgent", "version": "1.0"}
  }
}

• 서버 → 클라이언트: initialize 응답
  • 서버가 선택한 프로토콜 버전과 실제 지원 가능한 기능 목록을 반환합니다.
  • 예시:

{
  "result": {
    "protocolVersion": "2.0",
    "capabilities": {
      "tools": ["search"],
      "resources": ["documents"]
    },
    "serverInfo": {"name": "DocServer", "version": "1.2"},
    "instructions": "API_KEY 필요"
  }
}

• 초기화 완료 신호를 보내고, 이후 본격적인 작업이 시작됩니다.

2. 기능 교환 및 동적 확장

• 기능 교환 원칙

  • 클라이언트와 서버가 모두 지원하는 기능만 활성화됩니다.
  • 세션 중간에 서버가 새로운 도구나 리소스를 추가하거나 제거하면 listChanged 알림을 통해 실시간으로 기능 목록이 갱신됩니다.

• 실제 코드

// 도구 호출
{
  "method": "tools/call",
  "params": {"name": "search", "arguments": {"query": "MCP 프로토콜"}}
}
// 기능 변경 알림
{
  "method": "listChanged",
  "params": {"added": ["imageSearch"], "removed": []}
}

3. 협상 실패 시 대응

• 버전 불일치

  • 서버가 지원하지 않는 버전 요청 시 오류 메시지 반환

• 기능 불일치

  • 서버가 지원하지 않는 기능 요청 시 오류 메시지 반환

기술적 특징 및 보안

• 프로토콜: JSON-RPC 2.0 기반, HTTP/SSE/StdIO 등 다양한 전송 방식 지원
• 확장성: capabilities 필드를 통해 사용자 정의 기능 추가 가능
• 보안: 초기화 단계에서 API_KEY, 인증 토큰 등 교환 및 권한 제어
• 감사 로그: 모든 협상 과정은 로그 기능으로 기록

구현 코드: Node.js에서 MCP 서버 구현하기

const express = require('express');
const app = express();
app.use(express.json());

// 지원 가능한 기능 목록
const serverCapabilities = {
  tools: ['search', 'calculator'],
  resources: ['documents', 'images']
};

// 초기화 핸들러
app.post('/mcp', (req, res) => {
  if (req.body.method === 'initialize') {
    const clientProtocols = req.body.params.protocolVersion;
    const clientCapabilities = req.body.params.capabilities;
    
    // 프로토콜 버전 선택 (최신 버전 우선)
    const supportedVersion = clientProtocols.includes('2.0') ? '2.0' : '1.0';
    
    // 공통 기능 필터링
    const negotiatedCapabilities = {
      tools: clientCapabilities.tools.filter(tool => 
        serverCapabilities.tools.includes(tool)
      ),
      resources: clientCapabilities.resources.filter(resource => 
        serverCapabilities.resources.includes(resource)
      )
    };
    
    // 응답 반환
    res.json({
      result: {
        protocolVersion: supportedVersion,
        capabilities: negotiatedCapabilities,
        serverInfo: {name: "MCPServer", version: "1.0"},
        instructions: "API_KEY 필요"
      }
    });
  } else {
    // 다른 메서드 처리
    // ...
  }
});

app.listen(3000, () => {
  console.log('MCP 서버가 3000 포트에서 실행 중입니다.');
});

실제 활용 사례

1. AI 어시스턴트와 검색 도구 연결

• MCP를 통해 AI 모델이 웹 검색, 데이터베이스 쿼리 등의 외부 도구를 안전하게 활용

2. 다중 AI 시스템 연계

• 서로 다른 기능을 가진 여러 AI 시스템이 MCP를 통해 상호 호환되는 기능만 선택적으로 사용

3. 동적 기능 확장

• 사용자 요구에 따라 실시간으로 필요한 도구와 리소스를 추가하거나 제거

마무리

MCP의 프로토콜 협상 및 기능 교환 메커니즘은 AI와 다양한 외부 시스템, 도구, 데이터베이스가 맞춤형 상호 작용을 자동으로 맞추고, 안전하게 통합될 수 있도록 핵심적인 역할을 합니다

실무에서는 이 구조를 이해하고, 각 단계별로 적절한 예외 처리와 보안 설정을 적용하는 것이 중요합니다.

참고자료

• JSON-RPC 2.0 명세