MCP(Model Context Protocol)를 통해 관리자는 Zendesk를 외부 MCP 서버에 연결하여 그러한 서버에서 제공하는 도구를 찾아보고 그러한 도구를 작업 플로우의 단계로 사용할 수 있습니다. 이로써 Zendesk 워크플로우가 확장되어 맞춤 API 연동을 구축하지 않고도 프로젝트 관리 도구, 전자 상거래 플랫폼, 내부 지식 시스템 등의 타사 시스템과 상호작용할 수 있습니다.
관리 센터 에서 MCP 연결을 만들고 관리합니다. 연결을 만든 후에는 Zendesk가 해당 서버에서 사용 가능한 MCP 도구를 검색하여 작업 빌더에 표시하므로 작업 플로우에서 사용하고 원하는 경우 자동 지원 , AI 상담사 또는 사용자 지정 상담사를 통해 그러한 플로우를 표시할 수 있습니다.
이 문서에서는 MCP 클라이언트 역할을 하는 Zendesk에 대해 다룹니다. 이 역할에서 Zendesk는 외부 MCP 서버에 연결하여 외부에서 노출되는 도구를 발견하고 작업 플로우와 자동 지원 에서 그러한 도구를 사용합니다. 이 모델에서 Zendesk는 다른 시스템에 요청을 보내 정보를 검색하거나 워크플로우의 일부로 작업을 수행합니다. Zendesk는 다른 시나리오에서 MCP 서버 역할을 할 수도 있습니다. 이 역할을 통해 Zendesk는 타사 AI 상담사가 Zendesk 데이터에 액세스하거나 Zendesk에서 작업을 수행하는 데 사용할 수 있는 도구나 리소스를 표시합니다.
다음 다이어그램은 두 가지 MCP 역할을 모두 보여줍니다.
이 문서에서는 다음과 같은 주제를 다룹니다.
MCP 도구 사용을 위한 고려 사항
시작하기 전에 다음 사항을 염두에 두세요.
- 인증
- OAuth 는 MCP 서버 연결에 지원되는 유일한 인증 방법입니다. HTTP 서버만 지원됩니다. Stlio 전송은 지원되지 않습니다.
- 데이터 레지던시 및 보존
- 외부 MCP 연결은 선택한 지역 밖에서 데이터를 전송할 수도 있습니다.
- 단계 실행 출력은 7일 동안 보존됩니다.
- 작업 크레딧
- MCP 도구 작업은 작업 플로우 내에서 실행될 때 작업 크레딧을 소모합니다. 사용량 모니터링에 대한 자세한 내용은 작업 크레딧 및 작업 플로우 활동의 사용량 모니터링하기를 참조하세요.
- 연결 및 도구 제한
- Zendesk 계정에 연결할 수 있는 MCP 서버 수에는 제한이 없습니다.
- 작업 빌더는 페이지 번호를 매기고 MCP 서버에서 리턴된 최대 250개의 도구를 검색합니다.
- 연결 페이지에서 도구 목록을 수동으로 새로 고쳐 기존 도구에 대한 업데이트를 받거나, 새 도구를 발견하거나, 더 이상 사용되지 않는 도구를 제거할 수 있습니다. 기존 작업 플로우는 단계를 제거하고 플로우에 다시 추가할 때까지 업데이트된 도구의 이전 버전을 계속 사용합니다.
MCP 서버 연결 만들기
관리자는 MCP 서버 연결을 추가할 수 있습니다. 연결된 MCP 서버는 관리 센터 의 MCP 연결 페이지에 나타납니다. 서버가 연결되면 Zendesk는 MCP 서버에 의해 표시되는 최대 250개의 도구를 자동으로 검색합니다. 검색 후에는 관리자가 작업 빌더에서 사용할 수 있는 도구를 명시적으로 선택할 수 있는 연결 페이지에 도구가 나열됩니다.
Zendesk 관리자만 MCP 서버 연결을 만들 수 있습니다.
-
관리 센터의 사이드바에서
앱 및 연동 서비스를 클릭한 다음 연결 > 연결을 선택합니다.
- 연결 추가를 클릭합니다.
- MCP 서버에 연결을 선택합니다.
- 다음을 클릭합니다.
- 기본 사항 아래에서 연결의 이름 및 설명을 입력합니다.
- 다음을 클릭합니다.
- MCP 서버 에 MCP 서버의 URL을 입력합니다.
- URL 테스트를 클릭하여 MCP 서버에 대한 연결을 확인합니다.
- 메시지가 표시되면 클라이언트 ID, 클라이언트 비밀키, 권한 부여 엔드포인트 또는 토큰 엔드포인트와 같은 MCP 서버에 필요한 모든 OAuth 클라이언트 세부 정보를 입력합니다. 필수 필드는 서버의 구성에 따라 다릅니다.
- 메시지가 표시되면 MCP 서버의 인증 팝업을 사용하여 외부 서비스에 대한 OAuth 인증 플로우를 완료합니다.
MCP 서버로 인해 GitHub 또는 HubSpot과 같은 외부 서비스에서 OAuth 앱을 만들어야 하는 경우, 리디렉션 또는 콜백 URL을 입력하라는 메시지가 표시될 때 을 입력합니다.
https://zis.zendesk.com/api/services/zis/connections/oauth/callback. - 저장을 클릭합니다.
- 저장되면 연결 페이지에서 검색된 도구 목록을 볼 수 있습니다. 확인란을 사용하여 작업 플로우에 사용할 검색된 도구를 선택합니다.
MCP 연결 새로 고침
권한 부여가 만료되었거나 무효화되어 MCP 연결이 작동을 멈추는 경우에는 다시 연결할 수 있습니다.
다음과 같은 경우에 사용하세요.
- 비활성 상태로 연결이 만료되었습니다.
- 외부 시스템에 대한 사용자의 액세스 권한이 변경되었거나 취소되었습니다.
- 자격 증명이나 권한이 변경된 후에는 연결에 다시 권한을 부여해야 합니다.
Zendesk 관리자만 MCP 서버 연결을 만들 수 있습니다.
MCP 연결을 새로 고치려면 다음과 같이 하세요.
- 관리 센터의 사이드바에서 앱 및 연동 서비스를 클릭한 다음 연결 > 연결을 선택합니다.
- 이름을 클릭하거나 오버플로우 메뉴를 열고 연결 편집을 선택하여 관련 MCP 연결을 선택합니다.
- 다시 연결을 클릭합니다.
- 메시지가 표시되면 OAuth 플로우를 다시 완료합니다.
MCP 서버 도구 새로 고침
MCP 연결에 사용 가능한 도구 목록을 새로 고쳐 연결을 다시 만들지 않고도 업데이트를 받거나, 새 도구를 발견하거나, 삭제된 도구를 제거할 수 있습니다.
다음과 같은 경우에 사용하세요.
- MCP 서버에서 새 도구를 사용할 수 있습니다.
- 기존 도구의 입력, 매개변수 또는 출력 구조가 변경되었습니다.
- 삭제되거나 더 이상 사용되지 않는 도구는 Zendesk에서 제거해야 합니다.
Zendesk 관리자만 MCP 서버 연결을 만들 수 있습니다.
MCP 서버 도구를 새로 고치려면 다음과 같이 하세요.
- 관리 센터의 사이드바에서 앱 및 연동 서비스를 클릭한 다음 연결 > 연결을 선택합니다.
- 이름을 클릭하거나 오버플로우 메뉴를 열고 연결 편집을 선택하여 관련 MCP 연결을 선택합니다.
- 도구 새로 고침을 클릭합니다.
- 확인 대화 상자에서 도구 새로 고침을 클릭합니다.
MCP 서버의 예
다음은 연결할 수 있는 MCP 서버의 몇 가지 예입니다. 다른 많은 벤더들이 MCP 서버를 제공하며 귀사는 자체 조직의 MCP 서버에 연결할 수도 있습니다.
- MCP 서버 URL: https://mcp.asana.com/v2/mcp
- 클라이언트 세부 정보: OAuth 앱 만들기 의 안내에 따라 클라이언트 ID와 비밀키를 생성합니다.
- MCP 서버 URL: https://mcp.stripe.com
- 클라이언트 세부 정보: 필수 아님. 연결을 테스트할 때 클라이언트 ID 및 비밀키가 자동으로 감지됩니다.
- MCP 서버 URL: https://api.githubcopilot.com/mcp/
- 클라이언트 세부 정보: OAuth 앱 만들기 의 안내에 따라 클라이언트 ID 및 비밀키를 생성합니다.
작업 플로우에서 MCP 도구 사용하기
MCP 서버 연결을 만든 후에는 작업 빌더에서 검색된 도구를 사용할 수 있습니다. MCP 커넥터는 외부 작업 아래에 나타나며 제공한 연결 이름과 MCP 태그로 식별됩니다. 작업 플로우에 대한 자세한 내용은 작업 빌더 및 작업 플로우 이해하기를 참조하세요.
작업 플로우가 실행되면 Zendesk는 구성된 입력을 사용하여 외부 서버에서 선택한 MCP 도구를 호출하고 나중 단계에서 사용할 수 있도록 도구의 출력을 리턴합니다. 나중에 플로우에서 사용자 지정 코드 단계를 사용하여 필요한 경우 출력에서 특정 필드를 추출하거나 변환할 수 있습니다.
MCP 도구를 작업 플로우의 단계로 추가하려면 다음과 같이 하세요.
- 작업 빌더를 열고 작업 플로우를 만들거나 편집합니다 .
- 작업 빌더에서 기존 단계 아래의 단계 추가 아이콘(
)을 클릭합니다. - 단계 사이드바의 외부 작업 아래에서 메뉴 옵션을 클릭하여 연결된 MCP 서버를 선택한 다음 특정 작업을 선택합니다.
- 단계 사이드바에서 선택한 작업에 필요한 입력을 작성합니다. 작업 및 단계를 위한 입력 제공하기를 참조하세요.
MCP 도구의 입력이나 출력이 변경되면 기존 작업 플로우가 이전 버전의 도구를 계속 실행합니다. 작업 플로우에서 업데이트된 버전을 사용하려면 다음과 같이 하세요.
- 캔버스에서 도구 단계를 제거합니다.
- 플로우에 도구 단계를 다시 추가합니다.
- 그러한 변수 참조를 제거하고 다시 추가하여 도구의 변수를 참조하는 모든 후속 단계를 업데이트합니다.
MCP 도구에서 여러 데이터 유형(예:oneOf 스키마)의 경우에는 작업 빌더가 도구의 정의에 나열된 첫 번째 데이터 유형에 입력 필드를 배정합니다(예를 들어 기본적으로 정수로 설정). 단계에 전달된 값이 필드에서 예상하는 기본 데이터 유형과 일치하는지 확인하세요.
MCP 도구의 출력 맵핑하기
일부 MCP 도구는 작업 플로우의 나중 단계에서 재사용할 수 있는 구조화된 데이터를 리턴합니다. 도구의 리턴된 필드를 맵핑된 출력으로 사용할 수 있도록 출력 스키마를 구성할 수 있습니다.
출력 스키마를 정의하지 않으면 Zendesk에서 도구 출력을 단일 값으로 처리합니다. 도구가 개체나 배열을 리턴하면 Zendesk가 이를 문자열로 변환합니다. 특정 필드를 추출하거나 변환해야 하는 경우에는 사용자 지정 코드 단계를 사용하세요.
Zendesk 관리자만 MCP 서버 연결을 만들 수 있습니다.
MCP 도구의 출력 스키마를 구성하려면 다음과 같이 하세요.
- 관리 센터의 사이드바에서 앱 및 연동 서비스를 클릭한 다음 연결 > 연결을 선택합니다.
- MCP 연결을 열고 구성하려는 도구를 찾습니다.
- 도구의 오버플로우 메뉴에서 출력 스키마 구성을 선택합니다.
- 다음 중 하나를 선택하세요.
- 샘플 응답 추가 : 샘플 JSON 응답 개체를 붙여넣은 다음 출력 맵핑을 클릭합니다.
- API 호출하기: 필요한 인수 값을 입력한 다음(또는 JSON으로 편집을 클릭하여 인수를 원시 JSON으로 입력) 도구 실행을 클릭하여 출력 구조를 생성합니다.
참고: 도구 매개변수가 문자열이나 정수와 같은 여러 데이터 유형을 허용하는 경우에는 API 호출하기 양식에 직접 실행할 수 없는 ‘옵션 1’ 및 ‘옵션 2’와 같은 드롭다운 옵션이 표시됩니다. 이러한 매개변수에 대한 테스트 값을 입력하려면 JSON으로 편집을 클릭하고 테스트 페이로드를 JSON 개체로 제공합니다. - 맵핑된 출력으로 표시하려는 필드를 선택합니다.
- 필드 이름이나 데이터 유형을 업데이트합니다(선택 사항).
- 저장을 클릭합니다.
문제 해결하기
-
액세스가 제한된 서버 : Zendesk는 클라이언트별로 액세스를 제한하는 서버를 Support 하지 않습니다. 하지만 경우에 따라 MCP 서버 소유자에게 Zendesk MCP 클라이언트를 허용 목록에 추가해 달라고 요청할 수도 있습니다. 이 경우 서버 소유자는 다음과 같은 세부 정보를 요청할 수 있습니다.
- 계정의 Zendesk IP 범위 : https:// yoursubdomain .zendesk.com/ips
- Zendesk MCP 클라이언트 리디렉션 URL : https://zis.zendesk.com/api/services/zis/connections/oauth/callback
- PKCE(Proof Key for Code Exchange) : S256 챌린지 방법과 함께 PKCE를 사용하는 MCP 서버가 지원됩니다. 일반 챌린지 방법만 Support 서버는 보안상의 이유로 지원되지 않습니다.
- 실행 시간 제한 및 호출 빈도 제한 : MCP 도구 호출은 30초 제한 시간이 있을 수 있습니다. 장기 실행 도구 작업은 완료하기 전에 시간이 초과될 수 있습니다. 호출 빈도 제한은 작업 플로우 사용을 위한 고려 사항을 참조하세요.
-
인증: 인증이 필요 없는 MCP 서버는 지원되지 않습니다. Zendesk의 MCP 클라이언트는 표준 잘 알려진 엔드포인트를 사용하여 자동 검색으로 OAuth 2.0을 구현하는 서버를 지원합니다.
공개 MCP 서버의 인증 문제를 해결하거나 자체 조직의 MCP 서버를 설정하려면 다음을 시도하세요.
-
핸드셰이크를 시작합니다.MCP 클라이언트가 처음 연결을 시도하면 서버가 로 응답합니다.
401 Unauthorized의 보호 리소스 Metadata 문서에 대한 참조를 포함합니다.WWW-Authenticate헤더를 참조하세요.HTTP/1.1 401 Unauthorized WWW-Authenticate: Bearer realm="mcp", resource_metadata="https://your-server.com/.well-known/oauth-protected-resource"클라이언트에게 권한 부여가 필요하며 권한 부여 플로우를 시작하는 데 필요한 정보를 검색할 위치를 알려줍니다.
-
보호 대상 리소스 메타데이터를 살펴보세요.
클라이언트는 보호 리소스 Metadata 문서를 가져와 권한 부여 서버, 지원되는 범위 및 기타 리소스 세부 정보에 대해 알아봅니다.
요청:
https://your-mcp-server.com/.well-known/oauth-protected-resource예시 응답(200 OK):
{"resource":"https://your-mcp-server.com","authorization_servers":["https://your-auth-server.com"],"scopes_supported":["mcp:read","mcp:write"]} -
권한 부여 서버를 발견합니다.
클라이언트는 메타데이터를 가져와서 권한 부여 서버의 기능을 검색합니다.
요청:https://your-auth-server.com/.well-known/oauth-authorization-serverOAuth 서버가 실행되는 경우 이 엔드포인트는 MCP 서버와 같은 도메인에서 호스팅될 수 있습니다.
예시 응답(200 OK):
{ "issuer": "https://your-auth-server.com", "authorization_endpoint": "https://your-auth-server.com/oauth/authorize", "token_endpoint": "https://your-auth-server.com/oauth/token", "registration_endpoint": "https://your-auth-server.com/oauth/register", "code_challenge_methods_supported": ["S256"], "token_endpoint_auth_methods_supported": ["client_secret_basic", "none"], "scopes_supported": ["mcp:read", "mcp:write"] } -
클라이언트를 등록합니다.
검색이 완료된 후에는 다음 방법 중 하나를 사용하여 서버의 인증 시스템에 Zendesk 클라이언트를 등록해야 합니다.
- 사전 등록된 클라이언트: 클라이언트가 이미 권한 부여 서버에 등록되어 있습니다. MCP 연결을 만들 때 권한 부여 플로우를 완료하기 위해 클라이언트 세부 정보를 수동으로 제공합니다.
- 자동 등록(동적 클라이언트 등록): Zendesk는 표준 웹 프로토콜을 사용하여 자동으로 등록을 시도합니다. 기본 프로토콜이 실패하면 Zendesk는 자동으로 대체 형식(OpenID Connect)을 시도하여 사용자의 개입 없이 연결을 완료합니다.
- 수동 구성(백업): Zendesk가 어느 방법으로도 서버에 자동으로 등록할 수 없는 경우에는 관리자가 필요한 모든 OAuth 클라이언트 세부 정보를 수동으로 입력하여 연결을 설정할 수 있습니다.
-
핸드셰이크를 시작합니다.
번역 고지 사항: 본 문서는 콘텐츠에 대한 기본적인 이해를 제공하기 위해 자동 번역 소프트웨어를 사용하여 번역되었습니다. 정확한 번역을 제공하고자 합당한 노력을 기울였으나 Zendesk는 번역의 정확성을 보장하지 않습니다.
번역된 문서에 포함된 정보의 정확성과 관련하여 질문이 있으시면 문서의 공식 버전인 영문 버전을 참조하시기 바랍니다.