> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> 모델 컨텍스트 프로토콜을 사용하여 에이전트를 외부 시스템 및 도구에 연결

모델 컨텍스트 프로토콜(MCP)은 데이터 소스와 AI 기반 도구 간의 안전한 양방향 연결을 구축할 수 있게 하는 개방형 표준입니다. MCP를 AI 에이전트가 데이터베이스, 파일 시스템, 웹 서비스, API 등 모든 외부 시스템과 원활하게 통신할 수 있게 하는 범용 번역기로 생각하세요.

## 개요

MCP 서버는 다음을 제공하여 에이전트의 기능을 확장합니다:

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

## 작동 방식

### 1. MCP 서버 연결

에이전트에 MCP 서버를 추가하면:

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

### 2. 도구 실행 흐름

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

### 3. 다중 서버

에이전트당 여러 MCP 서버를 구성할 수 있습니다:

* 각 서버는 자체 도구 세트를 제공합니다
* 도구는 서버 이름 접두사가 붙습니다 (예: `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 서버를 추가하고 구성하는 방법을 보려면 이 비디오를 시청하세요:

## 사용자 지정 MCP 서버 추가

### 1단계: MCP 구성에 접근

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

### 2단계: 새 서버 추가

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

### 3단계: 서버 설정 구성

#### 서버 이름

MCP 서버에 고유한 이름을 입력합니다 (예: `my-custom-server`, `weather-api`, `database-connector`).

**모범 사례:**

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

#### 전송 유형

에이전트가 MCP 서버와 통신하는 방법을 선택합니다:

**HTTP (streamable\_http)**

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

**SSE (Server-Sent Events)**

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

#### 서버 URL

MCP 서버의 엔드포인트 URL을 입력합니다:

**HTTP 예시:**

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

**SSE 예시:**

* `https://api.example.com/sse`
* `https://stream.example.com/events`

### 4단계: 인증 구성

#### 인증 없음

MCP 서버가 인증을 요구하지 않는 경우 **인증 없음**을 선택합니다.

#### OAuth 2.0

OAuth 보호 서버의 경우:

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

**OAuth 흐름:**

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

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

MCP 서버에 사용자 지정 HTTP 헤더가 필요한 경우:

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

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

**활성화** 확인란을 토글하여 서버의 활성 상태를 제어합니다:

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

### 7단계: 연결 테스트

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

### 8단계: 구성 저장

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

## MCP 서버 관리

### 구성된 서버 보기

**MCP** 탭에서 다음을 확인할 수 있습니다:

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

### 서버 구성 편집

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

### 서버 제거

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

<Warning>
  MCP 서버를 제거하면 해당 도구가 에이전트에서 사용 불가능해집니다.
  이러한 도구에 의존하는 활성 대화가 없는지 확인하세요.
</Warning>

## 전송 유형

### HTTP (streamable\_http)

**사용 시점:**

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

### SSE (Server-Sent Events)

**사용 시점:**

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

## 인증 방법

### 인증 없음

MCP 서버가 인증을 요구하지 않을 때 사용:

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

### OAuth 2.0

안전한 사용자 인증 접근에 사용:

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

## 사용자 지정 헤더

다음에 사용자 지정 헤더를 사용합니다:

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

## 사용 사례

### 오류 모니터링

**Sentry MCP 서버** - 애플리케이션 오류 및 성능 모니터링:

```json theme={null}
{
  "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"
}
```

### 데이터베이스 접근

**사용자 지정 데이터베이스 MCP 서버** - 데이터베이스에 연결:

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

### 파일 시스템 접근

**파일 시스템 MCP 서버** - 파일 및 디렉토리에 접근:

```json theme={null}
{
  "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 문서 확인
* 연결을 다시 인증
* 토큰 만료 설정 확인

### 도구를 사용할 수 없음

**문제**: MCP 서버 도구가 나타나지 않음

**가능한 원인:**

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

**솔루션:**

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

## 보안 고려 사항

### OAuth 보안

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

### 네트워크 보안

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

## 관련 기능

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

<Card title="툴킷" icon="toolbox" href="/agents/toolkits/overview">
  사전 빌드된 툴킷 및 통합 알아보기
</Card>

## 지원

MCP 서버에 대한 도움이 필요하세요? [support@automationanywhere.com](mailto:support@automationanywhere.com)으로 문의하세요.