> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ale.run/llms.txt
> Use this file to discover all available pages before exploring further.

# 전역 위젯

> 위젯을 전체 또는 특정 스페이스에 공유하고 접근 범위를 관리합니다.

> [card]
>
> 자주 사용하는 사내 웹서비스를 위젯으로 미리 등록하고 전역 또는 특정 스페이스를 지정하여 접근 권한을 설정할 수 있습니다.

> [accordion] 운영 시스템 접속 방법
>
> ![](https://files.cloudtype.io/ale-docs/ai/images/ko/global-model01.webp)
>
> 대시보드 우측 상단의 프로필 아이콘을 클릭하면 운영 시스템에 접속할 수 있습니다.
>
> > [!TIP]
> >
> > [운영 시스템 관리자 권한을 부여](https://docs.ale.run/ko/enterprise/user-management.md#관리자-권한-부여)받은 사용자 계정으로만 접속 가능합니다.

## 전역 위젯 추가

![](https://files.cloudtype.io/ale-docs/ai/images/ko/global-widget01.webp)

> 운영 시스템의 MCP・도구 페이지에서 아래의 설정값을 입력하여 전역 위젯을 추가할 수 있습니다.

<table>
  <colgroup>
    <col />

    <col />

    <col />
  </colgroup>

  <thead>
    <tr>
      <th>필드</th>
      <th>입력값</th>
      <th>설명</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>도구 이름</td>
      <td>LLM이 호출할 도구명</td>
      <td>소문자, 숫자, 하이픈, 언더스코어만 사용 가능\
      예: `book-a-conference-room`</td>
    </tr>

    <tr>
      <td>제목</td>
      <td>위젯의 표시명</td>
      <td>사용자가 어떤 기능인지 알 수 있는 이름을 입력\
      예: `회의실 예약`</td>
    </tr>

    <tr>
      <td>설명</td>
      <td>위젯이 필요한 상황</td>
      <td>사용자가 어떤 요청을 했을 때 위젯을 표시할지 설명\
      예: `사용자가 회의실 예약을 필요로 할 때 표시합니다.`</td>
    </tr>

    <tr>
      <td>URL</td>
      <td>웹서비스 주소</td>
      <td>iframe으로 렌더링할 웹서비스 URL을 입력\
      예: `https://example.com`</td>
    </tr>

    <tr>
      <td>인증</td>
      <td>`인증없음` 또는 `토큰`</td>
      <td>인증에 토큰이 필요한 경우, `토큰`을 선택하고 아래의 필드에 그 값을 입력</td>
    </tr>

    <tr>
      <td>파라미터</td>
      <td>JSON 또는 YAML 객체</td>
      <td>iframe 렌더링 시 위젯에 전달할 추가 값을 입력</td>
    </tr>
  </tbody>
</table>

## 적용 범위 설정

![](https://files.cloudtype.io/ale-docs/ai/images/ko/global-widget02.webp)

> 추가한 위젯의 설정창에서 적용 범위 탭을 선택하면 `전체 적용`, `화이트리스트`, `블랙리스트` 방식으로 사용 가능한 스페이스를 선택적으로 설정할 수 있습니다.

> [!NOTE]
>
> 권한을 부여받은 스페이스에서 위젯 도구를 호출할 수 있습니다.
>
> ![](https://files.cloudtype.io/ale-docs/ai/images/ko/widget02.webp)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.