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

> Source: https://docs.wrks.ai/admin-help/integrations/internal-systems · Last updated: 2026-11-05

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

> 이 메뉴는 **최고 관리자**에게만 보여요.

### 목록 보는 법

목록 위 탭은 `전체` 와 카테고리 10개(협업·개발·조직·금융·법률·부동산·산업·연구·생활·도구)예요. 카테고리를 고르지 않은 도구는 `전체` 에서만 보여요.

한 목록에 두 종류가 섞여 있어요.

| 종류              | 할 수 있는 것                          |
| --------------- | --------------------------------- |
| 웍스AI가 제공하는 도구   | 켜고 끄기(`허용 여부`)와 `인증 테스트` 만 돼요. 삭제·수정은 안 돼요   |
| 우리 회사가 추가한 도구   | 켜고 끄기, `수정`, `삭제`, `인증 테스트`       |

웍스AI가 제공하는 도구에는 공공 데이터를 바로 쓸 수 있는 도구도 있어요. 예: 국회 의안정보, 고용·산재보험 사업장, 글로벌 임상시험, 논문·특허·R&D 통합검색, 식품의약품안전처 화장품 정보.

각 도구마다 이용 가이드가 함께 들어 있어요. 워크플로우 단계에서도 고르실 수 있습니다.

> 도구 목록을 찾으실 때 **단계 추가 화면의 카테고리 탭**을 쓰시면 종류별로 좁혀 보실 수 있어요.

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

**화면 오른쪽 위 `도구 추가` 를 누르면 `추가 전 주의사항` 이 먼저 뜨고, 확인하면 외부 제공 도구 추가 창이 열려요.** 연결할 시스템 정보가 준비돼 있어야 합니다.

입력하는 것 (`도구 이름` 과 `도구 링크` 는 꼭 넣어야 해요)

| 항목      | 내용                                     |
| ------- | -------------------------------------- |
| 도구 이름   | 직원에게 보일 이름                             |
| 도구 설명   | 무엇을 하는 도구인지 (예: YouTube 이해/요약)         |
| 도구 링크   | 연결할 Remote MCP 서버 주소 (`https://` 로 시작) |
| 전송 방식   | 연결 규격. `Streamable HTTP (권장)` 하나예요     |
| 카테고리 | 정해진 10개 중 하나를 골라요. 고르지 않으면(`선택 안 함`) `전체` 탭에서만 보여요 (선택사항) |
| 아이콘 업로드 | 목록에 보일 아이콘 (선택사항)                      |
| 지시 사항   | 에이전트가 이 도구를 어떻게 쓸지                     |

인증이 필요한 도구라면 **인증 방식**을 고르고 필요한 값을 넣습니다.

| 인증 방식                                       | 넣는 것                  |
| ------------------------------------------- | --------------------- |
| API Key                                     | 헤더 이름과 값              |
| OAuth                                       | 클라이언트 ID와 클라이언트 시크릿   |
| OAuth 2.0 Dynamic Client Registration (DCR) | 도구 서버가 지원하는 경우 고르는 방식 |
| 없음                                          | 인증이 필요 없는 도구          |

OAuth 방식이면 **OAuth 자격증명** 에 **클라이언트 ID** 와 **클라이언트 시크릿** 을 넣어요. 저장한 시크릿은 다시 보이지 않고, 바꿀 때만 새로 입력하면 돼요. 도구 서버(OAuth 앱)에는 `인증 방식` 아래(선택 칸 바로 위)에 보이는 `OAuth Callback URL` 을 등록해 주세요.

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

**추가로 보낼 헤더 (선택)**

도구 서버가 요청을 알아보는 데 따로 필요한 값(헤더)이 있을 때만 넣어요. 인증 방식과 상관없이 항상 보이는 칸이에요. **`추가`** 로 줄을 늘리고 이름과 값을 적습니다.

* **User-Agent** 는 웍스AI가 `wrksai-mcp-client` 로 자동으로 붙여요
* OAuth 방식에서는 로그인 정보(**Authorization**)도 웍스AI가 자동으로 붙여서, 이 칸에 넣을 수 없어요
* 웍스AI가 직접 관리하는 헤더(통신 제어용 헤더, MCP 연결용 헤더, x-wrks- 로 시작하는 헤더)는 넣을 수 없어요. 넣으면 "웍스AI가 직접 관리하는 헤더라 넣을 수 없어요. 이 줄을 지워 주세요." 와 함께 이름이 나오고 저장되지 않아요

**카테고리는 정해진 목록에서 고릅니다**

카테고리는 직접 적지 않고 **정해진 10개 중에서** 골라요.

여기서 고른 분류가 **직원 화면의 도구 탭 이름**이 되므로, 직원이 찾기 쉬운 쪽으로 골라 주세요. 추가한 뒤에는 목록의 **인증 테스트**로 언제든 다시 확인할 수 있어요. 직원에게 열어 주기 전에 눌러 보시면 연결이 안 되는 도구를 미리 걸러냅니다.

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

### 누가 쓸 수 있나요?

목록의 **누가 쓸 수 있나요?** 칸에 지금 규칙대로면 누가 그 도구를 쓸 수 있는지 한 문장으로 보여요. **칸을 누르면** 규칙을 바꿀 수 있어요.

| 보이는 문장                        | 뜻         |
| ----------------------------- | --------- |
| 규칙이 없어서 모든 구성원이 쓸 수 있어요.      | 아무 규칙도 없음 |
| ○○ 빼고 모든 구성원이 쓸 수 있어요.        | 일부만 막음    |
| ○○만 쓸 수 있고, 그 외 구성원은 쓸 수 없어요. | 일부만 허용    |
| 모든 구성원이 쓸 수 없어요.              | 전부 막음     |

