> 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가 제공. 바로 켜서 쓰면 돼요 |
| **전사 도구**  | 우리 회사가 추가한 도구         |
| **비활성 도구** | 노출을 중단해 둔 도구          |

**새로 들어온 공식 도구 (2026년 9월 16일)**

공공 데이터를 바로 쓰실 수 있는 도구가 다섯 가지 늘었어요. **바로 켜서 쓰시면 됩니다.**

* 국회 의안정보
* 고용·산재보험
* 글로벌 임상시험
* ScienceON (과학기술 정보)
* 식약처 화장품 정보

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

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

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

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

입력하는 것

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

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

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

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

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

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

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

직접 이름을 적는 방식이 아니라 **미리 정해진 분류 중에서** 고르시게 됐어요. 회사마다 다르게 적혀 서로 못 알아보던 문제를 없애기 위해서입니다.

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

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

### 누가 쓸 수 있나요?

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

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

규칙 만드는 방법은 메뉴 통제·AI 모델 통제와 같아요. → [AI 모델 통제](https://github.com/chain-partners/wrks-admin-guide/tree/gitbook-export/기능/ai-모델-통제.md)

### 노출 순서

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

### MCP Hub

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

* **`지금 시작하기`** 나 **`MCP Hub 신청`** 을 누르면 **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** 가 새 탭으로 열려요. 가입 신청은 회사의 **최고관리자 계정**으로 해 주세요.

**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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.