genesys-mcp

당신의 Genesys Cloud 조직을 AI의 손에. Genesys Cloud를 위한 오픈소스 MCP 서버로, Cloudflare Workers에서 실행됩니다. 제로 디펜던시, 터미널 필요 없음, 그리고 유일한 목적은 빌드하는 것입니다: 대기열, 스킬, 사용자, Wrap-Up 코드, Architect 플로우.

읽기만 하는 것이 아니라 빌드합니다.

Claude(또는 다른 MCP 클라이언트)에게 프롬프트:

• "Weekend Support라는 대기열을 생성해"

• "통화 플로우를 만들어: 발신자에게 인사, 1번 누르면 Weekend Support, 9번 누르면 통화 종료. 먼저 다이어그램을 보여줘"

• "내 Main IVR을 다이어그램으로 그려줘"

• "온보딩 준비: spanish 스킬을 만들고 Jess에게 숙련도 4로 할당해"

플로우 빌더는 실제 Archy YAML을 구성하고, 채팅에서 Mermaid 다이어그램으로 플로우를 보여준 후, Genesys 자체 flow-jobs 파이프라인(CX as Code가 사용하는 것과 동일)을 통해 게시합니다. 따라서 Genesys가 서버 측에서 검증 및 게시합니다.

의도적으로 하지 않는 것

• 분석 또는 KPI 도구 없음. 해당 영역은 이미 다루어져 있습니다. 대화 분석을 위한 MCP는 MakingChatbots의 genesys-cloud-mcp-server를 확인하세요.

• 연락처 목록 관리 없음.

• 삭제 없음. 삭제 도구가 없으며, 원시 API 도구는 DELETE를 거부합니다. 설계상 생성 우선입니다.

Related MCP server: Genesys Cloud MCP Server

3단계로 직접 배포

1. 배포: 버튼을 클릭(무료 Cloudflare 계정)하거나 git clone + npx wrangler deploy를 실행합니다. CONFIG KV 네임스페이스는 자동으로 프로비저닝됩니다.

2. Genesys OAuth 클라이언트 생성: 관리자 → 통합 → OAuth → 클라이언트 추가 → 권한 부여 유형 Client Credentials → 역할 할당(역할 범위 지정 참조) → 저장.

3. 구성: 새 Worker에서 /setup을 열고 Client ID, Secret, 리전을 붙여넣습니다. 마법사가 저장하기 전에 Genesys에 대해 실시간으로 유효성을 검사한 후, 액세스 키(한 번만 표시)를 제공합니다.

터미널에서 관리하는 구성을 선호하시나요? 대신 Wrangler 시크릿을 설정하세요. 마법사보다 우선 적용됩니다: GENESYS_CLIENT_ID, GENESYS_CLIENT_SECRET, GENESYS_REGION(예: usw2.pure.cloud), MCP_AUTH_TOKEN.

AI 연결

MCP 엔드포인트는 https://<your-worker>/mcp입니다.

• Claude(웹/데스크탑): 설정 → 커넥터 → 사용자 정의 커넥터 추가 → URL 붙여넣기. 인증 화면이 나타나면 액세스 키를 붙여넣으세요.

• Claude Code: claude mcp add --transport http genesys https://<your-worker>/mcp를 실행하고 프롬프트가 나타나면 인증합니다.

• ChatGPT: 설정 → 커넥터 → 고급 → 개발자 모드 → MCP 서버 URL 추가.

• 그 외의 것: OAuth 2.1(또는 액세스 키를 Bearer 토큰으로 전송)을 사용하는 표준 streamable HTTP MCP.

그런 다음 시도해 보세요: "연결을 확인하고 내 대기열을 나열해줘."

도구 상자 (25개 도구)

✏️ = 쓰기 도구. 모든 항목은 이름을 GUID로 자동 변환하므로 "Weekend Support 대기열"이 그대로 작동합니다.

플로우 빌더 작동 방식

1. build_flow는 명세(인사말 + DTMF 메뉴 + 대기열 전송)를 Archy YAML과 Mermaid 다이어그램으로 변환합니다. AI가 먼저 다이어그램을 보여줍니다.

2. publish_flow는 Architect 플로우 작업을 등록하고, YAML을 업로드한 후 폴링합니다. Genesys가 서버 측에서 검증 및 게시하며, 검증 오류는 그대로 반환됩니다.

3. render_flow는 조직에 이미 존재하는 플로우도 다이어그램으로 그리고, export_flow는 모든 플로우를 YAML로 다시 내보냅니다.

TTS는 플로우에 인라인으로 포함됩니다(조직의 TTS 엔진이 말합니다). 따라서 녹음하거나 업로드할 오디오 파일이 없습니다.

보안 모델

• Genesys 자격 증명은 당신의 Cloudflare 계정(Wrangler 시크릿 또는 자동 프로비저닝된 KV)에만 저장되며, 다른 곳에는 저장되지 않습니다.

• AI는 OAuth 클라이언트의 역할이 허용하는 작업만 수행할 수 있습니다. 사용자가 범위를 지정하고, Genesys가 이를 강제합니다.

• MCP 엔드포인트는 액세스 키(원시 Bearer 또는 커넥터용 내장 OAuth 2.1 흐름)가 필요합니다.

• 삭제 도구가 없으며, genesys_api_call은 DELETE를 완전히 거부합니다.

역할 범위 지정

여기의 모든 기능이 작동하려면 OAuth 클라이언트의 역할에 다음이 필요합니다: 라우팅(대기열, 스킬, Wrap-Up 코드) 보기 및 추가, 디렉토리 사용자 보기 및 편집(스킬 할당용), Architect 플로우 보기 및 추가 및 편집 및 게시, Telephony DID 보기. 샌드박스의 경우 Master Admin으로 충분하며, 프로덕션에서는 범위를 좁히세요. 서버는 할당된 역할만큼만 강력할 수 있습니다.

로컬 개발

git clone https://github.com/ryanshatz/genesys-mcp
cd genesys-mcp
cp .dev.vars.example .dev.vars   # or create it: GENESYS_CLIENT_ID / GENESYS_CLIENT_SECRET / GENESYS_REGION / MCP_AUTH_TOKEN
npm test                          # zero-dep unit tests (node --test)
npm run smoke                     # live read-tools smoke against your org
npm run smoke -- --writes         # also exercises create tools (MCP_Test_* artifacts)
npm run dev                       # wrangler dev

소개

Ryan Shatzkamer(outboundIQ 기술 서비스 디렉터)가 공개적으로 구축했으며, five9-mcp의 동일한 제로 디펜던시 아키텍처를 두 번째 플랫폼에 적용했습니다. 이슈 및 PR 환영합니다; 로드맵은 이슈 트래커에 있습니다.

MIT