관리자 > 에이전트 도구 관리 에서 에이전트가 쓸 도구를 추가하고 관리합니다. 도구를 붙이면 에이전트가 사내 시스템을 조회하거나 실제 작업을 할 수 있어요.
이 메뉴는 최고 관리자에게만 보여요.
목록 보는 법
목록 위 탭은 전체 와 카테고리 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 모델 정하기
노출 순서
전체 탭에서 목록을 끌어 순서를 바꾸면 직원 화면에 보이는 차례가 바뀌어요. 카테고리 탭에서는 순서를 바꿀 수 없어요.
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. 도구를 추가할 때 어느 워크스페이스에 보일지 고르는 칸이 없어요.
지금 도구 추가 창에는 그 칸이 없어요. 누가 쓸 수 있는지는 추가한 뒤 누가 쓸 수 있나요? 에서 정해요.
이럴 땐 문의해 주세요
- 연결 테스트가 계속 실패할 때
- 어떤 방식으로 연결해야 할지 판단이 어려울 때
- 도구를 쓰던 중 갑자기 안 될 때