> For the complete documentation index, see [llms.txt](https://docs.wrks.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wrks.ai/admin-help/integrations/internal-systems.md).

# 에이전트 도구 관리 화면의 모든 것

`기업관리자 > 에이전트 도구 관리` 에서 에이전트가 쓸 도구를 추가하고 관리합니다. 도구를 붙이면 에이전트가 사내 시스템을 조회하거나 실제 작업을 할 수 있어요.

## 도구 종류

| 종류         | 설명                    |
| ---------- | --------------------- |
| **공식 도구**  | 웍스AI가 제공. 바로 켜서 쓰면 돼요 |
| **전사 도구**  | 우리 회사가 추가한 도구         |
| **비활성 도구** | 노출을 중단해 둔 도구          |

## 외부 제공 도구 추가하기

**관리자가 화면에서 직접 추가할 수 있어요.** 연결할 시스템 정보가 준비돼 있어야 합니다.

입력하는 것

| 항목         | 내용                             |
| ---------- | ------------------------------ |
| 도구 이름      | 직원에게 보일 이름                     |
| 도구 설명      | 무엇을 하는 도구인지 (예: YouTube 이해/요약) |
| 도구 링크      | 연결할 주소                         |
| 전송 방식      | 연결 규격                          |
| 카테고리 선택    | 도구를 묶어 정리                      |
| 아이콘 업로드    | 목록에 보일 아이콘 (선택사항)              |
| 지시 사항      | 에이전트가 이 도구를 어떻게 쓸지             |
| 노출할 워크스페이스 | 어느 워크스페이스에 보일지                 |

인증이 필요한 도구라면 **클라이언트 ID** 와 **클라이언트 시크릿** 을 넣습니다. 저장한 시크릿은 다시 보이지 않고, 바꿀 때만 새로 입력하면 돼요.

추가하기 전에 **연결 확인**으로 실제로 붙는지 시험해 보실 수 있습니다.

> ⚠️ **추가 전 주의사항**을 꼭 읽어주세요. 잘못 만든 도구는 보안에 매우 취약할 수 있고, 그로 인한 보안 사고의 책임은 도구를 추가한 회사에 있습니다. 검증되지 않은 외부 주소는 연결하지 마세요.

## 권한 관리

도구마다 **권한 관리**에서 누가 쓸 수 있는지 정할 수 있어요. 아무 설정이 없으면 `모든 직원이 사용 중` 으로 표시됩니다.

## 노출 순서

목록에서 순서를 바꾸면 직원 화면에 보이는 차례가 바뀝니다.

## MCP Hub 신청

**MCP Hub 신청** 을 누르면 신청 창이 열려요.

MCP Hub 로 **SAP·ERP·사내 API 같은 회사 시스템을 에이전트에 연결**할 수 있습니다. 정식 오픈 전이라 사전신청을 받고 있어요. 먼저 소개를 살펴보고 신청을 남기시면 순서대로 안내드립니다.

***

## 자주 묻는 질문

### Q. 도구를 직접 추가할 수 있나요?

네. **외부 제공 도구 추가**에서 관리자가 직접 만들 수 있어요. 연결할 주소와 인증 정보가 준비돼 있어야 합니다.

### Q. 우리 회사 시스템에 API가 없어요.

연결할 주소가 있어야 도구로 만들 수 있어요. 없으면 먼저 준비가 필요합니다. 어떻게 할지 모르시겠으면 문의해 주세요.

### Q. 추가했는데 에이전트가 도구를 안 써요.

**지시 사항**을 확인해 주세요. 언제 이 도구를 써야 하는지 적어두지 않으면 에이전트가 판단을 못 합니다. 노출할 워크스페이스에 그 에이전트가 있는지도 봐주세요.

### Q. 연결 확인이 실패해요.

도구 링크와 전송 방식이 맞는지 먼저 보세요. 인증이 필요한 도구면 클라이언트 ID·시크릿도 확인해 주세요. 회사 방화벽이 막고 있을 수도 있습니다.

### Q. 클라이언트 시크릿을 다시 보고 싶어요.

저장한 뒤에는 볼 수 없어요. 바꾸실 때만 새로 입력하시면 됩니다.

### Q. 특정 부서만 이 도구를 쓰게 할 수 있나요?

**권한 관리**에서 대상을 정하시면 됩니다.

### Q. 도구를 잠깐 꺼둘 수 있나요?

네. 노출을 중단하면 직원들이 쓸 수 없게 되고 **비활성 도구** 쪽으로 갑니다. 나중에 다시 켤 수 있어요.

### Q. 도구를 삭제하면 쓰던 사람들은 어떻게 되나요?

**삭제한 도구는 되돌릴 수 없고, 그 도구를 쓰던 모든 사용자에게 영향이 갑니다.** 붙여둔 에이전트도 그 기능을 못 쓰게 돼요.

잠깐 막으실 거면 삭제 대신 노출 중단을 쓰세요.

### Q. 도구를 쓰면 요금이 더 나오나요?

도구를 쓸 때 발생하는 사용량만큼 요금이 나갑니다. `기업관리자 > 이용 현황` 에서 확인할 수 있어요.

### Q. 직원이 개인적으로 도구를 추가할 수 있나요?

회사에서 추가한 도구와 공식 도구만 쓸 수 있어요. 관리자가 관리합니다.

### Q. 도구가 목록에서 안 보여요.

**비활성 도구** 쪽에 있는지 확인해 주세요.

### Q. 우리 데이터가 외부로 나가나요?

연결한 도구의 주소로 필요한 만큼 전달됩니다. 회사 보안 요건이 있으면 도구를 추가하기 전에 검토해 주세요.

## 이럴 땐 문의해 주세요

* 연결 확인이 계속 실패할 때
* 어떤 방식으로 연결해야 할지 판단이 어려울 때
* 도구를 쓰던 중 갑자기 안 될 때


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.wrks.ai/admin-help/integrations/internal-systems.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.