MCP 연동 및 보안

Model Context Protocol(MCP)은 AI 애플리케이션과 외부 시스템을 연결하는 개방형 프로토콜입니다. 호환 클라이언트는 각 데이터 소스의 연동 프로토콜을 별도로 설계하지 않고 MCP Server로 컨텍스트를 가져오거나 도구를 호출하거나 미리 정의된 프롬프트를 사용할 수 있습니다.

MCP 동작 방식

하나의 MCP Host는 여러 MCP Server에 연결하고 Server별로 독립된 MCP Client를 생성할 수 있습니다.

MCP는 데이터 계층과 전송 계층으로 나뉩니다. 데이터 계층은 JSON-RPC 메시지, 기능 검색 및 Primitives를 정의하고 전송 계층은 로컬 프로세스나 네트워크 사이의 메시지 전달 방식을 담당합니다. 클라이언트가 보통 이러한 세부 사항을 캡슐화하므로 연동 시 클라이언트의 MCP 설정 진입점을 우선 사용합니다.

Server가 제공하는 기능

MCP Server는 주로 세 가지 Primitives를 제공합니다.

Server는 지원 기능을 선언하고 클라이언트는 사용할 수 있는 Tools, Resources 및 Prompts를 검색합니다. Server가 기능을 제공해도 클라이언트가 반드시 활성화하는 것은 아닙니다. 최종 동작은 Host 버전, 권한 정책 및 사용자 선택에도 좌우됩니다.

전송 방식 선택

현재 MCP 규격은 stdio와 Streamable HTTP의 두 가지 표준 전송을 정의합니다.

stdio에서는 Server의 stdout에 MCP 메시지만 출력하고 로그는 stderr에 기록해야 합니다. 연결에 실패하면 클라이언트가 수집한 stderr 로그를 확인할 수 있지만 자격 증명이 포함된 전체 로그를 타사에 보내지 않습니다.

현재 Streamable HTTP는 단일 POST Endpoint를 사용하므로 GET 또는 기존 HTTP+SSE 주소를 별도로 설정할 필요가 없습니다. 인증 방식은 Server가 결정합니다. OAuth 흐름이 제공되면 장기 자격 증명을 공유 설정에 직접 기록하기보다 해당 승인 페이지에 따라 인증합니다.

설정 구조 이해

클라이언트마다 필드 이름과 설정 위치가 완전히 같지는 않습니다. 다음은 일반적인 구조 예시이며 그대로 실행할 수 없습니다. Server 배포자의 실제 명령, 매개변수, URL 및 인증 방식으로 모든 자리표시자를 교체합니다.

{
  "mcpServers": {
    "replace-with-server-name": {
      "command": "/absolute/path/to/server-command",
      "args": [
        "--replace-with-required-argument"
      ],
      "env": {
        "SERVICE_API_KEY": "replace-with-client-supported-secret-reference"
      }
    }
  }
}

안전한 연동 단계

권한 검토 체크리스트

원격 Server는 신뢰할 수 있는 HTTPS 주소에만 연결하고 해당 인증 흐름에 따라 승인합니다. 로컬 Server는 절대 명령 경로, 격리 디렉터리 및 일반 사용자 권한을 우선 사용하며 편의를 위해 관리자 권한으로 바로 실행하지 않습니다.

자주 묻는 질문

지속적인 사용 권장 사항

• 연결된 Server, 버전, Tool 목록 및 승인 범위를 정기적으로 검토합니다.
• Server마다 독립적이고 철회 가능한 최소 권한 자격 증명을 사용합니다.
• 특히 삭제, 쓰기, 결제, 메시지 발송 및 운영 시스템 작업에서 수동 확인을 유지합니다.
• 알 수 없는 Resource 또는 Tool 결과의 지시를 신뢰할 수 있는 시스템 지시로 취급하지 않습니다.
• 로그, 스크린샷 및 오류 보고서에서 Key, Token, 고객 데이터 및 민감한 경로를 제거해야 합니다.
• Server 사용을 중단할 때는 클라이언트에서 설정을 제거하고 관련 자격 증명을 철회합니다.

모델 클라이언트에 AGTCloud를 설정하려면 CC-Switch 연동 튜토리얼부터 읽거나 왼쪽 타사 통합 디렉터리에서 도구를 선택합니다. 모델 엔드포인트와 요청 필드는 API Reference를 확인합니다. MCP 프로토콜 세부 사항과 버전 변경은 MCP 공식 문서를 기준으로 합니다.