MCP Server

Analytics Plus MCP Server

The Analytics MCP Server (Beta) implements the Model Context Protocol (MCP), a standardized interface that enables AI models to interact seamlessly with applications. This middleware solution bridges the connection between AI agents and Analytics Plus, providing powerful data analysis capabilities through a unified interface.

Key features

• Full access to Analytics plus workspaces via the Analytics Plus V2 API.

• External integration with Analytics Plus features

• Combination of AI knowledge with Analytics Plus advanced analytics

• Compatible with all MCP Hosts (including Claude Desktop, Cursor, and others)

• Comprehensive tools for Analytics Plus operations.

Note:

Analytics Plus MCP Servers consume API units based on the specific APIs used to generate responses.

The Analytics Plus MCP project is currently in its early development (beta) phase. As development progresses, the features and tools offered may be modified or updated to reflect continuous improvements.

Getting Started

1 . Docker Image Setup

• Pull from Docker repository

2. Configuring Environment Variables

3. Integrating with MCP Hosts

• Claude Desktop

• VSCode

• Cursor

Step 1: Docker Image Setup

System Requirements

To build the Analytics Plus MCP server from the repository, you need to have Docker installed on your system. Before setup, please make sure to have docker and a container runtime installed in your device.

Pull from Docker repository

You can configure the Docker image by this mentioned method. Use the pre-built image from a container registry (e.g., Docker Hub). The official pre-built Docker image is hosted on Docker Hub and it can be pulled directly:

Pull Docker Image

docker pull meanalyticsplus/mcp-server:latest

Step 2: Configuring Environment Variables

Obtaining OAuth Credentials

To configure the Analytics Plus MCP Server, you need to provide OAuth credentials (Client ID, Client Secret, and Refresh Token) as environment variables. Follow these steps to generate them:

1. Go to the Analytics Plus Developer Console

2. Create a new Self-Client application.

3. Enable the Analytics Plus API scope.

4. Generate your Refresh Token.

For detailed instructions, refer to the official API Authentication Documentation.

Required Environment Variables

Configure these essential variables before integrating with the MCP Hosts:

Other Environment Variables

The following is a list of other environment variables:

Step 3: Integrate with MCP Hosts

Analytics Plus MCP Server can be integrated with any MCP host. Below are some sample integrations that demonstrate how this can be done.

Claude Desktop Configuration

To configure the Analytics Plus MCP server with Claude Desktop, add the following configuration to your Claude settings:

1. Install Claude Desktop in your system.

2. Open the Claude Desktop application and navigate to Settings > Developer tab.

3. Click Edit Config to configure (claude_desktop_config.json) with your MCP server details.

Sample Config JSON

{
  "mcpServers": {
    "meanalyticsplusMCP": {
      "command": "docker",
      "args": [
        "run",
        "-e", "ANALYTICS_CLIENT_ID=<YOUR_ANALYTICS_CLIENT_ID>",
        "-e", "ANALYTICS_CLIENT_SECRET=<YOUR_ANALYTICS_CLIENT_SECRET>",
        "-e", "ANALYTICS_REFRESH_TOKEN=<YOUR_ANALYTICS_REFRESH_TOKEN>",
        "-e", "ANALYTICS_ORG_ID=<YOUR_ANALYTICS_ORG_ID>",
        "-e", "ANALYTICS_MCP_DATA_DIR=<YOUR_ANALYTICS_MCP_DATA_DIR>",
        "-e", "ACCOUNTS_SERVER_URL=<YOUR_ANALYTICS_ACCOUNTS_SERVER_URL>",
        "-e", "ANALYTICS_SERVER_URL=<YOUR_ANALYTICS_SERVER_URL>",
        "--network=host",
        "-i",
        "--rm",
        "-v", "<YOUR_ANALYTICS_MCP_DATA_DIR>:<YOUR_ANALYTICS_MCP_DATA_DIR>",
        "meanalyticsplus/mcp-server"
      ]
    }
  }
}

VSCode Configuration

To configure the Analytics Plus MCP server with Visual Studio Code:

