Performance Hub에 연결하기

일반 챗봇과 AI 에이전트의 차이점은 비즈니스와 연동되어 있다는 점입니다. Performance Hub의 MCP 연결을 통해 에이전트는 고객 및 회원 조회, 예약 및 방문 확인, 장치 상태 검토, 보고서 추출 등 Performance Hub에서 볼 수 있는 것과 동일한 운영 데이터에 대화 및 자동화를 통해 접근할 수 있습니다.

에이전트가 Performance Hub의 어느 범위까지 접근할 수 있는지(어떤 시설, 어떤 기능, 심지어 어떤 개별 도구까지 허용할지) 정확하게 제어할 수 있습니다. 이 페이지에서는 이러한 옵션에 대해 설명합니다.

MCP access는 Device management의 Configuration → MCP access에서 설정할 수 있습니다.

그림 1: MCP access 섹션 — 접근 범위, 기능 및 켜기/끄기 스위치

빠른 참조

권장 사항: MCP access를 켜둔 상태로 유지하세요(기본값). 이 연결은 에이전트를 비즈니스에 진정으로 유용하게 만드는 핵심이며, 기본적으로 에이전트가 추가된 시설로만 안전하게 범위가 제한됩니다. 나중에 여러 사이트, 지역 또는 전체 조직 등 더 넓은 범위의 데이터로 에이전트를 작동시켜야 하는 경우, 연결을 해제하는 대신 Access scope를 넓히세요. "이 기능을끄면 에이전트가 어떤 Performance Hub 기능, 도구 또는 데이터에도 접근할 수 없습니다."

연결을 통해 에이전트가 얻을 수 있는 것

MCP(Model Context Protocol)는 에이전트가 Performance Hub를 호출하는 데 사용하는 공개 표준입니다. "이 에이전트가 서비스 계정을 통해 Performance Hub 도구를 호출하도록 허용합니다. 장치에 키가 저장되지 않으며, 모든 요청 시 접근 권한이 확인되고 기능을 끄는 즉시 취소됩니다." 실제로 다음과 같은 질문을 할 수 있음을 의미합니다.

• "이번 주에 리셉션에 체크인한 방문객이 지난주와 비교해 얼마나 되나요?"
• "현재 오프라인 상태인 도어 컨트롤러는 무엇인가요?"
• "어제 결제가 실패한 고객을 찾아 계정 요약을 보여주세요."

…그러면 에이전트는 사용자가 부여한 범위 내에서 실시간 Performance Hub 데이터를 바탕으로 답변합니다. 동일한 연결을 통해 자동화(어제의 예약 내역 아침 요약, 주간 장치 상태 다이제스트) 및 Skills에 설명된 기본 제공 운영 런북이 구동됩니다.

에이전트는 특정 개인이 아니라 Performance Hub 내에서 고유한 신원(장치에 연결된 서비스 계정)으로 작동합니다. 에이전트가 수행하는 모든 호출은 신뢰에 의존하는 것이 아니라 Performance Hub 측에서 여기에 부여한 접근 권한에 대해 중앙에서 엄격하게 검증됩니다.

Access scope — 에이전트가 볼 수 있는 시설

• This facility(기본값) — 에이전트가 추가된 시설입니다. 단일 사이트 에이전트에 적합합니다.
• Selected facilities — 나열한 시설만 해당됩니다. 일부 사이트를 담당하는 에이전트에 유용합니다.
• Regions — 선택한 지역 내의 모든 시설입니다. 지역 관리자의 에이전트에 유용합니다.
• Entire organisation — 모든 시설입니다. 사이트 간 보고를 수행하는 본사 에이전트에 적합합니다.

"자신의 시설, 지역 및 권한 범위 내에서만 접근 권한을 부여할 수 있습니다."

Capabilities — 에이전트가 사용할 수 있는 기능

Capabilities는 Performance Hub 모듈에 연결된 도구 그룹입니다.

