MCP (모델 컨텍스트 프로토콜)

​

개요

• 외부 도구 접근 - 타사 서비스 및 API에 연결
• 데이터 소스 통합 - 데이터베이스, 파일 시스템, 클라우드 스토리지 접근
• 사용자 지정 기능 - 특정 사용 사례를 위한 전문 도구 추가
• 표준화된 인터페이스 - 모든 통합에 대한 일관된 프로토콜 사용
• 안전한 인증 - OAuth 2.0 및 사용자 지정 헤더 지원

​

작동 방식

​

1. MCP 서버 연결

1. 서버 등록 - 서버가 에이전트 구성에 등록됩니다
2. 도구 검색 - 에이전트가 MCP 서버에서 사용 가능한 도구를 검색합니다
3. 도구 통합 - 도구가 대화 중 에이전트에서 사용 가능해집니다
4. 동적 실행 - 에이전트는 필요에 따라 이러한 도구를 호출할 수 있습니다

​

2. 도구 실행 흐름

사용자 쿼리 → 에이전트 → MCP 도구 호출 → MCP 서버 → 외부 시스템 → 응답 → 에이전트 → 사용자

​

3. 다중 서버

• 각 서버는 자체 도구 세트를 제공합니다
• 도구는 서버 이름 접두사가 붙습니다 (예: sentry_get_errors)
• 서버는 독립적으로 활성화 또는 비활성화할 수 있습니다

​

빠른 시작

​

인기 MCP 서버 추가

1. 사이드바에서 에이전트로 이동
2. 에이전트를 선택하거나 새로 만들기
3. 편집을 클릭하여 에이전트 빌더 열기
4. MCP 탭으로 이동
5. 인기 서버 빠르게 추가 섹션에서 서버 타일을 클릭하여 추가

​

인기 서버

​

Sentry

• URL: https://mcp.sentry.dev/mcp
• 전송: HTTP
• 인증: OAuth 2.0
• 범위: org:read project:write team:write event:write

• 오류 보고서 보기
• 성능 메트릭 모니터링
• 프로젝트 및 팀 관리
• 이벤트 및 문제 추적

​

비디오 자습서

​

사용자 지정 MCP 서버 추가

​

1단계: MCP 구성에 접근

1. 사이드바에서 에이전트로 이동
2. 에이전트를 선택하거나 새로 만들기
3. 편집을 클릭하여 에이전트 빌더 열기
4. MCP 탭으로 이동
5. 고급 구성 섹션으로 스크롤

​

2단계: 새 서버 추가

1. 서버 추가 버튼 클릭
2. 서버 구성 양식이 나타남

​

3단계: 서버 설정 구성

​

서버 이름

• 소문자와 하이픈 사용
• 설명적이되 간결하게
• 특수 문자 사용 금지

​

전송 유형

• 표준 HTTP 요청
• REST API 및 웹 서비스에 적합
• 요청/응답 패턴 지원

• 실시간 스트리밍 통신
• 실시간 데이터 피드에 적합
• 단방향 서버- 클라이언트 스트리밍 지원

​

서버 URL

• https://api.example.com/mcp
• http://localhost:8000/mcp/
• https://mcp.example.com/v1

• https://api.example.com/sse
• https://stream.example.com/events

​

4단계: 인증 구성

​

인증 없음

​

OAuth 2.0

1. 인증 방법으로 OAuth 2.0을 선택
2. OAuth 범위를 입력 (공백으로 구분)
   • 예시: read write admin
   • 예시: org:read project:write team:write

• 사용자가 에이전트와 상호작용하면 인증을 요청받음
• 인증은 자동으로 처리됨
• 토큰은 안전하게 저장되고 필요에 따라 새로고침됨

​

5단계: 사용자 지정 헤더 (선택 사항)

1. 헤더 추가 클릭
2. 헤더 이름 입력 (예: X-API-Key, Authorization)
3. 헤더 값 입력
4. 필요에 따라 추가 헤더 추가

​

6단계: 서버 활성화/비활성화

• 활성화: 서버 도구가 에이전트에서 사용 가능
• 비활성화: 서버 도구가 숨겨지지만 구성은 보존됨

​

7단계: 연결 테스트

1. 테스트 버튼을 클릭하여 연결 확인
2. 테스트 결과를 기다립니다:
   • 성공: 서버에 접근 가능하고 올바르게 구성됨
   • 오류: 구성 및 네트워크 연결 확인

​

8단계: 구성 저장

1. 저장을 클릭하여 MCP 서버 구성 저장
2. 서버가 이제 에이전트에서 사용 가능

​

MCP 서버 관리

​