규칙 만드는 방법은 메뉴 통제·AI 모델 통제와 같아요. → [쓸 수 있는 AI 모델 정하기](https://docs.wrks.ai/admin-help/features/model-control)

### 노출 순서

`전체` 탭에서 목록을 끌어 순서를 바꾸면 직원 화면에 보이는 차례가 바뀌어요. 카테고리 탭에서는 순서를 바꿀 수 없어요.

### MCP Hub

화면 위쪽에 **"우리 회사 시스템을 AI 에이전트에 연결해요"** 배너가 있어요. MCP Hub 로 **방화벽 포트를 열지 않고 사내 DB·API·문서를 에이전트가 쓰는 도구로** 만들 수 있다는 소개예요.

* 배너의 **`지금 시작하기`** 를 누르면 **MCP Hub Studio** 가 새 탭으로 열려요
* 시작 절차는 **최고관리자 계정으로 가입 신청 → 승인 → 바로 사용** 이에요. 가입 신청은 회사의 **최고관리자 계정**으로 할 수 있어요
* 배너의 닫기(X)를 누르면 지금 화면에서만 숨겨져요. **새로고침하면 다시 보여요**

> 공공기관 전용 환경에서는 MCP Hub 배너가 보이지 않아요.

***

### 자주 묻는 질문

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

네. 화면 오른쪽 위 **`도구 추가`** 를 누르고 `추가 전 주의사항` 을 확인하면 열리는 **외부 제공 도구 추가** 창에서 직접 만들 수 있어요. 연결할 주소와 인증 정보가 준비돼 있어야 합니다.

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

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

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

**지시 사항**을 확인해 주세요. 언제 이 도구를 써야 하는지 적어두지 않으면 에이전트가 판단을 못 합니다. 노출할 워크스페이스에 그 에이전트가 있는지도 봐주세요. `허용 여부` 가 켜져 있어야 에이전트 만들기 화면에 나타나요.

**Q. 연결 테스트가 실패해요.**

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

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

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

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

목록의 **누가 쓸 수 있나요?** 칸을 눌러 대상을 정하시면 됩니다.

**Q. '권한 관리' 버튼이 안 보여요.**

목록의 **누가 쓸 수 있나요?** 칸으로 바뀌었어요. 칸을 누르면 같은 규칙 화면이 열려요. 예전의 `모든 직원이 사용 중` 은 지금 "규칙이 없어서 모든 구성원이 쓸 수 있어요." 로 보여요.

**Q. "웍스AI가 직접 관리하는 헤더라 넣을 수 없어요" 라고 나와요.**

**추가로 보낼 헤더**에 웍스AI가 직접 붙이는 헤더를 넣으셨어요. 메시지 뒤 괄호에 나온 이름의 줄을 지우고 다시 저장해 주세요.

**Q. "OAuth 방식에서는 Authorization 헤더를 넣을 수 없어요" 라고 나와요.**

OAuth 방식은 로그인 정보를 웍스AI가 자동으로 붙여요. 추가 헤더의 `Authorization` 줄을 지워 주세요.

**Q. 도구 서버가 User-Agent 를 확인해요. 무엇으로 오나요?**

웍스AI가 `wrksai-mcp-client` 로 자동으로 붙여요. 다른 값이 꼭 필요하면 **추가로 보낼 헤더**에 넣어 주세요.

**Q. MCP Hub 배너를 닫았는데 또 보여요.**

닫기는 지금 화면에서만 숨겨요. 새로고침하거나 다시 들어오면 다시 보여요.

**Q. `지금 시작하기`(예전 `MCP Hub 신청`)를 눌렀더니 다른 사이트가 열려요.**

맞아요. **MCP Hub Studio** 가 새 탭으로 열려요. 예전에 있던 `MCP Hub 신청` 버튼은 없어지고 배너의 `지금 시작하기` 로 합쳐졌어요. 가입 신청은 회사의 **최고관리자 계정**으로 해 주세요.

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

네. 목록에서 그 도구의 `허용 여부` 를 끄면 `노출 중단하기` 창이 떠요. `중단하기` 를 누르면 모든 구성원이 그 도구를 쓸 수 없어요. 도구는 목록에 그대로 남고, 언제든 다시 켤 수 있어요.

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

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

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

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

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

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

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

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

목록 위 탭이 `전체` 인지 확인해 주세요. 카테고리 탭에서는 그 카테고리 도구만 보이고, 카테고리를 고르지 않은 도구는 `전체` 에서만 보여요.

**Q. `공식 도구`·`전사 도구`·`비활성 도구` 탭이 안 보여요.**

지금은 카테고리 탭으로 바뀌었어요. 꺼 둔 도구는 따로 모이지 않고 목록에 그대로 있고 `허용 여부` 가 꺼져 있어요.

**Q. 카테고리를 직접 적을 수 없나요?**

정해진 10개 중에서만 골라요. 예전에는 이름을 직접 적는 칸으로 나왔어요.

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

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

**Q. 금칙어나 개인정보 마스킹이 도구로 오가는 데이터에도 걸리나요?**

금칙어와 대화 개인정보 마스킹은 **직원이 대화창에 입력한 메시지**에 적용돼요. 도구가 돌려주는 응답에 같은 규칙이 걸린다고 안내해 드리기는 어려워요. 민감한 데이터를 다루는 도구라면 도구 서버 쪽에서도 보안 요건을 확인해 주세요.

**Q. 도구를 추가할 때 어느 워크스페이스에 보일지 고르는 칸이 없어요.**

지금 도구 추가 창에는 그 칸이 없어요. 누가 쓸 수 있는지는 추가한 뒤 **`누가 쓸 수 있나요?`** 에서 정해요.

### 이럴 땐 문의해 주세요

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