• All capabilities(기본값) — "에이전트는 새로운 기능이 추가될 때를 포함하여 사용 가능한 모든 기능을 사용할 수 있습니다."
• Only selected capabilities — "에이전트는 아래에서 선택한 기능만 사용할 수 있습니다." 구독 내용이 변경되더라도 에이전트는 정확히 이 기능들만 사용할 수 있으며 다른 기능은 사용할 수 없습니다.
• All capabilities except selected — "에이전트는 아래에서 선택한 기능을 제외한 모든 기능을 사용할 수 있습니다. 새로운 기능은 자동으로 포함됩니다." 청구 기능을 제외하는 등 전체적인 유용성을 유지하면서 적절한 절충안을 제공하는 좋은 옵션입니다.

이 섹션에는 읽기 전용 스위치도 포함되어 있습니다. 이 스위치를 켜면 변경을 수행하는 도구가 숨겨지고 거부되므로, 에이전트가 정보를 조회할 수는 있지만 어떤 항목도 변경할 수 없게 됩니다. 엄격하게 정보 제공용 에이전트를 운영하는 가장 간단한 방법입니다.

도구 선택(고급)

Advanced를 확장하고 Tool selection(Only selected tools 또는 All except selected tools)을 선택하여 부여된 기능 내에서 개별 도구를 포함하거나 제외함으로써 세밀하게 제어할 수 있습니다. 예를 들어 고객 조회는 허용하되 고객 수정은 제외할 수 있습니다. 대부분의 시설에서는 이 기능이 필요하지 않으며, 기능 수준의 제어로 충분합니다.

Last updated by에는 권한을 마지막으로 변경한 사람이 표시됩니다.

쓰기 작업 관련 참고 사항

읽기 전용 스위치를 켜지 않는 한, 부여 권한은 해당 기능이 허용하는 모든 범위(모듈이 제공하는 경우 단순히 데이터를 읽는 것뿐만 아니라 데이터를 변경하는 작업까지)를 포괄합니다. 에이전트를 정보 제공용으로만 유지하려면 읽기 전용 스위치를 사용하거나 보고 중심 기능으로 제한하거나 특정 도구를 제외하세요. 또한 에이전트는 대화 중 중요한 작업을 실행하기 전에 사용자에게 확인을 요청합니다.

기능 끄기 및 권한 철회

• MCP access를 끄면 에이전트와 Performance Hub 간의 연결이 즉시 해제됩니다. 에이전트는 파일과 Memory를 사용하는 일반 어시스턴트로 계속 작동하지만 비즈니스 데이터는 더 이상 확인할 수 없습니다. 변경 사항(켜기, 끄기 또는 범위 수정)은 저장 후 몇 분 내에 적용되며 재시작할 필요가 없습니다.
• 에이전트 제거 또는 재설정을 통해 자격 증명을 완전히 철회할 수 있습니다.

권한 부여 주체

권한 부여는 부여자의 권한 범위 내로 제한됩니다. 귀하가 조직에서 보유하고 있는 범위와 기능이 에이전트에게 부여할 수 있는 최대 한도입니다. 특정 옵션을 사용할 수 없는 경우, 귀하의 역할에 해당 권한이 포함되어 있지 않기 때문입니다. 필요한 권한을 가진 관리자가 대신 설정할 수 있습니다. MCP access를 전혀 변경할 수 없는 경우, 해당 섹션에 *"이 장치의 MCP access를 구성할 권한이 없습니다."*라는 메시지가 표시됩니다.

관련 페이지

• Skills — 이 연결을 실제로 활용하는 운영 런북
• Agent capabilities — 에이전트를 다른 앱과 연결하기
• Automations & scheduled tasks — Performance Hub 데이터를 사용하는 자동 실행 작업
• Access control — 에이전트와 대화할 수 있는 사용자(에이전트가 접근할 수 있는 범위와는 별개의 항목)
• Security & privacy