|
This article covers the following: |
Overview
The VWO Model Context Protocol (MCP) server is a secure connection layer that enables external AI tools, such as ChatGPT, n8n, or other automation systems, to connect with your VWO account. It allows these tools to directly access and analyze your live VWO campaign data and insights using simple natural-language queries. Think of it as a secure digital bridge that turns VWO data into an AI-native app, eliminating the need to manually export reports and copy/paste data for external analysis or workflow automation.
Integrating third-party AI tools like ChatGPT with the VWO MCP server offers the following benefits:
- Instant, on-demand insights: You get data-backed answers for any questions around your campaign in seconds. This prevents you from navigating through multiple screens or exporting CSVs.
- Effortless data analysis: Use natural language to ask complex questions about your experiments and user behavior.
- Automated workflows: Connect VWO to automation platforms (such as n8n or Zapier) to create powerful, cross-platform workflows, including automated weekly reports sent directly to Slack.
- Deep integration: Allow your AI assistant to fetch and segment all the data available in your VWO account.
Let us understand the use of the VWO MCP server better with a few use cases:
-
For the Product Marketer: Instantly identify campaigns that are not producing a clear winner. Ask, Tell me about the campaigns that do not have a winner in the last 3 months? to get a complete list and start optimizing.
-
For the Conversion Rate Optimization (CRO) Experts: Get a comprehensive behavioral summary for a key page. Ask, Can you access my heatmap for vwo.com/pricing and give me insights? to receive key takeaways, frustration indicators, and even visual heatmap previews.
- For the Data Analysts: Quickly drill down into user session recordings for deeper context. Ask follow-up questions like, What about session recordings for the same timeframe and page? to get a summarized breakdown of user interactions, device splits, and top regions.
This article further explains how you can connect the VWO MCP server with third-party AI tools.
In this article, we will use ChatGPT as an example.
Connect VWO MCP Server with ChatGPT
Prerequisites:
- You must have a VWO Enterprise plan.
- You must have an OpenAI ChatGPT account with Pro or Plus subscription.
- You must have permission to generate a Developer API token within your VWO account.
Follow the steps below to integrate the VWO MCP server with your ChatGPT account:
Step 1: Locate your MCP Server URL
First, you need the MCP URL that connects ChatGPT to your VWO account data.
- Log in to your VWO account.
- Scroll down to the bottom of the dashboard and click Developer resources.
- Go to the VWO MCP Server tab. Here you will find the MCP server URL required for the integration.
Step 2: Generate your VWO Developer API Token
The MCP server URL contains a placeholder, DEV_API_TOKEN. Replace this with your personal Developer API token. This token securely authenticates your requests.
To create your personal developer API token:
- On the Developer Dashboard, go to the Tokens tab.
- Click Add another API token.
- Enter the token name, select the permission type as Browse, and click Generate.
The Browse permission ensures that your token is allowed to access and view resources on the server. Without this permission, the server will be unable to return any data, and your request may fail or result in an empty response.
Once you click Generate, a token appears. Use this newly generated token in the DEV_API_TOKEN placeholder of the MCP server URL.
Step 3: Configure the Custom VWO Connector in ChatGPT
To add VWO as a custom connector within ChatGPT:
- Log in to your ChatGPT account.
- Go to Settings > Apps & Connectors > Advanced settings > Developer mode.
- Toggle on the Developer mode. This allows you to add and configure custom connectors.
- Navigate back to Apps & Connectors and click Create to create a new custom connector.
- Enter the following configuration details for the VWO connector:
- Name: Enter a name that helps you recognize the connector (VWO in this case).
- Description: Provide a short description that describes the capabilities of the connector.
-
MCP server URL: Enter the following MCP server URL: https://mcp.vwo.io/mcp?key=YOUR_DEV_API_TOKEN
Note: Ensure you replace YOUR_DEV_API_TOKEN with the actual token you generated in Step 2. - Authentication: Select No authentication from the dropdown, as additional authentication is not required.
- Select the I understand and want to continue checkbox.
- Click Create.
After you click Create, the MCP URL gets validated. Upon successful validation, your VWO connector will be ready for use.
Step 4: Query Your VWO Data Using Natural Language
Once the VWO connector is configured, activate it before asking campaign-related queries. To activate the connector:
- On your ChatGPT account dashboard, navigate to the Ask anything field and click +.
- Go to More and select VWO. This activates the VWO connector.
- Start asking your questions in natural language. To answer your questions, ChatGPT calls the VWO MCP server to fetch the relevant data.
If the query is successful, the system displays a Calling tool message in the ChatGPT interface before the results appear. This indicates that the connector is working successfully.
For best results, make your questions as specific as possible. Include campaign names, page URLs, and date ranges (for example, share the progress of campaigns that were published in the last 7 days).
Troubleshooting
Issue |
Possible Cause |
Recommended Solution |
| Error with connection or invalid token. | Incorrect Developer API token, a revoked token, or an incorrect MCP server URL. |
If ChatGPT cannot connect to VWO, double-check that you have correctly copied and pasted your Developer API token into the server URL. Ensure the token is active and has not been revoked. |
FAQs
-
What is the difference between the VWO MCP Server and VWO Copilot?
The VWO MCP server is a headless backend system that enables external tools, such as ChatGPT, to connect to your VWO data. VWO Copilot is a self-contained, in-app assistant that helps you with tasks inside the VWO platform.
-
Can I use the MCP Server to create a new test or pause a campaign?
No. The current version of the VWO MCP server is read-only. It can fetch and analyze data, but it cannot perform Write actions back into your VWO account.
Need more help?
For further assistance or more information, contact VWO Support.