Getting Started
Webex Contact Center MCP Server Beta
Use this guide to test the Webex Contact Center MCP Server with a supported MCP client during the Webex Developer Beta. For the complete tool reference, see Contact Center MCP Server.
anchorBefore you begin
anchor- Ask an organization administrator to enable Contact Center MCP in Control Hub > Apps > Agentic Apps.
- On the app's General tab, confirm the organization policy allows the app. On the Tools tab, enable the tools you will test; tools are enabled individually.
- Use a supported MCP client. See the Webex MCP Server Usage Guide for supported clients and setup steps.
- Confirm that your user can access the target Webex Contact Center organization and has the permissions required by the tools you will test. Admin configuration tests require an appropriate Contact Center administrator role.
anchor1. Select the server and connect
anchor- Sign in to the Webex Developer Portal, then open the Contact Center MCP Server page.
- Copy the regional server URL shown for your tenant. There is no global server URL.
- Add the server to your MCP client.
- Connect with OAuth 2.0, or use a WCIT token from the Webex agentic token page. With OAuth, approve only the scopes required for the tools you are testing.
- Confirm that the client reports the server as connected.
anchor2. Run read-only checks first
anchorRun these checks before any write operation:
wxcc-list-flows— confirm that authorized flows or subflows can be listed or searched.wxcc-get-flow— retrieve a draft, latest version, or specific flow version.wxcc-view-config— read an authorized configuration resource such as an entry point, team, dial plan, or contact service queue.wxcc-get-activity-definitionsandwxcc-describe-activity— retrieve activity schemas before authoring a flow.wxcc-get-choices— resolve organization-specific values instead of guessing IDs.
The expected result is tenant-scoped data for authorized resources only. Stop and report an authorization or data-boundary failure before continuing.
anchor3. Test Flow Designer writes safely
anchor- Use
wxcc-get-flow-templateto retrieve a starter FlowV2 template. - Use
wxcc-create-flowto create an unpublished draft namedMCP_TEST_<date>. - Use
wxcc-save-flow-draftorwxcc-patch-flow-draftto make a small change. - Use
wxcc-validate-flowand confirm validation succeeds before any publish or production action.
Keep the test flow unpublished and do not bind it to a production entry point. Record its name and ID for administrator cleanup.
anchor4. Test Contact Center configuration writes
anchorUse wxcc-admin-config only with safe test resources such as a test entry point, business hours, dial plan, or dial number. Verify create, update, and delete behavior with a user who has write permission, and verify that an unauthorized user receives a clear failure. Delete each test resource after validation.
anchor5. Test real-time subscriptions
anchor- Use
wxcc-realtimeto discover supported event types. - Use
wxcc-realtimeto list existing webhook subscriptions. - Use
wxcc-realtimeto create and update a test webhook subscription. - Use
wxcc-realtimeto provision a WebSocket session when the client supports it and confirm the response includes awebSocketUrlandsubscriptionId. - Use
wxcc-realtimeto delete the test webhook subscription after validation.
anchor6. Test historical analytics
anchor- Run
wxcc-copilot-run-search-queryover a small time range. - Compare CSR, ASR, or CLR results with the Contact Center reporting or analytics UI.
- Confirm that the response contains only data authorized for the target organization.
anchorCleanup and rollback
anchor- Do not publish or production-bind the
MCP_TEST_<date>flow draft. - Delete test entry points, business hours, dial plans, dial numbers, and webhook subscriptions after validation.
- If a test produces an unexpected write or exposes data outside the target organization, stop testing and report the flow or resource ID, tool name, and error without sharing tokens or customer data.