Conviva Connect MCP

 

MCP is a common standard for Agents to interact with remote data sets. Conviva's MCP implementation builds on existing Conviva APIs, across VSI and DPI, which deliver time series, per-session, per-viewer, real-time and historical aggregated data. Through MCP, AI Agents can discover, query, and consume Conviva datasets dynamically. Agents can be built quickly using natural language queries, with insight inferred from the data automatically.

Note: This guide uses Claude Desktop to emulate an MCP Agent running locally within an organization. Conviva also supports using other Large Language Models (LLMs) and LLM clients, such as ChatGPT, that support the MCP Interface.

Conviva MCP Servers

Conviva MCP servers provide access to Conviva VSI and Conviva DPI data sources with endpoints for application metrics, AI alerts, and streaming sessions.

Prerequisites

• Anthropic Claude Desktop app (or LLM with MCP Agent support)
  Contact Conviva Support for accessing Conviva’s team plan.

• Node.js

  In the terminal prompt, enter npm -v to confirm whether Node.js is installed. If Node.js is not installed, 'Command not found' is displayed.

  To install Node.js, go to Download Node.js® and copy the install commands into your terminal.

Getting Started

1. Open the pre-installed Claude desktop app and click Settings at the bottom left corner.

   

2. Select Developer and click Edit Config to edit the config file.

   

   This opens the Claude Settings directory in Finder.
   

3. Add the Conviva settings to the claude_desktop_config.json file:

   1. Open the claude_desktop_config.json file using a text editor.

   2. For OAuth authenication to enable Okta SSO access, enter the Conviva MCP servers data.

      Copy

      {
        "mcpServers": {
          "conviva-vsi-metrics": {
            "command": "npx",
            "args": [
              "mcp-remote",
              "https://mcp.conviva.com/vsi/metrics"
            ]
          }
          "conviva-vsi-ai-alerts": {
            "command": "npx",
            "args": [
              "mcp-remote",
              "https://mcp.conviva.com/vsi/ai-alerts"
            ]
          }
          "conviva-vsi-sessions": {
            "command": "npx",
            "args": [
              "mcp-remote",
              "https://mcp.conviva.com/vsi/sessions"
            ]
          }
          "conviva-dpi-metrics": {
            "command": "npx",
            "args": [
              "mcp-remote",
              "https://mcp.conviva.com/dpi/metrics"
            ]
          }
        }
      }

   3. For API credential access, replace the AUTH_HEADER string with the Base64-encoded API credential of the desired Conviva c3 account.

      If needed, create API credentials using the Pulse API Management page. It must begin with Basic, as the Conviva API system only supports HTTP basic access authentication.

      Note: To encode API credentials to Base64 format, enter the prompt in the command line:
      echo -n "{client_id}:{client_secret}" | base64
      (replace {client_id} and {client_secret} with the API credentials of the c3 account)

      Copy

      {
        "mcpServers": {
          "conviva-vsi-ai-alerts": {
            "command": "npx",
            "args": [
              "mcp-remote",
              "https://mcp.conviva.com/vsi/ai-alerts",
              "--header",
              "Authorization:${AUTH_HEADER}"
            ],
            "env": {
              "AUTH_HEADER": "Basic NnhXa"
            }
          },
          "conviva-vsi-metrics": {
            "command": "npx",
            "args": [
              "mcp-remote",
              "https://mcp.conviva.com/vsi/metrics",
              "--header",
              "Authorization:${AUTH_HEADER}"
            ],
            "env": {
              "AUTH_HEADER": "Basic R2Z5clF2"
            }
          },
          "conviva-vsi-sessions": {
            "command": "npx",
            "args": [
              "mcp-remote",
              "https://mcp.conviva.com/vsi/sessions",
              "--header",
              "Authorization:${AUTH_HEADER}"
            ],
            "env": {
              "AUTH_HEADER": "Basic WW5xeEt"
            }
          },
          "conviva-dpi-metrics": {
            "command": "npx",
            "args": [
              "mcp-remote",
              "https://mcp.conviva.com/dpi/metrics",
              "--header",
              "Authorization:${AUTH_HEADER}"
            ],
            "env": {
              "AUTH_HEADER": "Basic pXRnJRM2"
            }
          }
        }
      }

      For more details about mcp-remote, see npm: mcp-remote.

4. In the command line, enter cmd + q to completely quit and restart Claude.

   For OAuth authentication, thel browser displays the Conviva authentication page (https://auth.conviva.com/). Enter your email, and your company’s Okta domain login page appears. After a successful login, the browser shows a message Authorization successful message. Close this window and return to the CLI.

   Note: Claude needs a complete restart to apply the configuration changes.

5. Conviva MCPs appear in Claude to enable/disable the desired MCP servers. Each MCP server has tools, such as, Get and List actions for Conviva VSI AI alerts.

   

6. Enter a prompt for Conviva data.

   Copy

   get me a summary of my content ai alerts of the last 14 days

    

 

Conviva Connect MCP Claude Conviva Connect MCP Claude Conviva MCP