구성된 서버 보기

• 서버 수 - 구성된 서버 수
• 서버 상태 - 활성화/비활성화 상태
• 서버 이름 - 구성된 모든 서버 목록

​

서버 구성 편집

1. 고급 구성 섹션에서 서버를 찾습니다
2. 클릭하여 서버 구성을 펼칩니다
3. 설정을 수정합니다
4. 테스트를 클릭하여 변경 사항 확인
5. 구성은 자동으로 저장됩니다

​

서버 제거

1. 제거할 서버를 찾습니다
2. 제거 아이콘(휴지통)을 클릭
3. 제거를 확인
4. 서버가 에이전트 구성에서 제거됩니다

​

전송 유형

​

HTTP (streamable_http)

• REST API에 연결할 때
• 표준 요청/응답 패턴
• 웹 서비스 및 마이크로서비스

​

SSE (Server-Sent Events)

• 실시간 데이터 스트림
• 실시간 업데이트 및 알림
• 단방향 서버- 클라이언트 통신

​

인증 방법

​

인증 없음

• 공개 API
• 내부 서비스
• 개발/테스트 서버

​

OAuth 2.0

• 타사 서비스 (Sentry, Canva 등)
• 사용자별 데이터 접근
• 범위가 지정된 권한

​

사용자 지정 헤더

• API 키
• 사용자 지정 인증 토큰
• 서비스별 헤더
• 요청 메타데이터

​

사용 사례

​

오류 모니터링

{
  "server_name": "sentry",
  "transport": "streamable_http",
  "url": "https://mcp.sentry.dev/mcp",
  "auth_type": "oauth",
  "oauth_scopes": "org:read project:write team:write event:write"
}

​

데이터베이스 접근

{
  "server_name": "postgres-db",
  "transport": "streamable_http",
  "url": "https://mcp.example.com/database",
  "auth_type": "oauth"
}

​

파일 시스템 접근

{
  "server_name": "filesystem",
  "transport": "streamable_http",
  "url": "https://mcp.example.com/files",
  "auth_type": "oauth"
}

​

모범 사례

​

서버 명명

• 설명적으로 작성: 명확하고 의미 있는 이름 사용
• 소문자 사용: 하이픈을 포함한 소문자 선호
• 특수 문자 사용 금지: 문자, 숫자, 하이픈으로 제한

​

URL 구성

• HTTPS 사용: 항상 안전한 연결 선호
• 전체 경로 포함: 완전한 엔드포인트 URL 지정
• URL 테스트: 저장하기 전에 URL 접근 가능 여부 확인

​

인증

• 가능하면 OAuth 사용: API 키보다 더 안전
• 범위 최소화: 필요한 권한만 요청
• 테스트 인증: OAuth 흐름이 올바르게 작동하는지 확인

​

트러블슈팅

​

연결 실패

• 잘못된 URL
• 네트워크 연결 문제
• 서버가 실행 중이 아님
• 방화벽이 연결을 차단

• URL이 올바르고 접근 가능한지 확인
• 네트워크 연결 확인
• 서버가 실행 중인지 확인
• 방화벽 규칙 검토

​

인증 오류

• 잘못된 OAuth 범위
• 서버가 OAuth를 지원하지 않음
• 사용자가 인증하지 않음
• 토큰 만료

• OAuth 범위가 올바른지 확인
• 서버 OAuth 문서 확인
• 연결을 다시 인증
• 토큰 만료 설정 확인

​

도구를 사용할 수 없음

• 서버가 비활성화됨
• 연결이 설정되지 않음
• 서버가 응답하지 않음
• 도구 검색 실패

• 서버를 활성화
• 연결을 테스트
• 서버가 실행 중인지 확인
• 서버 로그 확인

​

보안 고려 사항

​

OAuth 보안

• 토큰 저장: 토큰은 안전하게 저장됩니다
• 토큰 새로고침: 만료 시 자동 토큰 새로고침
• 범위 제한: 최소 필요한 범위만 요청
• 사용자 인증: 사용자가 명시적으로 인증해야 합니다

​

네트워크 보안

• HTTPS 전용: 프로덕션 서버에는 항상 HTTPS 사용
• 내부 네트워크: 프라이빗 서버에는 내부 URL 사용
• 방화벽 규칙: 적절하게 방화벽 구성
• VPN 접근: 필요 시 안전한 연결을 위해 VPN 사용

​

관련 기능

• 툴킷 - 사전 빌드된 통합 및 도구
• 도구 - 사용자 지정 도구 및 작업
• 에이전트 구성 - 에이전트 동작 구성
• API 통합 - 외부 API에 연결

​

지원