다크 모드
MCP 설정
MCP 설정 화면에서는 Studio에서 사용할 MCP 서버를 추가하고, 서버가 제공하는 도구를 확인하고, 도구 호출을 테스트할 수 있습니다. MCP 도구를 연결하면 채팅, 에이전트, 워크플로우가 외부 시스템의 기능을 사용할 수 있습니다.
화면 예시
등록된 MCP 서버의 연결 설정, 사용 가능한 도구, 테스트와 편집 액션을 확인할 수 있습니다.
MCP 서버 추가
- 좌측 사이드바에서 MCP 설정으로 이동합니다.
- 서버 추가를 선택합니다.
- 서버 이름과 연결 정보를 입력합니다.
- 필요한 경우 인증 정보를 설정합니다.
- 설정 저장을 선택합니다.
서버 이름은 영문자, 숫자, 하이픈을 사용해 작성하는 것을 권장합니다. 이름은 채팅과 도구 목록에서 식별자로 사용됩니다.
권한 제한
조직 설정에 따라 MCP 서버 추가가 비활성화될 수 있습니다. 서버 추가 버튼이 보이지 않거나 비활성화되어 있으면 관리자에게 문의하세요.
연동 전 체크리스트
| 항목 | 확인 내용 |
|---|---|
| 연결 방식 | 서버가 SSE, Stdio, HTTP 등 Studio에서 지원하는 방식으로 제공되는지 확인합니다. |
| 인증 방식 | OAuth, API 키, 토큰 등 필요한 인증 정보를 준비합니다. |
| 도구 설명 | 각 도구의 목적, 입력값, 실행 결과가 명확하게 설명되어 있는지 확인합니다. |
| 권한 범위 | 도구가 외부 시스템에서 읽기만 하는지, 쓰기/삭제 같은 변경 작업을 수행하는지 확인합니다. |
| 테스트 데이터 | 실제 운영 데이터 대신 테스트 가능한 안전한 입력값을 준비합니다. |
도구 목록 확인
서버가 정상적으로 연결되면 사용 가능한 도구 목록에서 도구 이름, 설명, 입력 스키마를 확인할 수 있습니다.
| 항목 | 설명 |
|---|---|
| 도구 이름 | 채팅이나 워크플로우에서 호출되는 도구의 이름입니다. |
| 설명 | AI가 도구 사용 시점을 판단하는 데 참고하는 설명입니다. |
| 입력 스키마 | 도구 호출에 필요한 입력값 구조입니다. |
| 인증 상태 | OAuth 등 추가 인증이 필요한지 확인합니다. |
도구 설명 작성 기준
AI가 도구를 안정적으로 선택하려면 도구 설명이 구체적이어야 합니다.
| 좋은 설명에 포함할 내용 | 예시 |
|---|---|
| 사용 목적 | "GitHub 저장소의 이슈를 생성합니다." |
| 필요한 입력 | "title, body, repository가 필요합니다." |
| 사용 조건 | "새 작업 항목을 추적해야 할 때 사용합니다." |
| 결과 | "생성된 이슈 번호와 URL을 반환합니다." |
| 제한 사항 | "삭제 작업은 수행하지 않습니다." |
주의
도구 설명이 모호하면 AI가 불필요한 상황에서 도구를 호출하거나, 비슷한 도구 중 잘못된 도구를 선택할 수 있습니다.
도구 테스트
- MCP 서버 상세 화면에서 테스트할 도구를 선택합니다.
- 입력 JSON을 직접 작성하거나 AI로 입력 생성을 사용합니다.
- 도구 호출을 선택합니다.
- 결과와 오류 메시지를 확인합니다.
도구 테스트는 채팅에 연결하기 전에 입력 스키마와 응답 형식을 검증하는 데 유용합니다.
OAuth 인증
일부 MCP 서버는 도구 사용 전에 OAuth 인증이 필요합니다. 인증이 필요한 서버는 인증 필요 상태로 표시됩니다.
- 인증이 필요한 서버 또는 도구를 선택합니다.
- 인증을 클릭합니다.
- 외부 인증 화면에서 권한을 승인합니다.
- Studio로 돌아와 인증 성공 상태를 확인합니다.
사용자 지정 지침
MCP 서버 또는 개별 도구에 사용자 지정 지침을 추가할 수 있습니다. 이 지침은 해당 도구를 사용할 때 시스템 프롬프트에 함께 반영됩니다.
예시:
text
email 입력값은 항상 example@example.com 형식으로 작성하세요.
조회 결과가 여러 개인 경우 최신 항목 3개만 요약하세요.참고
서버 전체에 적용할 규칙은 MCP 서버 지침에, 특정 도구에만 필요한 규칙은 도구 사용자 지정 지침에 작성하세요.
채팅에서 사용하기
MCP 도구는 채팅의 도구 설정에서 선택하거나 @mention으로 직접 호출할 수 있습니다. 자동 모드에서는 AI가 대화 맥락에 따라 적합한 도구를 선택합니다.
에이전트와 워크플로우에 연결하기
MCP 도구는 단독으로도 사용할 수 있지만, 에이전트나 워크플로우와 연결하면 반복 업무에 더 안정적으로 활용할 수 있습니다.
| 연결 대상 | 권장 방식 |
|---|---|
| 에이전트 | 도구를 언제 사용할지 지침에 명확히 적습니다. 예: "고객 정책 질문은 정책 검색 도구를 먼저 사용합니다." |
| 워크플로우 | Tool 노드에 MCP 도구를 연결하고 입력 스키마와 결과 스키마를 확인합니다. |
| 채팅 프리셋 | 자주 쓰는 도구 묶음을 저장해 매번 선택하지 않아도 되게 합니다. |
쓰기, 수정, 삭제 작업을 수행하는 도구는 자동 호출보다 수동 승인 흐름으로 운영하는 것이 안전합니다.