Start Free trial

Articles in this section

Configure a Custom VWO Connector in Claude

Jash Unadkat
  • Updated
Share:
Follow
close this to read article
Feature availability: This feature is available only with the Enterprise plan or on accounts where the Developer Plus add-on is enabled.

This article covers the following:

Overview

VWO provides a Model Context Protocol (MCP) server that enables Claude to interact with your VWO data via a connector. A connector acts as a secure digital bridge between a Large Language Model like Claude and an external platform like VWO.  

By configuring a custom VWO connector in Claude, you can ask Claude questions about your campaigns, retrieve heatmaps, analyze session recordings, and generate reports using natural language. This integration bridges the gap between AI-driven insights and your experimentation data, allowing for faster analysis and decision-making.

For example, instead of manually navigating through multiple reports to compare campaign performance, you can ask Claude, Which of my active VWO campaigns has the highest conversion rate this week? Claude uses the VWO connector to fetch real-time data from your VWO account and provides a concise summary.

Prerequisites

  • You must have a Claude account (Free, Pro, or Team).
  • You must have a VWO account with an active API token.
  • You must have the Admin role in VWO to generate the API tokens.

Connect the VWO MCP Server with Claude

Follow these steps to integrate the VWO MCP server with your Claude account:

Step 1: Locate your MCP Server URL

First, you need the MCP URL that connects Claude to your VWO account data. To locate your MCP server URL:

  1. Log in to your VWO account.
  2. Scroll down to the bottom of the dashboard and click Developer resources.
    Developer Resources.png
  3. Go to the VWO MCP Server tab.
  4. Under the Claude (web and desktop) tab, you will find the MCP server URL required for the integration.
    API Token.png

Step 2: Generate your VWO Developer API Token

The MCP server URL contains a placeholder, DEV_API_TOKEN. You must replace this placeholder with your personal Developer API token. This token securely authenticates your requests.

To create your personal Developer API token:

  1. On the Developer Dashboard, go to the Tokens tab.
  2. Click Add another API token.
  3. Enter the Token Name.
    permissions.png

  4. From the Select Permission dropdown, select the permission type as per your requirement, for example, Browse. 

    Your end users can manage VWO data in Claude based on the permissions assigned to the token. You can select from the following permissions to manage how end users interact with VWO data through the MCP server.

Permission Description
Browse

Grants read-only access to VWO data for Session Recordings, Heatmaps, Split URL, Multivariate, and A/B tests.

Users with this permission cannot perform any edit operations.
Design Enables users to create new A/B or Split URL tests via the MCP.
Publish/Admin Provides full control to create, edit, start, pause, or delete A/B tests and Split URL tests.
  1. After selecting the permission, click Generate. Once you click Generate, a token appears. Use this newly generated token in the DEV_API_TOKEN placeholder in the MCP server URL to form the complete URL, which you can configure in Claude.
Tip: Your Developer API token provides access to your VWO data. Treat it like a password and do not share it publicly.

After replacing the placeholder in the MCP URL with your API token, your MCP URL is complete and ready. You can now use it to set up a custom connector in Claude.

Let us understand how you can configure a custom VWO connector in Claude.

Step 3: Configure the Custom VWO Connector in Claude

Note: Use the official Claude website to follow the steps below.

To add VWO as a custom connector within Claude:

  1. Log in to your Claude account and navigate to your profile from the bottom-left corner.
  2. Select Settings > Connectors.
  3. Click Add custom connector.
  4. In the Name field, enter the name of the connector.
  5. In the Remote MCP server URL field, paste the VWO MCP URL provided in your VWO dashboard. The URL typically follows this format: https://mcp.vwo.io/mcp?key=YOUR_API_TOKEN.
    Note: Ensure you replace YOUR_DEV_API_TOKEN with the actual token you generated in Step 2.
    mcp server url.png
  6. Click Add. Your MCP URL gets validated. Upon successful validation, your VWO connector will be ready for use in the Claude interface. 

Step 4: Configure Tool Permissions for the Connector

After adding the connector, you must specify which VWO tools Claude is allowed to access. To configure the tool permissions for your connector:

  1. In your Claude account, navigate to your profile from the bottom-left corner.
  2. Select Settings > Connectors.
  3. Locate the VWO connector in your list of connectors, then click Configure.
  4. Under Read-only tools, toggle on the specific capabilities you want Claude to have, such as:
  • Get VWO Campaign Report
  • Analyze VWO Heatmap Data
  • Analyze VWO Recording Data
    tool permissions.png
  1. If you want Claude to be able to create or update items, enable the relevant options under Write/delete tools.
  2. For each tool, select the approval requirement, for example, Always allow, Needs approval, or Blocked. 

Once configured, Claude will interact with your VWO account according to the permissions you’ve defined, ensuring secure, controlled access to your data.

Step 5: Enable the Connector Before Querying VWO Data

Once the VWO connector is configured, you must enable it in a chat session before asking campaign-related queries. To activate the connector:

  1. From the main navigation panel on the left, click +New chat. 
  2. In the text input field, click +, then select Connectors.
  3. Toggle on the VWO connector.
    enable connector.png
  4. Start asking your questions in the chat. To answer your questions, Claude calls the VWO MCP server to fetch the relevant data.

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 5 days). 

Troubleshooting

Issue Possible Cause Recommended Solution
Claude cannot find any VWO data. The API token has expired or was deleted. Generate a new token in VWO and update the connector URL in Claude.
The Add custom connector button is missing. You are on a Free Claude plan and may already have configured a connector. The Free plan allows configuring only one custom connector If you are using a Free plan and you already have a connector configured, uninstall the previous connector. Alternatively, consider upgrading your plan.
Claude can not pause or start campaigns. It indicates the following:

Pausing campaigns requires a write/update action, which isn't supported by the connected VWO tools at this time. 		Claude is not allowed access to the Write/delete tools. In your Claude account, go to Settings > Connectors > VWO > Configure and select the Always allow option for the respective tools that allow you to perform campaign operations, such as start, pause, or delete.

FAQs

  • Can I add multiple VWO accounts to Claude? 
    Yes, you can connect multiple VWO accounts by creating separate custom connectors, each configured with a unique name and API token for the respective account.
     
  • What happens if I delete the API token in VWO? 
    The connection will break immediately, and Claude will no longer be able to fetch data until a valid token is reconfigured.

Need more help?

For further assistance, contact VWO Support.

 

Was this article helpful?

Return to top