1. Install the VSCode in your system.

2. Open the VSCode application and navigate to Settings.

3. In the Settings page, search for MCP configurations. Select the Edit in settings.json option to configure the MCP server.

Sample Config JSON

"mcp": {
  "servers": {
    "meanalyticsplus_mcp_server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-e", "ANALYTICS_CLIENT_ID=<YOUR_ANALYTICS_CLIENT_ID>",
        "-e", "ANALYTICS_CLIENT_SECRET=<YOUR_ANALYTICS_CLIENT_SECRET>",
        "-e", "ANALYTICS_REFRESH_TOKEN=<YOUR_ANALYTICS_REFRESH_TOKEN>",
        "-e", "ANALYTICS_ORG_ID=<YOUR_ANALYTICS_ORG_ID>",
        "-e", "ANALYTICS_MCP_DATA_DIR=<YOUR_LOCAL_DATA_DIR>",
        "-e", "ACCOUNTS_SERVER_URL=<YOUR_ANALYTICS_ACCOUNTS_SERVER_URL>",
        "-e", "ANALYTICS_SERVER_URL=<YOUR_ANALYTICS_SERVER_URL>",
        "--network=host",
        "-i",
        "--rm",
        "-v", "<YOUR_LOCAL_DATA_DIR>:<YOUR_LOCAL_DATA_DIR>",
        "meanalyticsplus/mcp-server"
      ]
    }
  }
}

Cursor Configuration

To configure the Analytics Plus MCP server with Cursor:

1. Install the Cursor in your system.

2. Open the Cursor application and navigate to Settings > Tools and Integrations.

3. Click the Add Custom MCP menu to enter your server configuration details, and Save.

Sample Config JSON

{
  "mcpServers": {
    "meanalyticsplusMCP": {
      "command": "docker",
      "args": [
        "run",
        "-e", "ANALYTICS_CLIENT_ID=<YOUR_ANALYTICS_CLIENT_ID>",
        "-e", "ANALYTICS_CLIENT_SECRET=<YOUR_ANALYTICS_CLIENT_SECRET>",
        "-e", "ANALYTICS_REFRESH_TOKEN=<YOUR_ANALYTICS_REFRESH_TOKEN>",
        "-e", "ANALYTICS_ORG_ID=<YOUR_ANALYTICS_ORG_ID>",
        "-e", "ANALYTICS_MCP_DATA_DIR=<YOUR_ANALYTICS_MCP_DATA_DIR>",
        "-e", "ACCOUNTS_SERVER_URL=<YOUR_ANALYTICS_ACCOUNTS_SERVER_URL>",
        "-e", "ANALYTICS_SERVER_URL=<YOUR_ANALYTICS_SERVER_URL>",
        "--network=host",
        "-i",
        "--rm",
        "-v", "<YOUR_ANALYTICS_MCP_DATA_DIR>:<YOUR_ANALYTICS_MCP_DATA_DIR>",
        "meanalyticsplus/mcp-server"
      ]
    }
  }
}

Tools in Analytics Plus MCP Server

The Analytics Plus MCP server provides various tools for interacting with Analytics Plus.

Troubleshooting

For common issues:

1. Authentication Problems:

• Verify all OAuth credentials

• Ensure tokens have proper permissions

• Check token expiration status

2. Connection Issues:

• Confirm the Docker container is running

• Validate network connectivity

• Check firewall settings

3. Data Center Configuration Errors:

• Ensure the ACCOUNTS_SERVER_URL and ANALYTICS_SERVER_URL in your configuration are correct and matches your organization's designated data center (DC) location.

• Please refer to the API Specification document for more details.

4. File System Problems:

• Confirm the data directory exists

• Check directory permissions

• Verify sufficient disk space

Help & Support

We offer 24x5 technical support (Monday to Friday). In case if you need our assistance kindly do mail us your questions to analyticsplus-support@manageengine.com

You can also reach out to us on our toll-free numbers.
US : (+1) 469 501 6108
UK : (+44) 207 660 2649
AUS : (+61) 892 100 050
India: +91-44-69656217