genesys-mcp

당신의 Genesys Cloud 조직이 AI의 손안에 있습니다. Cloudflare Worke 위에서 동작하는 MCP (MCP)입니다. 의존성 제로, 익미널에 동작합니다. Meanwhile 이 serve의 존재는 그 목적은 생것입니다: 큐, 스킬, 사자, 랍업 코드, Architect 플로우까지.

읽기만 하고, 만든다.

Claude(또는 아무 MCP 클라이언트)에게 이렇게 지시해 보세요:

• "Weekend Support"라는 큐를 만들어 줘"

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

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

• "온보딩 준비: 스페인어 스킬을 만들고 Jess에게 숙련도 4로 배정해 줘"

플로우 빌더는 실제 Archy YAML을 조립하고, 그 플로우를 채팅서 Mermaid 다이어그램으로 보여준 후, Genesys 자체의 flow-jobs 파이프라인(CX as Code가 쓰는 것과 동아한 것)을 통해 게시합니다. 그래서 Genesys가 서버 측에서 검증과 게시를 모두 수행합니다.

의도적으로 하지 않는 것

• 분석이나 KPI 도구는 없습니다. 그 영역은 이미 준가 했습니다. 대화를 MCP로 분석하고 싶다면 MakingChatbots' genesys-cloud-mcp-server를 확인해 보세요.

• 연락처 목록 관리 기능은 없습니다.

• 삭제 기능은 없습니다. 삭재 도구도 없고, 로우(raw) API 도구도 DELETE를 거부합니다. 설계상 "만들기 우선"입니다.

Related MCP server: Salesforce MCP Server

3단계로 직접 배포하기

1. 배포: 버튼을 누룽니다(무료 Cloudflare 계정), 또는 git clone + npx wrangler deploy를 실행합니다. CONFIG KV 네임스페이스는 자동으로 만들어집니다.

2. Genesys OAuth 클라이언트 생성: Admin → Integrations → OAuth → Add Client → grant type은 Client Credentials → 역할을 할당합니다(역할 범위 지정 참조) → 저장.

3. 설정: 새 Worker에서 /setup 페이지를 열고 Client ID, Secret, 리전을 붙여넣습니다. 마법사가 저장 전에 Genesys에 대해 실시간으로 검증한 뒤, 액세스 키(한 번만 표시)를 건네줍니다.

터미널에서 설정을 관리하고 싶다면 대신 Wrangler secrets를 설정하세요. 마법사 설정보다 우선합니다: GENESYS_CLIENT_ID, GENESYS_CLIENT_SECRET, GENESYS_REGION(예: usw2.pure.cloud), MCP_AUTH_TOKEN.

AI와 연결하기

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

• Claude (웹/데스크톱): Settings → Connectors → Add custom connector → URL을 붙여넣습니다. 인증 화면이 나타나면 액세스 키를 붙여넣습니다.

• Claude Code: claude mcp add --transport http genesys https://<your-worker>/mcp 를 실행하고, 요청이 뜨면 인증합니다.

• ChatGPT: Settings → Connectors → Advanced → Developer mode → MCP server URL을 추가합니다.

• 그 외 다른 것들: 표준 streamable HTTP MCP with OAuth 2.1, 또는 함께하는 접근 하려는 키를 Bearer 토큰으로 전송.

이렇게 해보세요: "연결을 확인하고 내 큐와 목록을 보여 줘."

도구 상자 (28개 도구)

✏️ = 쓰기 도구. 모든 이름은 자동으로 GUID로 변환되므로, "Weekend Support 큐"라고만 해도 통합니다.

플로우가 어떻게 만들어지나요

1. build_flow는 스펙을 실제 Archy YAML 및 Mermaid 다이어그램으로 만듭니다: TTS 인사말, 선택적 영업시간 게이트 (영업 중이면 메뉴로, 종료·휴일에는 안내 후 종료 또는 보이스메일로 연결), 그리고 DTMF 메뉴. 선택지로는 큐로 전환, 큐 보이스메일, 외부 전화 걸기, 통화 종료가 가능합니다. AI가 먼저 다이어그램을 보여줍니다.

2. publish_flow는 Architect flow 잡을 등록해 YAML을 업로드하고 폴링합니다. Genesys가 서버 측에서 검증·게시하며, 검증 오류는 그대로 반환됩니다.

3. render_flow는 이미 존재하는 플로우도 다이어그램으로 만들어 주고, export_flow는 아무 플로우나 YAML로 다시 뽑아냅니다.

TTS는 플로우 내부에 인라인으로 들어가므로(조직 TTS 엔진이 발화), 녹음이나 업로드용 오디오 파일이 없습니다.

보안 모델

• Genesys 자격 증명은 당신의 Cloudflare 계정(Wrangler secrets 및 자동 프로비저닝된 KV)에만 존재하며, 그 외 어디에도 저장되지 않습니다.

• AI가 할 수 있는 것은 OAuth 클라이언트의 역할이 허용하는 범위뿐입니다. 역할 범위는 사용자가 정하고, Genesys가 강제합니다.

• MCP 엔드포인트는 액세스 키(또는 Bearer 토큰, 내장 OAuth 2.1 흐름)를 요구합니다.

• 삭제 도구는 존재하지 않으며, genesys_api_call은 DELETE를 원천적으로 거부합니다.

역할 범위 지정

여기에서 권장하는 것은: OAuth 클라이언트 역할에 Routing (큐, 스킬, 랩업 코드) 조회+추가, Directory 사용자 조회+수정(스킬 배정용), Architect 플로우 조회+추가+수정+게시, 리합회 Telephony DID 조회 권한이 있어야 합니다. Master Admin 계정은 sandbox에만 쓰세요. 프로덕션에서는 역할 범위를 최소화로 잡으세요. 서버는 여러분이 부여한 역할 이상의 권한을 가질 수 없습니다.

로컬 개발

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