운영 중인 REST API를 AI가 호출할 수 있는 도구로 등록하고, 사내 업무 시스템이나 별도로 제작한 웹페이지를 채팅에 표시되는 위젯으로 연결할 수 있습니다. MCP 서버를 새로 개발하지 않아도 기존 API와 웹페이지를 AI로 활용할 수 있습니다.
REST API 도구
기본 설정
스페이스 설정 > MCP 서버·도구페이지에서 웹호출 도구추가하기를 클릭하고, 아래의 기본 설정값을 입력하세요.
1
Base URL
Base URL은 도구로 사용할 API의 공통 주소입니다. 각각의 API 도구를 추가할 때는 이 Base URL 뒤에 붙는 나머지 경로만 입력하면 됩니다. 예를 들어 Base URL을
https://example.com으로 설정했다면, 도구의 접속 URL에는 /api/rooms처럼 경로만 입력합니다.2
인증방식
API 접근을 위한 인증 값을 Access Token 또는 헤더 방식으로 입력할 수 있습니다.
API가 별도의 인증 없이 호출 가능한 경우에는
인증없음을 선택하세요.3
공통 쿼리
공통 쿼리는 이 웹호출 도구에 포함된 모든 API 요청에 함께 전달되는 쿼리 파라미터입니다. 예를 들어 모든 요청에
workspace_id나 locale 같은 값이 항상 필요하다면 공통 쿼리에 추가할 수 있습니다.도구 설정
도구 필드 우측의 아이콘을 클릭하고 아래의 설정값을 입력하여 도구를 추가할 수 있습니다.
1
도구 이름
AI가 구분할 수 있는 도구 이름을 입력하세요.
2
접속 URL
Base URL 뒤에 붙는 API 경로를 입력하세요.
3
메소드
도구로 사용하려는 API 메소드를 선택하세요.
4
헤더와 쿼리
필요한 경우 API 호출에 필요한 헤더와 쿼리 파라미터를 입력하세요.
5
프롬프트
AI가 언제 이 도구를 사용해야 하는지 자연어로 설명하세요. 이 내용을 기반으로 AI가 해당 도구의 호출 여부를 판단합니다.
6
파라미터
접속 URL, 쿼리, 요청 본문에서 사용할 동적 값을 정의합니다.
접근 권한 설정
웹호출 도구 설정창의 권한 탭에서 팀원별 접근 권한을 설정할 수 있습니다.
활용
채팅창에서 추가한 웹호출 도구를 활성화하면, AI로 API를 활용할 수 있습니다.
에이전트 설정 과정에서 추가한 웹호출 도구를 활성화하여 에이전트의 도구로 사용하거나, Slack 등 메신저에서 사용하도록 설정할 수 있습니다.
웹페이지 위젯 도구
위젯 설정
스페이스 설정 > 위젯페이지에서추가하기를 클릭하고 위젯 설정값을 입력하면 위젯이 추가됩니다.
| 필드 | 입력값 | 설명 |
|---|---|---|
| 도구 이름 | LLM이 호출할 도구명 | 소문자, 숫자, 하이픈, 언더스코어만 사용 가능 예: book-a-conference-room |
| 제목 | 위젯의 표시명 | 사용자가 어떤 기능인지 알 수 있는 이름을 입력 예: 회의실 예약 |
| 설명 | 위젯이 필요한 상황 | 사용자가 어떤 요청을 했을 때 위젯을 표시할지 설명 예: 사용자가 회의실 예약을 필요로 할 때 표시합니다. |
| URL | 웹서비스 주소 | iframe으로 렌더링할 웹서비스 URL을 입력 예: https://example.com |
| 인증 | 인증없음 또는 토큰 | 인증에 토큰이 필요한 경우, 토큰을 선택하고 아래의 필드에 그 값을 입력 |
| 파라미터 | JSON 또는 YAML 객체 | iframe 렌더링 시 위젯에 전달할 추가 값을 입력 |
접근 권한 설정
설정창 상단의 권한 탭에서 팀원별로 위젯에 대한 접근 권한을 설정할 수 있습니다.
채팅창에서 사용
위젯 등록 과정에서 설명 필드에 입력한 내용에 따른 요청으로 채팅창에서 위젯을 호출하여 활용할 수 있습니다.
위젯 도구는 채팅창에서 활성화하는 과정 없이 호출할 수 있습니다.