도구 연결은 AI가 외부 시스템의 기능을 호출(Function Calling)할 수 있게 해주는 기능입니다.
OpenAPI 스펙 기반 REST API 또는 MCP(Model Context Protocol) 서버를 연결하면, AI가 대화 중 적절한 시점에 자동으로 도구를 호출합니다.
도구란?
도구는 AI의 능력을 외부 시스템으로 확장하는 인터페이스입니다. AI가 학습 데이터에 없는 실시간 정보를 조회하거나, 외부 시스템에 작업을 요청할 수 있습니다.
활용 예시
연결 대상
할 수 있는 일
CRM 시스템
고객 정보 조회, 영업 기회 등록
티켓 시스템
이슈 생성, 상태 업데이트
HR 시스템
휴가 신청, 직원 정보 조회
날씨/주가 API
실시간 외부 데이터 제공
사내 데이터 API
매출, 재고 등 비즈니스 데이터 조회
지원 프로토콜
OpenAPI
REST API 표준 스펙(구 Swagger). 대부분의 웹 서비스가 제공하는 범용 프로토콜입니다.
MCP
Model Context Protocol. AI 전용 도구 서버 프로토콜로, 더 안전하고 효율적인 통합을 지원합니다.
도구 목록
워크스페이스 > 도구에서 등록된 모든 도구 연결을 확인합니다.
워크스페이스 > 도구에서 등록된 도구 연결을 관리합니다
목록에서 각 도구는 다음 정보를 표시합니다:
항목
설명
이름
도구 표시 이름
설명
도구 용도 설명
작성자
도구를 생성한 사용자
수정 시간
마지막 수정 시점 (상대 시간)
목록 상단에는 검색창이 있어 이름이나 설명으로 도구를 검색할 수 있습니다.
각 도구 카드의 메뉴(...)에서는 삭제가 가능합니다.
도구 생성
도구 생성은 두 단계로 이루어집니다: 기본 정보 입력(CreateTool) 후 상세 페이지(ToolDetail)에서 연결을 구성합니다.
1
기본 정보 입력
워크스페이스 > 도구 목록 우측 상단의 + 새 도구를 누르면 생성 폼이 열립니다.
이름과 설명을 입력하고 권한을 설정합니다.생성 폼에 다음 정보를 입력합니다.
도구 이름, 설명, 접근 권한을 설정합니다
필드 라벨
설명
예시
이 도구는 무엇을 하나요? (이름)
도구 표시 이름
”고객 관리 API”
이 도구를 어떻게 사용할 수 있나요? (설명)
도구 용도 설명
”CRM 시스템 고객 정보 조회 및 관리”
권한
공개 / 비공개. 비공개면 아래 그룹 카드에서 대상 지정
비공개 + “개발팀”
권한은 공개와 비공개로 나뉩니다. 비공개를 고르면 아래 그룹 카드가 나타나고, 추가한 그룹마다 읽기·쓰기를 지정할 수 있습니다. 사용자 개별 지정과 조직 단위 지정은 이 화면에 없습니다.
저장 및 업데이트 버튼을 클릭하면 도구가 생성되고 상세 설정 페이지로 자동 이동합니다.
2
상세 페이지에서 연결 구성
생성 후 자동으로 이동한 상세 페이지(/workspace/tools/{id})에서 실제 연결을 설정합니다.
상세 페이지의 구성은 아래 OpenAPI 도구 연결 및 MCP 도구 연결 섹션을 참고하세요.
OpenAPI 도구 연결
OpenAPI(구 Swagger) 스펙을 제공하는 REST API를 연결하는 방법입니다.
도구 상세 페이지에서 아래 설정을 진행합니다.
도구 상세 페이지에서 연결 유형, URL, 인증, 도구 설명을 설정합니다
연결 설정 필드
필드
설명
기본값
연결 유형
OpenAPI 또는 MCP 선택 드롭다운
OpenAPI
스펙 소스
URL에서 가져오기 또는 직접 입력/업로드 선택
URL에서 가져오기
API 기본 URL
OpenAPI 서버의 기본 URL
—
OpenAPI 스펙 경로
OpenAPI 스펙 파일 경로
openapi.json
인증 유형
인증 방식 선택
Bearer Token
API 키
Bearer Token 방식일 때 토큰 값
—
활성화됨
연결 활성화/비활성화 토글
활성화
Bearer Token 인증
Session 인증
API 키 필드에 Bearer 토큰 값을 입력합니다. API 호출 시 Authorization: Bearer <token> 헤더로 전송됩니다.
API 기본 URL: https://api.example.comOpenAPI 스펙 경로: openapi.json인증 유형: Bearer TokenAPI 키: sk-xxxxxxxxxxxxxxxx
현재 로그인한 사용자의 세션 인증 정보를 그대로 사용합니다. 별도의 API 키 입력이 필요 없습니다.
사내 API 서버에서 Cloosphere와 동일한 인증 체계를 사용하는 경우에 적합합니다.
연결 테스트 및 기능 확인
설정 완료 후 연결 테스트 버튼을 클릭합니다.연결 성공 시 우측 사용 가능한 함수 패널에 API 엔드포인트 목록이 자동으로 표시됩니다.
각 함수 항목에는 HTTP 메서드(GET, POST 등), 이름, 설명, 경로가 표시되며, 마우스를 올리면 파라미터 상세 정보를 확인할 수 있습니다.
연결 성공 시 사용 가능한 API 엔드포인트 목록이 자동 표시됩니다
MCP 도구 연결
MCP(Model Context Protocol)는 AI 모델과 외부 도구 간의 통신을 위한 전용 프로토콜입니다.
도구 상세 페이지에서 연결 유형을 MCP로 변경한 후 아래 설정을 진행합니다.
연결 유형을 MCP로 변경하고 서버 URL과 인증을 설정합니다
연결 설정 필드
필드
설명
기본값
연결 유형
MCP 선택
—
MCP 서버 URL
MCP 서버 주소 (SSE 엔드포인트)
—
인증 유형
인증 방식 선택 (없음 / Bearer Token / API Key / OAuth 2.0)
없음
추가 헤더 (선택사항)
추가 HTTP 헤더 입력
—
활성화됨
연결 활성화/비활성화 토글
활성화
MCP 인증 방식
None
Bearer Token
API Key
OAuth 2.0 (사용자 SSO)
인증 없이 MCP 서버에 연결합니다. 로컬 또는 내부 네트워크의 MCP 서버에 적합합니다.
Bearer 토큰을 사용한 인증입니다. 토큰 값을 입력하면 요청 시 Authorization: Bearer <token> 헤더로 전송됩니다.
API 키를 사용한 인증입니다. API 키 값을 입력하면 서버 요구사항에 따라 인증 헤더로 전송됩니다.
로그인한 사용자 본인의 SSO 토큰을 사용하는 인증입니다. 별도의 키를 입력하지 않으며, 선택한 제공자(Microsoft / Google) 에 따라 각 요청 시 해당 사용자의 OAuth 액세스 토큰이 자동으로 주입됩니다.
Google Workspace·Microsoft 365처럼 사용자별 권한이 필요한 MCP 서버에 적합합니다.
추가 헤더 설정
MCP 서버가 커스텀 헤더를 요구하는 경우 추가 헤더 필드에 입력합니다. 키: 값 형태로 한 줄에 하나씩 작성합니다.
연결 테스트 버튼을 클릭하면 MCP 서버에 연결하여 제공하는 도구 목록을 조회합니다.
연결 성공 시 우측 사용 가능한 함수 패널에 MCP 도구 목록이 표시됩니다.
도구 설명 (에이전트용 설명)
도구 상세 페이지 상단에는 도구 설명 필드가 있습니다. 이 필드는 에이전트가 어떤 상황에서 이 도구 서버를 사용해야 하는지 판단하는 데 사용됩니다.
직접 설명을 작성하거나, AI 버튼을 클릭하여 연결된 기능 목록을 기반으로 자동 생성할 수 있습니다
AI 생성 시 사용할 모델을 드롭다운에서 선택할 수 있습니다 (기본: 시스템 기본 모델)
연결 테스트 후 기능 목록이 로드된 상태에서만 AI 생성이 가능합니다
도구 설명을 잘 작성하면 에이전트가 적절한 시점에 도구를 선택하는 정확도가 높아집니다.
예: “프로젝트 이슈 관리, 메시지 전송, API 통합이 필요할 때 사용합니다.”
도구 활용
에이전트에 도구 연결
도구를 에이전트에 연결하면 AI가 대화 중 자동으로 적절한 시점에 도구를 호출합니다.
워크스페이스 > 에이전트에서 에이전트 편집 화면을 엽니다
도구 섹션에서 연결할 도구를 선택합니다
저장합니다
채팅에서 도구 호출 과정
AI가 사용자 질문을 분석하여 도구가 필요한지 판단하고, 필요한 경우 자동으로 호출합니다.
사용자: 고객 ID 12345의 정보를 조회해줘AI: [CRM API 호출 중...]고객 정보를 조회했습니다:| 항목 | 값 ||------|-----|| 이름 | 홍길동 || 이메일 | hong@example.com || 등급 | VIP || 최근 구매일 | 2024-01-15 |
도구 관리
편집
도구 목록에서 카드를 클릭하면 상세 페이지로 이동하여 연결 설정, 이름, 설명, 도구 설명 등을 수정할 수 있습니다.
상세 페이지 우측 상단의 저장 및 업데이트 버튼으로 변경 사항을 저장합니다.
삭제
도구 목록에서 카드 우측의 메뉴(...)를 클릭하고 삭제를 선택합니다.
삭제 확인 다이얼로그에서 확인하면 도구가 영구 삭제됩니다.
접근 권한 변경
상세 페이지 우측 상단의 접근 버튼을 클릭하여 접근 권한을 변경할 수 있습니다.
접근 권한을 전체 사용자 또는 지정된 그룹만으로 고르고, 그룹마다 편집 가능 여부를 지정할 수 있습니다.
보안 고려사항
보안 기능
설명
암호화 통신
모든 API 호출은 TLS로 암호화
자격 증명 저장
API 키는 데이터베이스에 JSON 형태로 저장됩니다
접근 제어
읽기/쓰기 권한별 도구 사용 제한
API 키는 평문으로 저장되므로 정기적으로 순환(rotate)하세요.
사설 네트워크 내 API만 연결하고, 필요시 IP 화이트리스트 또는 VPN/Private Endpoint를 활용하세요.
데이터베이스 접근 권한을 적절히 제한하여 자격 증명을 보호하세요.
트러블슈팅
연결 실패
원인
해결 방법
URL 오류
API 기본 URL 및 OpenAPI 스펙 경로를 재확인합니다
인증 실패
API 키/토큰 유효성을 확인합니다
네트워크
방화벽/프록시 설정을 확인합니다
CORS
서버 측 CORS 설정을 확인합니다
API 호출 실패
원인
해결 방법
권한 부족
API 권한(scope)을 확인합니다
Rate Limit
호출 빈도를 조절합니다
서버 오류
외부 서비스 상태를 확인합니다
MCP 서버 연결 실패
원인
해결 방법
URL 형식
SSE 엔드포인트 URL 형식을 확인합니다 (예: https://mcp.example.com/sse)
인증 방식 불일치
서버가 요구하는 인증 방식(없음/Bearer Token/API Key)과 설정이 일치하는지 확인합니다
연결 비활성화
활성화됨 토글이 활성화 상태인지 확인합니다
FAQ
어떤 API든 연결할 수 있나요?
OpenAPI(Swagger) 스펙을 제공하는 API는 모두 연결 가능합니다.
스펙이 없는 경우 MCP 서버를 직접 구축하거나, OpenAPI 스펙을 별도로 작성해야 합니다.
API 호출 비용이 발생하나요?
외부 API 사용 시 해당 서비스의 과금 정책이 적용됩니다.
Cloosphere 자체에서는 도구 호출에 대한 추가 비용이 없습니다.
민감한 데이터도 안전한가요?
모든 통신은 TLS로 암호화되며, 접근 권한을 세밀하게 설정하여 사용을 제한할 수 있습니다.
가드레일을 함께 사용하면 민감 정보 유출을 추가로 방지할 수 있습니다.
OpenAPI와 MCP 중 어떤 것을 사용해야 하나요?
기존에 OpenAPI 스펙을 제공하는 REST API가 있다면 OpenAPI를 선택하세요.
AI 전용 도구 서버를 새로 구축하거나, MCP 호환 서버를 이미 보유하고 있다면 MCP를 선택하세요.
다음 단계
에이전트에 도구 연결
도구를 에이전트에 연결하여 AI 능력을 확장
추적
도구 호출 과정을 단계별 추적
이 페이지가 도움이 되었나요?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cloosphere Guide","colors":{"primary":"#5f22d0","light":"#7c3aed","dark":"#4c1d95"},"logo":{"light":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","dark":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","href":"/ko/index"},"favicon":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/favicon.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=0e41ff0755aa623d52e26f279f285f71","appearance":{"default":"system","strict":false},"interaction":{"drilldown":true},"styling":{"latex":false},"navigation":{"languages":[{"language":"ko","default":true,"href":"ko"},{"language":"en","href":"en"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cloocus","hasAudioNarration":false,"actualSubdomain":"cloocus","customDomains":["docs.cloosphere.ai"],"gitSource":{"type":"github","owner":"ais-cloocus","repo":"cloosphere-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6a954066df6b735599399868","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"en","tag":"Admin","count":30},{"language":"ko","tag":"관리자","count":30},{"language":"en","tag":"Settings","count":24},{"language":"ko","tag":"설정","count":24},{"language":"en","tag":"Monitoring","count":21},{"language":"ko","tag":"모니터링","count":21},{"language":"en","tag":"Workspace","count":16},{"language":"ko","tag":"워크스페이스","count":16},{"language":"en","tag":"Chat","count":11},{"language":"ko","tag":"채팅","count":11},{"language":"en","tag":"Getting Started","count":10},{"language":"ko","tag":"시작하기","count":10},{"language":"en","tag":"Collaboration","count":8},{"language":"ko","tag":"협업","count":8},{"language":"en","tag":"Data \u0026 Operations","count":6},{"language":"ko","tag":"운영 · 지원","count":6},{"language":"ko","tag":"데이터 및 운영 보안","count":6},{"language":"en","tag":"AI Features \u0026 Safety","count":5},{"language":"en","tag":"UI \u0026 Channels","count":5},{"language":"ko","tag":"AI 기능 및 안전","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--brand-primary: #5f22d0;--brand-light: #7c3aed;--brand-dark: #4c1d95;--brand-subtle: #ede9fe;--brand-glow: rgba(95, 34, 208, 0.15);--page-text: #0f172a;--page-muted: #6b7280}body{font-family:\"DM Sans\", sans-serif;color:var(--page-text);font-size:17px}.prose h1,.prose h2,.prose h3,.prose h4{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;letter-spacing:-0.015em}.prose h1{font-size:44px}.prose h2{font-size:28px;margin-top:36px;margin-bottom:10px}.prose h3{font-size:22px;margin-top:28px;margin-bottom:8px}.prose p,.prose li{color:var(--page-text);line-height:1.75;font-size:1rem}.prose hr{border:0;height:1px;background:linear-gradient(90deg, rgba(148, 163, 184, 0.4), rgba(148, 163, 184, 0.05));margin:28px 0}.dark body{color:#e2e8f0}.dark .prose p,.dark .prose li{color:#e2e8f0}.dark .prose hr{background:linear-gradient(90deg, rgba(148, 163, 184, 0.3), rgba(148, 163, 184, 0.05))}[class*=\"Card\"] svg,.card svg,a[href] svg{color:var(--brand-primary)!important}.card [data-component-part=\"card-icon\"]{margin-bottom:8px}.card [data-component-part=\"card-title\"]{margin-top:12px!important}[class*=\"Card\"],.card{border-radius:16px!important;border-color:rgba(148, 163, 184, 0.25)!important;transition:border-color 0.2s ease, box-shadow 0.2s ease, transform 0.2s ease}[class*=\"Card\"]:hover,.card:hover{transform:translateY(-2px);border-color:var(--brand-light)!important;box-shadow:0 4px 20px var(--brand-glow)!important}a:not([class*=\"Card\"]):hover{color:var(--brand-primary)!important}.stable-scrollbar-gutter.overflow-auto{width:220px!important;min-width:220px!important}.stable-scrollbar-gutter.overflow-auto+div,.stable-scrollbar-gutter.overflow-auto~main{flex:1!important}.flex.flex-row-reverse.gap-12{gap:32px!important}.xl\\:flex.self-start.sticky{max-width:15rem!important}.xl\\:flex.box-border.max-h-full.pl-10{width:14rem!important;padding-left:24px!important}.text-sm.leading-6.w-\\[16\\.5rem\\]{width:100%!important;font-size:13px!important;line-height:1.6!important}#table-of-contents-content a{padding:5px 0!important;display:block}#table-of-contents-content,#table-of-contents-content ul{list-style:none!important;padding-left:0!important;margin-left:0!important}#table-of-contents-content li::marker{content:\"\"!important}#table-of-contents-content>li{border-left:2px solid rgba(148, 163, 184, 0.1);padding-left:12px;transition:border-color 0.15s ease}.dark #table-of-contents-content>li{border-left-color:rgba(148, 163, 184, 0.08)}#table-of-contents-content a{color:var(--page-muted)!important;font-weight:400!important;transition:color 0.15s ease}.dark #table-of-contents-content a{color:#94a3b8!important}#table-of-contents-content>li>a{color:var(--page-text)!important;font-weight:500!important}.dark #table-of-contents-content>li>a{color:#e2e8f0!important}#table-of-contents-content>li>ul{padding-left:12px!important}#table-of-contents-content a:hover{color:var(--brand-dark)!important}.dark #table-of-contents-content a:hover{color:#e2e8f0!important}#table-of-contents-content a.text-primary,#table-of-contents-content a.font-semibold,#table-of-contents-content>li.is-active-item>a{color:var(--brand-primary)!important;font-weight:600!important}.dark #table-of-contents-content a.text-primary,.dark #table-of-contents-content a.font-semibold,.dark #table-of-contents-content a[class*=\"dark:text-primary\"],.dark #table-of-contents-content>li.is-active-item>a{color:var(--brand-light)!important;font-weight:600!important}#table-of-contents-content>li.is-active-item{border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li.is-active-item{border-left-color:var(--brand-light)!important}#table-of-contents-content>li:has(>a.border-primary),#table-of-contents-content>li:has(>a.text-primary){border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li:has(>a.border-primary),.dark #table-of-contents-content>li:has(>a.text-primary),.dark #table-of-contents-content>li:has(>a[class*=\"dark:text-primary\"]),.dark #table-of-contents-content>li:has(>a[class*=\"dark:border-primary\"]){border-left-color:var(--brand-light)!important}.landing-hero{text-align:center;padding:72px 32px 24px;max-width:860px;margin:0 auto}.landing-hero h1{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:52px;font-weight:700;letter-spacing:-0.03em;margin:0 0 20px;background:linear-gradient(135deg, var(--brand-dark), var(--brand-primary), var(--brand-light));-webkit-background-clip:text;-webkit-text-fill-color:transparent;background-clip:text}.dark .landing-hero h1{background:linear-gradient(135deg, var(--brand-light), #a78bfa, #c4b5fd);-webkit-background-clip:text;background-clip:text}.landing-hero p{font-size:19px;line-height:1.7;color:var(--page-muted);margin:0}.dark .landing-hero p{color:#94a3b8}.landing-section{max-width:1280px;margin:0 auto;padding:0 40px 56px}.landing-section h2{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:26px;font-weight:600;letter-spacing:-0.015em;margin:0 0 6px;color:var(--page-text)}.dark .landing-section h2{color:#e2e8f0}.landing-section>p{color:var(--page-muted);font-size:16px;margin:0 0 24px}.dark .landing-section>p{color:#94a3b8}.landing-cta{max-width:1280px;margin:0 auto;padding:0 40px 48px}.landing-divider{max-width:1280px;margin:0 auto 48px;padding:0 40px}.landing-divider hr{border:0;height:1px;background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.3), transparent);margin:0}.dark .landing-divider hr{background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.15), transparent)}.landing-section [role=\"tablist\"]{margin-bottom:12px}.landing-section [role=\"tabpanel\"]>p:first-child{color:var(--page-muted);font-size:15px;margin-bottom:20px}.dark .landing-section [role=\"tabpanel\"]>p:first-child{color:#94a3b8}.group:has(>.mermaid){background:linear-gradient(135deg, #faf8ff 0%, #f3f0ff 100%);border:1px solid rgba(95, 34, 208, 0.08);border-radius:12px;padding:28px 24px;margin:24px 0}.dark .group:has(>.mermaid){background:linear-gradient(135deg, rgba(95, 34, 208, 0.06) 0%, rgba(95, 34, 208, 0.03) 100%);border-color:rgba(124, 58, 237, 0.12)}.mermaid svg .node rect,.mermaid svg .node circle,.mermaid svg .node ellipse,.mermaid svg .node polygon,.mermaid svg .node path{fill:#ede9fe!important;stroke:#7c3aed!important;stroke-width:1.5px!important;rx:8px}.dark .mermaid svg .node rect,.dark .mermaid svg .node circle,.dark .mermaid svg .node ellipse,.dark .mermaid svg .node polygon,.dark .mermaid svg .node path{fill:rgba(124, 58, 237, 0.15)!important;stroke:#a78bfa!important}.mermaid svg .node.rhombus rect,.mermaid svg .node polygon[points]{fill:#ddd6fe!important;stroke:#6d28d9!important}.dark .mermaid svg .node.rhombus rect,.dark .mermaid svg .node polygon[points]{fill:rgba(109, 40, 217, 0.2)!important;stroke:#a78bfa!important}.mermaid svg .cluster rect{fill:rgba(237, 233, 254, 0.4)!important;stroke:rgba(124, 58, 237, 0.25)!important;stroke-width:1.5px!important;rx:10px!important}.dark .mermaid svg .cluster rect{fill:rgba(124, 58, 237, 0.08)!important;stroke:rgba(167, 139, 250, 0.2)!important}.mermaid svg .cluster-label .nodeLabel,.mermaid svg .cluster span{fill:var(--brand-dark)!important;color:var(--brand-dark)!important;font-weight:600!important}.dark .mermaid svg .cluster-label .nodeLabel,.dark .mermaid svg .cluster span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg .edgePath path.path{stroke:#8b5cf6!important;stroke-width:1.5px!important}.dark .mermaid svg .edgePath path.path{stroke:#a78bfa!important}.mermaid svg .marker{fill:#8b5cf6!important;stroke:#8b5cf6!important}.dark .mermaid svg .marker{fill:#a78bfa!important;stroke:#a78bfa!important}.mermaid svg .label,.mermaid svg .nodeLabel,.mermaid svg .label text,.mermaid svg span{fill:#1e1b4b!important;color:#1e1b4b!important;font-family:\"DM Sans\", sans-serif!important}.dark .mermaid svg .label,.dark .mermaid svg .nodeLabel,.dark .mermaid svg .label text,.dark .mermaid svg span{fill:#e2e8f0!important;color:#e2e8f0!important}.mermaid svg .edgeLabel{background-color:#faf8ff!important}.dark .mermaid svg .edgeLabel{background-color:transparent!important}.mermaid svg .edgeLabel span{fill:#6d28d9!important;color:#6d28d9!important;font-size:13px!important}.dark .mermaid svg .edgeLabel span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg{background:transparent!important}#localization-select-trigger>div:first-child{display:none!important}[data-relocated-lang]{gap:0!important}::selection{background:var(--brand-subtle);color:var(--brand-dark)}.dark ::selection{background:var(--brand-dark);color:#ffffff}*:focus-visible{outline-color:var(--brand-primary)!important}::-webkit-scrollbar-thumb{background:var(--brand-light);border-radius:4px}::-webkit-scrollbar-thumb:hover{background:var(--brand-primary)}.cloo-badge{display:inline-block;font-family:\"DM Sans\", sans-serif;font-size:12px;font-weight:600;line-height:1.5;padding:0 8px;border-radius:6px;letter-spacing:-0.01em;vertical-align:middle;white-space:nowrap;margin-right:2px}.cloo-badge--required{background:#fef2f2;color:#b91c1c}.cloo-badge--multiworker{background:#fff7ed;color:#c2410c}.cloo-badge--recommended{background:#eff6ff;color:#1d4ed8}.cloo-badge--optional{background:#f1f5f9;color:#475569}.dark .cloo-badge--required{background:rgba(185, 28, 28, 0.2);color:#fca5a5}.dark .cloo-badge--multiworker{background:rgba(194, 65, 12, 0.2);color:#fdba74}.dark .cloo-badge--recommended{background:rgba(29, 78, 216, 0.22);color:#93c5fd}.dark .cloo-badge--optional{background:rgba(71, 85, 105, 0.28);color:#cbd5e1}"}]}
{"page":{"pagePath":"ko/workspace/tools","slug":"/ko/workspace/tools","pageMetadata":{"title":"도구","description":"외부 API 및 MCP 서버를 AI에 연결하여 실시간 데이터 조회와 작업 자동화","href":"/ko/workspace/tools"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"외부 API 및 MCP 서버를 AI에 연결하여 실시간 데이터 조회와 작업 자동화\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,CodeBlock,Columns,Frame,Heading,Mermaid,Note,OptimizedImage,Step,Steps,Tab,Table,Tabs,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`도구 연결은 AI가 외부 시스템의 기능을 호출(Function Calling)할 수 있게 해주는 기능입니다.\nOpenAPI 스펙 기반 REST API 또는 MCP(Model Context Protocol) 서버를 연결하면, AI가 대화 중 적절한 시점에 자동으로 도구를 호출합니다.`}),`\n`,_jsx(Mermaid,{chart:`flowchart LR\n A[사용자 질문] --> B[AI 분석]\n B --> C{도구 필요?}\n C -->|No| D[직접 응답]\n C -->|Yes| E[파라미터 추출]\n E --> F[API 호출]\n F --> G[결과 반환]\n G --> H[AI 해석]\n H --> I[자연어 응답]`}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`도구란`,children:`도구란?`}),`\n`,_jsx(_components.p,{children:`도구는 AI의 능력을 외부 시스템으로 확장하는 인터페이스입니다. AI가 학습 데이터에 없는 실시간 정보를 조회하거나, 외부 시스템에 작업을 요청할 수 있습니다.`}),`\n`,_jsx(Heading,{level:`3`,id:`활용-예시`,children:`활용 예시`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`연결 대상`}),_jsx(_components.th,{children:`할 수 있는 일`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`CRM 시스템`})}),_jsx(_components.td,{children:`고객 정보 조회, 영업 기회 등록`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`티켓 시스템`})}),_jsx(_components.td,{children:`이슈 생성, 상태 업데이트`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`HR 시스템`})}),_jsx(_components.td,{children:`휴가 신청, 직원 정보 조회`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`날씨/주가 API`})}),_jsx(_components.td,{children:`실시간 외부 데이터 제공`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`사내 데이터 API`})}),_jsx(_components.td,{children:`매출, 재고 등 비즈니스 데이터 조회`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`지원-프로토콜`,children:`지원 프로토콜`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`OpenAPI`,icon:`plug`,children:_jsx(_components.p,{children:`REST API 표준 스펙(구 Swagger). 대부분의 웹 서비스가 제공하는 범용 프로토콜입니다.`})}),_jsx(Card,{title:`MCP`,icon:`link`,children:_jsx(_components.p,{children:`Model Context Protocol. AI 전용 도구 서버 프로토콜로, 더 안전하고 효율적인 통합을 지원합니다.`})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`도구-목록`,children:`도구 목록`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`워크스페이스 > 도구`}),`에서 등록된 모든 도구 연결을 확인합니다.`]}),`\n`,_jsx(Frame,{caption:`워크스페이스 > 도구에서 등록된 도구 연결을 관리합니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-list.png?fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=e62b92e4b7118ca29f2dbffd41b3ecdf`,alt:`도구 목록`,\"data-og-width\":`2000`,width:`2000`,\"data-og-height\":`947`,height:`947`,\"data-path\":`images/workspace/tools-list.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-list.png?w=280\u0026fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=6cae40c5aa64e488ec82a199428a0c7c 280w, https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-list.png?w=560\u0026fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=6cb1704d70da8d781e49113b099b3303 560w, https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-list.png?w=840\u0026fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=f9f076f0deb1cdc5f2d83c6a39817c40 840w, https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-list.png?w=1100\u0026fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=b1ce01d2ff60121f2fc7b048e4b5c81b 1100w, https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-list.png?w=1650\u0026fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=e3397e86a28d7fbea429818d9f28bc3c 1650w, https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-list.png?w=2500\u0026fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=7bc42bcd844ee2dcb0177958c7931230 2500w`})}),`\n`,_jsx(_components.p,{children:`목록에서 각 도구는 다음 정보를 표시합니다:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`항목`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`이름`})}),_jsx(_components.td,{children:`도구 표시 이름`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`설명`})}),_jsx(_components.td,{children:`도구 용도 설명`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`작성자`})}),_jsx(_components.td,{children:`도구를 생성한 사용자`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`수정 시간`})}),_jsx(_components.td,{children:`마지막 수정 시점 (상대 시간)`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`목록 상단에는 검색창이 있어 이름이나 설명으로 도구를 검색할 수 있습니다.\n각 도구 카드의 메뉴(`,_jsx(_components.code,{children:`...`}),`)에서는 `,_jsx(_components.strong,{children:`삭제`}),`가 가능합니다.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`도구-생성`,children:`도구 생성`}),`\n`,_jsx(_components.p,{children:`도구 생성은 두 단계로 이루어집니다: 기본 정보 입력(CreateTool) 후 상세 페이지(ToolDetail)에서 연결을 구성합니다.`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`기본 정보 입력`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`워크스페이스 > 도구`}),` 목록 우측 상단의 `,_jsx(_components.strong,{children:`+ 새 도구`}),`를 누르면 생성 폼이 열립니다.\n이름과 설명을 입력하고 권한을 설정합니다.`]}),_jsx(_components.p,{children:`생성 폼에 다음 정보를 입력합니다.`}),_jsx(Frame,{caption:`도구 이름, 설명, 접근 권한을 설정합니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/tools-create.png?fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=71226f5dbbd8bcc556d70c1d92e5a32f`,alt:`도구 생성 폼`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/workspace/tools-create.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/tools-create.png?w=280\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=16bf1871a775f390dfac4dbc10b0aa68 280w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/tools-create.png?w=560\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=d347a18ecc87f6ad9ebaed767b412597 560w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/tools-create.png?w=840\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=bbc8ac2573d6b3e9628e66e93d5c3564 840w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/tools-create.png?w=1100\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=b772c5e39eac74af402bcda065851307 1100w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/tools-create.png?w=1650\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=780ea8ed62c2bebfbce2e2d260d5fd47 1650w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/workspace/tools-create.png?w=2500\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=0fd8a7d4f7844137ad4de4f83988e2b0 2500w`})}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`필드 라벨`}),_jsx(_components.th,{children:`설명`}),_jsx(_components.th,{children:`예시`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`이 도구는 무엇을 하나요?`}),` (이름)`]}),_jsx(_components.td,{children:`도구 표시 이름`}),_jsx(_components.td,{children:`”고객 관리 API”`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`이 도구를 어떻게 사용할 수 있나요?`}),` (설명)`]}),_jsx(_components.td,{children:`도구 용도 설명`}),_jsx(_components.td,{children:`”CRM 시스템 고객 정보 조회 및 관리”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`권한`})}),_jsxs(_components.td,{children:[`공개 / 비공개. 비공개면 아래 `,_jsx(_components.strong,{children:`그룹`}),` 카드에서 대상 지정`]}),_jsx(_components.td,{children:`비공개 + “개발팀”`})]})]})]}),_jsxs(Note,{children:[`권한은 `,_jsx(_components.strong,{children:`공개`}),`와 `,_jsx(_components.strong,{children:`비공개`}),`로 나뉩니다. 비공개를 고르면 아래 `,_jsx(_components.strong,{children:`그룹`}),` 카드가 나타나고, 추가한 그룹마다 `,_jsx(_components.strong,{children:`읽기·쓰기`}),`를 지정할 수 있습니다. 사용자 개별 지정과 조직 단위 지정은 이 화면에 없습니다.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`저장 및 업데이트`}),` 버튼을 클릭하면 도구가 생성되고 상세 설정 페이지로 자동 이동합니다.`]})]}),_jsx(Step,{title:`상세 페이지에서 연결 구성`,children:_jsxs(_components.p,{children:[`생성 후 자동으로 이동한 상세 페이지(`,_jsx(_components.code,{children:`/workspace/tools/{id}`}),`)에서 실제 연결을 설정합니다.\n상세 페이지의 구성은 아래 `,_jsx(_components.a,{href:`#openapi-%EB%8F%84%EA%B5%AC-%EC%97%B0%EA%B2%B0`,children:`OpenAPI 도구 연결`}),` 및 `,_jsx(_components.a,{href:`#mcp-%EB%8F%84%EA%B5%AC-%EC%97%B0%EA%B2%B0`,children:`MCP 도구 연결`}),` 섹션을 참고하세요.`]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`openapi-도구-연결`,children:`OpenAPI 도구 연결`}),`\n`,_jsx(_components.p,{children:`OpenAPI(구 Swagger) 스펙을 제공하는 REST API를 연결하는 방법입니다.\n도구 상세 페이지에서 아래 설정을 진행합니다.`}),`\n`,_jsx(Frame,{caption:`도구 상세 페이지에서 연결 유형, URL, 인증, 도구 설명을 설정합니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-detail.png?fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=55419f964425b119485d222ee86e27fb`,alt:`도구 상세 페이지`,\"data-og-width\":`1914`,width:`1914`,\"data-og-height\":`907`,height:`907`,\"data-path\":`images/workspace/tools-detail.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-detail.png?w=280\u0026fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=43c9dd517827e62658f640cf07e9af5e 280w, https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-detail.png?w=560\u0026fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=de252c8d8cc131649cc1919c4b8a7c00 560w, https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-detail.png?w=840\u0026fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=24d014e28b76f751b7a9e7e3302cdcd6 840w, https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-detail.png?w=1100\u0026fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=8c7ade6569a0583c21dfd21b97b2bc44 1100w, https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-detail.png?w=1650\u0026fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=3a389d04cb3e9be7831c011669c86944 1650w, https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-detail.png?w=2500\u0026fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=d83c7a49fd95e419a734c04d8bc4e1af 2500w`})}),`\n`,_jsx(Heading,{level:`3`,id:`연결-설정-필드`,children:`연결 설정 필드`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`필드`}),_jsx(_components.th,{children:`설명`}),_jsx(_components.th,{children:`기본값`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`연결 유형`})}),_jsx(_components.td,{children:`OpenAPI 또는 MCP 선택 드롭다운`}),_jsx(_components.td,{children:`OpenAPI`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`스펙 소스`})}),_jsx(_components.td,{children:`URL에서 가져오기 또는 직접 입력/업로드 선택`}),_jsx(_components.td,{children:`URL에서 가져오기`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`API 기본 URL`})}),_jsx(_components.td,{children:`OpenAPI 서버의 기본 URL`}),_jsx(_components.td,{children:`—`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`OpenAPI 스펙 경로`})}),_jsx(_components.td,{children:`OpenAPI 스펙 파일 경로`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`openapi.json`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`인증 유형`})}),_jsx(_components.td,{children:`인증 방식 선택`}),_jsx(_components.td,{children:`Bearer Token`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`API 키`})}),_jsx(_components.td,{children:`Bearer Token 방식일 때 토큰 값`}),_jsx(_components.td,{children:`—`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`활성화됨`})}),_jsx(_components.td,{children:`연결 활성화/비활성화 토글`}),_jsx(_components.td,{children:`활성화`})]})]})]}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`Bearer Token 인증`,id:`bearer-token-%EC%9D%B8%EC%A6%9D`,children:[_jsxs(_components.p,{children:[`API 키 필드에 Bearer 토큰 값을 입력합니다. API 호출 시 `,_jsx(_components.code,{children:`Authorization: Bearer \u003ctoken>`}),` 헤더로 전송됩니다.`]}),_jsx(CodeBlock,{numberOfLines:`5`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`API 기본 URL: https://api.example.com`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`OpenAPI 스펙 경로: openapi.json`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`인증 유형: Bearer Token`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`API 키: sk-xxxxxxxxxxxxxxxx`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsx(Tab,{title:`Session 인증`,id:`session-%EC%9D%B8%EC%A6%9D`,children:_jsx(_components.p,{children:`현재 로그인한 사용자의 세션 인증 정보를 그대로 사용합니다. 별도의 API 키 입력이 필요 없습니다.\n사내 API 서버에서 Cloosphere와 동일한 인증 체계를 사용하는 경우에 적합합니다.`})})]}),`\n`,_jsx(Heading,{level:`3`,id:`연결-테스트-및-기능-확인`,children:`연결 테스트 및 기능 확인`}),`\n`,_jsxs(_components.p,{children:[`설정 완료 후 `,_jsx(_components.strong,{children:`연결 테스트`}),` 버튼을 클릭합니다.`]}),`\n`,_jsxs(_components.p,{children:[`연결 성공 시 우측 `,_jsx(_components.strong,{children:`사용 가능한 함수`}),` 패널에 API 엔드포인트 목록이 자동으로 표시됩니다.\n각 함수 항목에는 HTTP 메서드(GET, POST 등), 이름, 설명, 경로가 표시되며, 마우스를 올리면 파라미터 상세 정보를 확인할 수 있습니다.`]}),`\n`,_jsx(Frame,{caption:`연결 성공 시 사용 가능한 API 엔드포인트 목록이 자동 표시됩니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-functions.png?fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=382fc20ce4d0b1839096b04810f586e8`,alt:`사용 가능한 함수 패널`,\"data-og-width\":`1912`,width:`1912`,\"data-og-height\":`906`,height:`906`,\"data-path\":`images/workspace/tools-functions.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-functions.png?w=280\u0026fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=cffcefe0c1224e798b027e43419a45f5 280w, https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-functions.png?w=560\u0026fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=97512e8d06cca4510214801ac5e3f022 560w, https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-functions.png?w=840\u0026fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=b3b5e70186f2e8233d3bcbbe20e39075 840w, https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-functions.png?w=1100\u0026fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=85619c380dff93ebb3e4d5327b9f3638 1100w, https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-functions.png?w=1650\u0026fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=8cee61bc78b5880a1dba2b429eb2000f 1650w, https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-functions.png?w=2500\u0026fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=d58d7124da868deb8f3b9852bb5e856d 2500w`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`mcp-도구-연결`,children:`MCP 도구 연결`}),`\n`,_jsxs(_components.p,{children:[`MCP(Model Context Protocol)는 AI 모델과 외부 도구 간의 통신을 위한 전용 프로토콜입니다.\n도구 상세 페이지에서 `,_jsx(_components.strong,{children:`연결 유형`}),`을 `,_jsx(_components.strong,{children:`MCP`}),`로 변경한 후 아래 설정을 진행합니다.`]}),`\n`,_jsx(Frame,{caption:`연결 유형을 MCP로 변경하고 서버 URL과 인증을 설정합니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-mcp-config.png?fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=96285d47cfd23ac97f240be2bfdb8f9e`,alt:`MCP 연결 설정`,\"data-og-width\":`1911`,width:`1911`,\"data-og-height\":`907`,height:`907`,\"data-path\":`images/workspace/tools-mcp-config.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-mcp-config.png?w=280\u0026fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=1c82545f0362f6367eb3089ed74b6cab 280w, https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-mcp-config.png?w=560\u0026fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=96254d1112eddc154f1237e31e6ed53a 560w, https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-mcp-config.png?w=840\u0026fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=8b5ec2d38505797679bda46834530643 840w, https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-mcp-config.png?w=1100\u0026fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=f754359fe3643f1c736c3d22ca1134bf 1100w, https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-mcp-config.png?w=1650\u0026fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=3458238d395b562e944826e2bb943f91 1650w, https://mintcdn.com/cloocus/NKTn2BIqecyNib8M/images/workspace/tools-mcp-config.png?w=2500\u0026fit=max\u0026auto=format\u0026n=NKTn2BIqecyNib8M\u0026q=85\u0026s=c40f4e4e3a525e31a710a1788cfe30f2 2500w`})}),`\n`,_jsx(Heading,{level:`3`,id:`연결-설정-필드-2`,children:`연결 설정 필드`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`필드`}),_jsx(_components.th,{children:`설명`}),_jsx(_components.th,{children:`기본값`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`연결 유형`})}),_jsx(_components.td,{children:`MCP 선택`}),_jsx(_components.td,{children:`—`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`MCP 서버 URL`})}),_jsx(_components.td,{children:`MCP 서버 주소 (SSE 엔드포인트)`}),_jsx(_components.td,{children:`—`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`인증 유형`})}),_jsx(_components.td,{children:`인증 방식 선택 (없음 / Bearer Token / API Key / OAuth 2.0)`}),_jsx(_components.td,{children:`없음`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`추가 헤더 (선택사항)`})}),_jsx(_components.td,{children:`추가 HTTP 헤더 입력`}),_jsx(_components.td,{children:`—`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`활성화됨`})}),_jsx(_components.td,{children:`연결 활성화/비활성화 토글`}),_jsx(_components.td,{children:`활성화`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`mcp-인증-방식`,children:`MCP 인증 방식`}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`None`,id:`none`,children:_jsx(_components.p,{children:`인증 없이 MCP 서버에 연결합니다. 로컬 또는 내부 네트워크의 MCP 서버에 적합합니다.`})}),_jsx(Tab,{title:`Bearer Token`,id:`bearer-token`,children:_jsxs(_components.p,{children:[`Bearer 토큰을 사용한 인증입니다. 토큰 값을 입력하면 요청 시 `,_jsx(_components.code,{children:`Authorization: Bearer \u003ctoken>`}),` 헤더로 전송됩니다.`]})}),_jsx(Tab,{title:`API Key`,id:`api-key`,children:_jsx(_components.p,{children:`API 키를 사용한 인증입니다. API 키 값을 입력하면 서버 요구사항에 따라 인증 헤더로 전송됩니다.`})}),_jsx(Tab,{title:`OAuth 2.0 (사용자 SSO)`,id:`oauth-2-0-%EC%82%AC%EC%9A%A9%EC%9E%90-sso`,children:_jsxs(_components.p,{children:[`로그인한 사용자 본인의 SSO 토큰을 사용하는 인증입니다. 별도의 키를 입력하지 않으며, 선택한 `,_jsx(_components.strong,{children:`제공자(Microsoft / Google)`}),` 에 따라 각 요청 시 해당 사용자의 OAuth 액세스 토큰이 자동으로 주입됩니다.\nGoogle Workspace·Microsoft 365처럼 사용자별 권한이 필요한 MCP 서버에 적합합니다.`]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`추가-헤더-설정`,children:`추가 헤더 설정`}),`\n`,_jsxs(_components.p,{children:[`MCP 서버가 커스텀 헤더를 요구하는 경우 `,_jsx(_components.strong,{children:`추가 헤더`}),` 필드에 입력합니다. `,_jsx(_components.code,{children:`키: 값`}),` 형태로 한 줄에 하나씩 작성합니다.`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`3`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`X-Custom-Header: value`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`X-Another-Header: another-value`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`3`,id:`연결-테스트`,children:`연결 테스트`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`연결 테스트`}),` 버튼을 클릭하면 MCP 서버에 연결하여 제공하는 도구 목록을 조회합니다.\n연결 성공 시 우측 `,_jsx(_components.strong,{children:`사용 가능한 함수`}),` 패널에 MCP 도구 목록이 표시됩니다.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`도구-설명-에이전트용-설명`,children:`도구 설명 (에이전트용 설명)`}),`\n`,_jsxs(_components.p,{children:[`도구 상세 페이지 상단에는 `,_jsx(_components.strong,{children:`도구 설명`}),` 필드가 있습니다. 이 필드는 에이전트가 어떤 상황에서 이 도구 서버를 사용해야 하는지 판단하는 데 사용됩니다.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`직접 설명을 작성하거나, `,_jsx(_components.strong,{children:`AI`}),` 버튼을 클릭하여 연결된 기능 목록을 기반으로 자동 생성할 수 있습니다`]}),`\n`,_jsx(_components.li,{children:`AI 생성 시 사용할 모델을 드롭다운에서 선택할 수 있습니다 (기본: 시스템 기본 모델)`}),`\n`,_jsx(_components.li,{children:`연결 테스트 후 기능 목록이 로드된 상태에서만 AI 생성이 가능합니다`}),`\n`]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`도구 설명을 잘 작성하면 에이전트가 적절한 시점에 도구를 선택하는 정확도가 높아집니다.\n예: “프로젝트 이슈 관리, 메시지 전송, API 통합이 필요할 때 사용합니다.”`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`도구-활용`,children:`도구 활용`}),`\n`,_jsx(Heading,{level:`3`,id:`에이전트에-도구-연결`,children:`에이전트에 도구 연결`}),`\n`,_jsx(_components.p,{children:`도구를 에이전트에 연결하면 AI가 대화 중 자동으로 적절한 시점에 도구를 호출합니다.`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`워크스페이스 > 에이전트`}),`에서 에이전트 편집 화면을 엽니다`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`도구`}),` 섹션에서 연결할 도구를 선택합니다`]}),`\n`,_jsx(_components.li,{children:`저장합니다`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`채팅에서-도구-호출-과정`,children:`채팅에서 도구 호출 과정`}),`\n`,_jsx(_components.p,{children:`AI가 사용자 질문을 분석하여 도구가 필요한지 판단하고, 필요한 경우 자동으로 호출합니다.`}),`\n`,_jsx(CodeBlock,{numberOfLines:`13`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`13`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`사용자: 고객 ID 12345의 정보를 조회해줘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`AI: [CRM API 호출 중...]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`고객 정보를 조회했습니다:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`| 항목 | 값 |`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`|------|-----|`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`| 이름 | 홍길동 |`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`| 이메일 | hong@example.com |`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`| 등급 | VIP |`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`| 최근 구매일 | 2024-01-15 |`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`도구-관리`,children:`도구 관리`}),`\n`,_jsx(Heading,{level:`3`,id:`편집`,children:`편집`}),`\n`,_jsxs(_components.p,{children:[`도구 목록에서 카드를 클릭하면 상세 페이지로 이동하여 연결 설정, 이름, 설명, 도구 설명 등을 수정할 수 있습니다.\n상세 페이지 우측 상단의 `,_jsx(_components.strong,{children:`저장 및 업데이트`}),` 버튼으로 변경 사항을 저장합니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`삭제`,children:`삭제`}),`\n`,_jsxs(_components.p,{children:[`도구 목록에서 카드 우측의 메뉴(`,_jsx(_components.code,{children:`...`}),`)를 클릭하고 `,_jsx(_components.strong,{children:`삭제`}),`를 선택합니다.\n삭제 확인 다이얼로그에서 확인하면 도구가 영구 삭제됩니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`접근-권한-변경`,children:`접근 권한 변경`}),`\n`,_jsxs(_components.p,{children:[`상세 페이지 우측 상단의 `,_jsx(_components.strong,{children:`접근`}),` 버튼을 클릭하여 접근 권한을 변경할 수 있습니다.\n`,_jsx(_components.strong,{children:`접근 권한`}),`을 `,_jsx(_components.strong,{children:`전체 사용자`}),` 또는 `,_jsx(_components.strong,{children:`지정된 그룹만`}),`으로 고르고, 그룹마다 `,_jsx(_components.strong,{children:`편집 가능`}),` 여부를 지정할 수 있습니다.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`보안-고려사항`,children:`보안 고려사항`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`보안 기능`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`암호화 통신`})}),_jsx(_components.td,{children:`모든 API 호출은 TLS로 암호화`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`자격 증명 저장`})}),_jsx(_components.td,{children:`API 키는 데이터베이스에 JSON 형태로 저장됩니다`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`접근 제어`})}),_jsx(_components.td,{children:`읽기/쓰기 권한별 도구 사용 제한`})]})]})]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`API 키는 평문으로 저장되므로 정기적으로 순환(rotate)하세요.\n사설 네트워크 내 API만 연결하고, 필요시 IP 화이트리스트 또는 VPN/Private Endpoint를 활용하세요.\n데이터베이스 접근 권한을 적절히 제한하여 자격 증명을 보호하세요.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`트러블슈팅`,children:`트러블슈팅`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`연결 실패`,icon:`triangle-exclamation`,id:`%EC%9B%90%EC%9D%B8-%ED%95%B4%EA%B2%B0-%EB%B0%A9%EB%B2%95-url-%EC%98%A4%EB%A5%98-api-%EA%B8%B0%EB%B3%B8-url-%EB%B0%8F-openapi-%EC%8A%A4%ED%8E%99-%EA%B2%BD%EB%A1%9C%EB%A5%BC-%EC%9E%AC%ED%99%95%EC%9D%B8%ED%95%A9%EB%8B%88%EB%8B%A4-%EC%9D%B8%EC%A6%9D-%EC%8B%A4%ED%8C%A8-api-%ED%82%A4%2F%ED%86%A0%ED%81%B0-%EC%9C%A0%ED%9A%A8%EC%84%B1%EC%9D%84-%ED%99%95%EC%9D%B8%ED%95%A9%EB%8B%88%EB%8B%A4-%EB%84%A4%ED%8A%B8%EC%9B%8C%ED%81%AC-%EB%B0%A9%ED%99%94%EB%B2%BD%2F%ED%94%84%EB%A1%9D%EC%8B%9C-%EC%84%A4%EC%A0%95%EC%9D%84-%ED%99%95%EC%9D%B8%ED%95%A9%EB%8B%88%EB%8B%A4-cors-%EC%84%9C%EB%B2%84-%EC%B8%A1-cors-%EC%84%A4%EC%A0%95%EC%9D%84-%ED%99%95%EC%9D%B8%ED%95%A9%EB%8B%88%EB%8B%A4`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`원인`}),_jsx(_components.th,{children:`해결 방법`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`URL 오류`}),_jsx(_components.td,{children:`API 기본 URL 및 OpenAPI 스펙 경로를 재확인합니다`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`인증 실패`}),_jsx(_components.td,{children:`API 키/토큰 유효성을 확인합니다`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`네트워크`}),_jsx(_components.td,{children:`방화벽/프록시 설정을 확인합니다`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`CORS`}),_jsx(_components.td,{children:`서버 측 CORS 설정을 확인합니다`})]})]})]})}),_jsx(Accordion,{title:`API 호출 실패`,icon:`triangle-exclamation`,id:`api`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`원인`}),_jsx(_components.th,{children:`해결 방법`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`권한 부족`}),_jsx(_components.td,{children:`API 권한(scope)을 확인합니다`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Rate Limit`}),_jsx(_components.td,{children:`호출 빈도를 조절합니다`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`서버 오류`}),_jsx(_components.td,{children:`외부 서비스 상태를 확인합니다`})]})]})]})}),_jsx(Accordion,{title:`MCP 서버 연결 실패`,icon:`triangle-exclamation`,id:`mcp`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`원인`}),_jsx(_components.th,{children:`해결 방법`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`URL 형식`}),_jsxs(_components.td,{children:[`SSE 엔드포인트 URL 형식을 확인합니다 (예: `,_jsx(_components.code,{children:`https://mcp.example.com/sse`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`인증 방식 불일치`}),_jsx(_components.td,{children:`서버가 요구하는 인증 방식(없음/Bearer Token/API Key)과 설정이 일치하는지 확인합니다`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`연결 비활성화`}),_jsx(_components.td,{children:`활성화됨 토글이 활성화 상태인지 확인합니다`})]})]})]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`faq`,children:`FAQ`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`어떤 API든 연결할 수 있나요?`,icon:`circle-question`,id:`api-1`,children:_jsx(_components.p,{children:`OpenAPI(Swagger) 스펙을 제공하는 API는 모두 연결 가능합니다.\n스펙이 없는 경우 MCP 서버를 직접 구축하거나, OpenAPI 스펙을 별도로 작성해야 합니다.`})}),_jsx(Accordion,{title:`API 호출 비용이 발생하나요?`,icon:`circle-question`,id:`api-2`,children:_jsx(_components.p,{children:`외부 API 사용 시 해당 서비스의 과금 정책이 적용됩니다.\nCloosphere 자체에서는 도구 호출에 대한 추가 비용이 없습니다.`})}),_jsx(Accordion,{title:`민감한 데이터도 안전한가요?`,icon:`circle-question`,id:`-1`,children:_jsx(_components.p,{children:`모든 통신은 TLS로 암호화되며, 접근 권한을 세밀하게 설정하여 사용을 제한할 수 있습니다.\n가드레일을 함께 사용하면 민감 정보 유출을 추가로 방지할 수 있습니다.`})}),_jsx(Accordion,{title:`OpenAPI와 MCP 중 어떤 것을 사용해야 하나요?`,icon:`circle-question`,id:`openapi-mcp`,children:_jsx(_components.p,{children:`기존에 OpenAPI 스펙을 제공하는 REST API가 있다면 OpenAPI를 선택하세요.\nAI 전용 도구 서버를 새로 구축하거나, MCP 호환 서버를 이미 보유하고 있다면 MCP를 선택하세요.`})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`다음-단계`,children:`다음 단계`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`에이전트에 도구 연결`,icon:`robot`,href:`/ko/workspace/agents`,children:_jsx(_components.p,{children:`도구를 에이전트에 연결하여 AI 능력을 확장`})}),_jsx(Card,{title:`추적`,icon:`chart-line`,href:`/ko/monitoring/tracing`,children:_jsx(_components.p,{children:`도구 호출 과정을 단계별 추적`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"도구","description":"외부 API 및 MCP 서버를 AI에 연결하여 실시간 데이터 조회와 작업 자동화","href":"/ko/workspace/tools"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"도구란?","slug":"도구란","depth":2,"children":[{"title":"활용 예시","slug":"활용-예시","depth":3,"children":[]},{"title":"지원 프로토콜","slug":"지원-프로토콜","depth":3,"children":[]}]},{"title":"도구 목록","slug":"도구-목록","depth":2,"children":[]},{"title":"도구 생성","slug":"도구-생성","depth":2,"children":[]},{"title":"OpenAPI 도구 연결","slug":"openapi-도구-연결","depth":2,"children":[{"title":"연결 설정 필드","slug":"연결-설정-필드","depth":3,"children":[]},{"title":"연결 테스트 및 기능 확인","slug":"연결-테스트-및-기능-확인","depth":3,"children":[]}]},{"title":"MCP 도구 연결","slug":"mcp-도구-연결","depth":2,"children":[{"title":"연결 설정 필드","slug":"연결-설정-필드-2","depth":3,"children":[]},{"title":"MCP 인증 방식","slug":"mcp-인증-방식","depth":3,"children":[]},{"title":"추가 헤더 설정","slug":"추가-헤더-설정","depth":3,"children":[]},{"title":"연결 테스트","slug":"연결-테스트","depth":3,"children":[]}]},{"title":"도구 설명 (에이전트용 설명)","slug":"도구-설명-에이전트용-설명","depth":2,"children":[]},{"title":"도구 활용","slug":"도구-활용","depth":2,"children":[{"title":"에이전트에 도구 연결","slug":"에이전트에-도구-연결","depth":3,"children":[]},{"title":"채팅에서 도구 호출 과정","slug":"채팅에서-도구-호출-과정","depth":3,"children":[]}]},{"title":"도구 관리","slug":"도구-관리","depth":2,"children":[{"title":"편집","slug":"편집","depth":3,"children":[]},{"title":"삭제","slug":"삭제","depth":3,"children":[]},{"title":"접근 권한 변경","slug":"접근-권한-변경","depth":3,"children":[]}]},{"title":"보안 고려사항","slug":"보안-고려사항","depth":2,"children":[]},{"title":"트러블슈팅","slug":"트러블슈팅","depth":2,"children":[]},{"title":"FAQ","slug":"faq","depth":2,"children":[]},{"title":"다음 단계","slug":"다음-단계","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/cloocus/45db6ee3c57396cb/toc.js","/_mintlify/custom/cloocus/9670a2c81dc38d5e/tools/playwright-video-mcp/index.js","/_mintlify/custom/cloocus/4540e1c308555295/lang-toggle.js"],"subdomain":"cloocus","siteName":"Cloosphere Guide","title":"도구 - Cloosphere Guide","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"ko":{"href":"/ko/workspace/tools","matchLevel":0},"en":{"href":"/en/workspace/tools","matchLevel":1}}},"lastModified":"2026-08-21T05:37:35.438Z","originalFileLocation":"ko/workspace/tools.mdx","locale":"ko"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"외부 API 및 MCP 서버를 AI에 연결하여 실시간 데이터 조회와 작업 자동화\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"도구 - Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:description\" content=\"외부 API 및 MCP 서버를 AI에 연결하여 실시간 데이터 조회와 작업 자동화\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cloosphere.ai/ko/workspace/tools\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=%EC%BB%A4%EC%8A%A4%ED%84%B0%EB%A7%88%EC%9D%B4%EC%A7%95\u0026amp;title=%EB%8F%84%EA%B5%AC\u0026amp;description=%EC%99%B8%EB%B6%80+API+%EB%B0%8F+MCP+%EC%84%9C%EB%B2%84%EB%A5%BC+AI%EC%97%90+%EC%97%B0%EA%B2%B0%ED%95%98%EC%97%AC+%EC%8B%A4%EC%8B%9C%EA%B0%84+%EB%8D%B0%EC%9D%B4%ED%84%B0+%EC%A1%B0%ED%9A%8C%EC%99%80+%EC%9E%91%EC%97%85+%EC%9E%90%EB%8F%99%ED%99%94\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=10680513d906381b44dfc37f0ac1cf9a77bb017af08582ab7472c6ca3344ded7\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"도구 - Cloosphere Guide\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"외부 API 및 MCP 서버를 AI에 연결하여 실시간 데이터 조회와 작업 자동화\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=%EC%BB%A4%EC%8A%A4%ED%84%B0%EB%A7%88%EC%9D%B4%EC%A7%95\u0026amp;title=%EB%8F%84%EA%B5%AC\u0026amp;description=%EC%99%B8%EB%B6%80+API+%EB%B0%8F+MCP+%EC%84%9C%EB%B2%84%EB%A5%BC+AI%EC%97%90+%EC%97%B0%EA%B2%B0%ED%95%98%EC%97%AC+%EC%8B%A4%EC%8B%9C%EA%B0%84+%EB%8D%B0%EC%9D%B4%ED%84%B0+%EC%A1%B0%ED%9A%8C%EC%99%80+%EC%9E%91%EC%97%85+%EC%9E%90%EB%8F%99%ED%99%94\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=10680513d906381b44dfc37f0ac1cf9a77bb017af08582ab7472c6ca3344ded7\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5f22d0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cloosphere.ai/ko/workspace/tools\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ko/workspace/tools.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.cloosphere.ai/ko/workspace/tools\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.cloosphere.ai/en/workspace/tools\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.cloosphere.ai/ko/workspace/tools\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cloosphere.ai/#organization\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cloosphere.ai#website\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cloosphere.ai/ko/workspace/tools#webpage\",\"url\":\"https://docs.cloosphere.ai/ko/workspace/tools\",\"name\":\"도구\",\"description\":\"외부 API 및 MCP 서버를 AI에 연결하여 실시간 데이터 조회와 작업 자동화\",\"dateModified\":\"2026-08-21T05:37:35.438Z\",\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cloosphere.ai/ko/workspace/tools#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cloosphere.ai/ko/workspace/tools#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"커스터마이징\",\"item\":\"https://docs.cloosphere.ai/ko/workspace/prompts\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"도구\",\"item\":\"https://docs.cloosphere.ai/ko/workspace/tools\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cloosphere.ai/ko/workspace/tools#article\",\"headline\":\"도구\",\"name\":\"도구\",\"description\":\"외부 API 및 MCP 서버를 AI에 연결하여 실시간 데이터 조회와 작업 자동화\",\"url\":\"https://docs.cloosphere.ai/ko/workspace/tools\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cloosphere.ai/ko/workspace/tools#webpage\"},\"dateModified\":\"2026-08-21T05:37:35.438Z\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cloosphere Guide\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cloosphere Guide\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/ko/workspace/tools.md","siteName":"Cloosphere Guide","nav":{"global":null,"languages":[{"language":"ko","default":true,"tabs":[{"tab":"시작하기","icon":"rocket","pages":[{"title":"시작하기","href":"/ko"}]},{"tab":"채팅","icon":"comments","pages":[{"title":"채팅","href":"/ko/chat/overview"}]},{"tab":"워크스페이스","icon":"briefcase","groups":[{"group":"워크스페이스","pages":[{"title":"워크스페이스 개요","href":"/ko/workspace/overview"}]},{"group":"AI 에이전트","pages":[{"title":"에이전트","href":"/ko/workspace/agents"},{"title":"에이전트 플로우","href":"/ko/workspace/flows"},{"title":"플로우 노드 레퍼런스","href":"/ko/workspace/flows-nodes"}]},{"group":"지식 \u0026 데이터","pages":[{"title":"지식기반","href":"/ko/workspace/knowledge"},{"title":"동적 필터 상세 가이드","href":"/ko/workspace/knowledge-filters"},{"title":"지식 그래프","href":"/ko/workspace/knowledge-graph"},{"title":"데이터베이스","href":"/ko/workspace/database"},{"title":"용어집","href":"/ko/workspace/glossary"}]},{"group":"안전","pages":[{"title":"가드레일","href":"/ko/workspace/guardrails"}]},{"group":"커스터마이징","pages":[{"title":"프롬프트","href":"/ko/workspace/prompts"},{"title":"스킬","description":"에이전트가 스스로 불러 따르는 재사용 지침서(playbook)를 만들고, 문서 생성 같은 반복 작업을 표준화합니다","href":"/ko/workspace/skills"},{"title":"도구","href":"/ko/workspace/tools"},{"title":"마켓플레이스","description":"PPT·Word·Excel·HTML 문서 생성기와 Google Workspace·Microsoft 365 연동을 에이전트에 추가하는 Cloosphere 자체 서비스 카탈로그","href":"/ko/workspace/marketplace"},{"title":"태그","href":"/ko/workspace/tags"}]}]},{"tab":"협업","icon":"users","pages":[{"title":"협업","href":"/ko/collaboration/overview"}]},{"tab":"자동화","icon":"clock","pages":[{"title":"자동화","href":"/ko/automation/overview"}]},{"tab":"관리자","icon":"gear","pages":[{"title":"관리자","href":"/ko/admin/overview"}]},{"tab":"모니터링","icon":"chart-line","pages":[{"title":"모니터링","href":"/ko/monitoring/overview"}]},{"tab":"운영 · 지원","icon":"screwdriver-wrench","pages":[{"title":"운영 · 지원","href":"/ko/admin/deployment-checklist"}]}]},{"language":"en","pages":[{"title":"en","href":"/en/workspace/tools"}]}]},"basePath":"","title":"도구 - Cloosphere Guide","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["07c022d89b","a74be98ba7","a9bb46feb3"],"chunks":["Frame-D0FT0qQs.js","DynamicMarkdown-CQM9Bhbv.js","zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}