4.5. 외부 도구(MCP) 연결
개요
MCP(Model Context Protocol)는 AI 에이전트가 외부 서비스(일정, 이슈 관리, 사내 문서 시스템 등)를 쓰게 해 주는 연결입니다. 연결하면 AI 에이전트가 「오늘 일정 알려 줘」「이 이슈에 댓글 달아 줘」 같은 일을 대신할 수 있습니다. 연결할 서비스가 정해져 있고, 그 서비스 담당자에게 주소나 키를 받았을 때 이 장을 봅니다. 이 장은 MCP 서버(연결 하나) 추가, 연결 시험, 로그인, 켜고 끄기, 삭제, 도구 묶음 켜고 끄기를 설명합니다. 도구 묶음은 AI 에이전트가 기본으로 가진 도구를 묶음 단위로 켜고 끄는 설정입니다.
권한: 서버는 AI 에이전트 작업공간의 주인이나 관리자가 추가합니다. 권한이 없으면 「MCP 서버를 추가할 권한이 없습니다」가 나옵니다. 이때는 관리자에게 「<프로파일 이름> 에 <서비스 이름> MCP 연결을 추가해 주세요. 주소는 <담당자에게 받은 주소> 입니다」라고 요청합니다.
주의: 연결한 서버는 내가 넣은 키의 권한으로 동작합니다. 오피스나 회의실에서 다른 사람이 이 AI 에이전트에게 일을 시켜도 같은 권한을 씁니다. 그러므로 개인 계정의 전체 권한 키가 아니라 읽기만 되는 키처럼 권한을 줄인 키를 받아 넣습니다. 방법은 그 서비스 담당자에게 묻습니다.
「MCP · 도구 묶음」 탭 열기
- 왼쪽 메뉴의 「내 AI 에이전트 › 프로파일」에서 내 주 프로파일 행을 눌러 상세 서랍을 엽니다.
- 「MCP · 도구 묶음」 탭을 엽니다.
그림 4.5-1. 「MCP · 도구 묶음」 탭
탭에는 「MCP 서버」 구역과 「도구 묶음」 구역이 있습니다. 위의 검색 칸에서 이름으로 찾고, 「전체」「켜짐」「꺼짐」으로 거를 수 있습니다. 서버는 AI 에이전트 작업공간의 주인이나 관리자가 추가합니다. 권한이 없으면 「MCP 서버를 추가할 권한이 없습니다」가 나옵니다.
MCP 서버 추가하기
- 「MCP 서버」 구역 제목 옆의 「서버 추가」를 누릅니다.
- 「추가 방식」에서 방식을 고릅니다.
- 방식에 맞는 칸을 채웁니다.
- 「추가」를 누릅니다.
추가 방식은 세 가지입니다. 처음에는 「카탈로그」가 열립니다. 목록에 있는 서비스는 카탈로그를 씁니다. 「원격 주소」와 「프로그램 실행」은 관리자나 개발자가 알려 준 값을 그대로 넣을 때만 씁니다.
카탈로그
- 「카탈로그 검색」에서 서버를 찾습니다.
- 서버 행의 「설치」를 누릅니다.
- 필요한 값(주소, 키)을 넣고 저장합니다.
이미 설치한 서버는 「설치됨」으로 나옵니다. 이 환경에서 바로 설치할 수 있는 서버가 없으면 「원격 주소로 직접 추가하세요」라는 안내가 나옵니다. 일부 서버(프로그램 실행 방식의 OAuth 서버, 설치가 필요한 서버)는 이 화면에서 지원하지 않아 숨겨집니다. 사내 위키 서버(Docmost, Outline)를 연결하는 방법은 5.7. 사내 위키 연결 스킬에서 설명합니다.
원격 주소와 프로그램 실행
카탈로그에 없는 서비스는 관리자나 개발자가 알려 준 값을 넣어 추가합니다. 알려 준 값이 없으면 이 방식을 쓰지 않습니다.
| 방식 | 알려 받을 값 |
|---|---|
| 원격 주소 | 서버 주소, 인증 방식(「없음」「토큰」「OAuth」 중 하나), 토큰이 필요하면 토큰 |
| 프로그램 실행 | 실행 파일 이름, 인자, 필요한 환경변수 이름과 값 |
- 「이름」에 영문, 숫자,
-,_로 이름을 적습니다. 영문이나 숫자로 시작합니다. - 알려 받은 값을 같은 이름의 칸에 그대로 넣습니다.
- 「추가」를 누릅니다.
그림 4.5-2. 「MCP 서버 추가」 창(원격 주소)
「토큰」을 고르면 저장한 뒤 다시 볼 수 없습니다. 「OAuth」를 고르면 추가한 뒤 서버 줄의 「로그인」을 눌러 로그인합니다. 화면에 「콜백 주소」가 나오면 그 주소를 서버 담당자에게 전달해 등록을 부탁합니다. 「프로그램 실행」은 처음 연결할 때 프로그램을 내려받으므로 담당자가 확인해 준 것만 씁니다. 주소나 인자에 키처럼 보이는 글자가 있으면 거절됩니다. 키는 환경변수 칸이나 비밀값 탭(4.4. 비밀값과 인증 파일)에 넣습니다. 같은 AI 에이전트 작업공간에 둘 수 있는 프로그램 실행 서버 수에는 한도가 있습니다.
주소가 허용되지 않으면 경고가 나옵니다. 사용자는 「관리자에게 요청」으로 요청을 보내고, 관리자는 확인한 뒤 「그래도 추가」를 누를 수 있습니다.
암호화되지 않은 주소(http, 사내 IP)에서 AAS 에 접속하면 토큰과 비밀값을 넣을 수 없습니다. 이때는 https 주소로 접속합니다.
연결 시험
서버 줄의 「연결 시험」을 누릅니다. 연결되면 「<이름>: 연결됨 · 도구 n개」가 나옵니다. 첫 연결은 30~40초까지 걸릴 수 있습니다. 시험이 시간 안에 끝나지 않으면 한 번 더 시험합니다. 시험이 실패해도 새 대화에서는 연결될 수 있으므로, 새 대화에서 한 번 시켜 봅니다. 실패하면 「연결하지 못했습니다」와 오류 문장이 나오니, 문장을 따라 주소나 키를 고칩니다. 「연결은 됐지만 도구가 없습니다」가 나오면 서버 쪽 설정을 확인합니다.
OAuth 로그인
OAuth 서버는 로그인해야 AI 에이전트가 도구를 쓸 수 있습니다. 서버 줄의 상태가 다음 중 하나로 나옵니다.
| 상태 | 뜻 |
|---|---|
| 로그인 필요 | 로그인해야 도구를 씁니다. |
| 로그인 중 | 팝업에서 로그인하는 중입니다. |
| 연결하는 중 | 로그인했습니다. AI 에이전트가 서버에 연결하는 중이며 최대 1분 걸립니다. |
| 연결됨 | 도구를 쓸 수 있습니다. 「연결됨 · 도구 n개」로 나오기도 합니다. |
| 다시 로그인 필요 | 로그인이 만료됐습니다. |
| 연결 실패 | 연결하지 못했습니다. |
- 서버 줄의 「로그인」(만료되면 「다시 로그인」)을 누릅니다.
- 열린 팝업에서 서버의 로그인을 마칩니다.
- 상태가 「연결됨」으로 바뀌는지 확인합니다.
로그인은 AI 에이전트 작업공간 소유자가 해야 합니다. 소유자가 아니면 소유자에게 로그인을 부탁합니다. 로그인이 필요하거나 만료되면 받은편지함에 「MCP 로그인」 알림이 오며, 「MCP 탭 열기」로 바로 이동할 수 있습니다.
켜고 끄기, 삭제, 적용
서버 줄과 도구 묶음 줄의 스위치로 켜고 끕니다. 끄면 확인 창이 나오며, AI 에이전트가 그 서버나 묶음의 도구를 쓰지 않게 됩니다. 스위치는 언제든 다시 켤 수 있습니다.
서버 삭제와 되돌리기
- 서버 줄의 「<이름> 삭제」를 누릅니다.
- 확인 창을 읽고 확인합니다.
서버를 지우면 그 서버를 쓰던 스킬과 예약 작업이 실패할 수 있습니다. 이 서버만 쓰던 비밀값도 함께 지워집니다. 지운 서버는 다시 쓸 수 없고, 되돌리는 기능은 없습니다. 다시 쓰려면 서버를 새로 추가하고 키를 새로 넣습니다. 삭제하기 전에 잠시 쓰지 않는 것이라면 지우지 말고 스위치로 끕니다.
적용
서버를 추가하거나 지우거나 켜고 끄면 1~2분 안에 반영되고, AI 에이전트는 새 대화에서 바뀐 도구를 씁니다. 열려 있는 대화에는 새 도구가 없으므로 「새 대화」를 시작합니다. 이미 있는 서버의 주소나 키, 쓸 수 있는 도구의 범위(예: 쓰기 도구)를 바꾼 경우에는 게이트웨이(AI 에이전트가 메신저와 예약 작업을 받는 통로)를 다시 시작해야 반영됩니다. 탭 위의 안내에서 「지금 적용(게이트웨이 다시 시작)」을 누릅니다. 이 버튼은 서버를 바꾼 주인이나 관리자가 누릅니다.
주의: 게이트웨이를 다시 시작하는 동안 이 AI 에이전트 작업공간의 메신저 연결과 예약 작업이 잠깐 멈추고, 진행 중인 대화가 끊길 수 있습니다. 확인 창을 읽고 진행합니다. 버튼이 보이지 않으면 관리자에게 요청합니다.
도구 묶음
「도구 묶음」 구역에는 AI 에이전트가 기본으 로 가진 도구가 묶음별로 나옵니다. 묶음 줄에는 설명과 도구 수가 함께 나옵니다. 스위치로 묶음을 켜고 끕니다. 「설정 필요」가 붙은 묶음은 먼저 필요한 키를 넣어야 쓸 수 있습니다. 키는 4.4. 비밀값과 인증 파일에서 넣습니다. 사내 위키 서버를 연결하면 브라우저와 외부 연결 도구 묶음이 꺼질 수 있습니다. 필요하면 이 구역에서 다시 켭니다.