Connect to MCP-Compatible Tools – Helpdesk

This article explains how to integrate Scanova with LLM-powered tools such as ChatGPT, LangChain, AutoGen, Cursor, Claude Desktop, and others using the Model Context Protocol (MCP).

Introduction

The Model Context Protocol (MCP) enables secure integration between a Scanova account and AI tools or development environments such as ChatGPT, LangChain, AutoGen, VS Code, Cursor, and Claude Desktop. Using MCP, users can generate, manage, and download QR Codes directly from MCP-compatible applications, reducing manual steps and enabling automation.

This integration is ideal for developers and technical teams working with large-scale or AI-driven QR Code workflows.

A. Generate an MCP token from Scanova

To securely link a Scanova account with an MCP-compatible tool, follow these steps:

Log in to the Scanova account
From the left sidebar, go to Integrations > Model Context Protocol (MCP)
Click on Setup
Click Generate Token

The generated token serves as an authorization credential for the MCP server. It should be stored securely and not shared publicly.

B. Configure the MCP client

Once the token is generated, it must be added to the configuration file of the MCP-compatible tool. Below are sample configurations for commonly used environments:

For Cursor (`~/.cursor/mcp.json`):

{
  "mcpServers": {
    "scanova-mcp": {
      "transport": "http",
      "url": "https://mcp.scanova.io/mcp",
      "headers": {
        "Authorization": "YOUR_SCANOVA_API_KEY_HERE"
      }
    }
  }
}

For VS Code (`~/.vscode/mcp.json`):

{
  "mcpServers": {
    "scanova-mcp": {
      "transport": "http",
      "url": "https://mcp.scanova.io/mcp",
      "headers": {
        "Authorization": "YOUR_SCANOVA_API_KEY_HERE"
      }
    }
  }
}

For Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json`):

{
  "mcpServers": {
    "scanova-mcp": {
      "transport": "http",
      "url": "https://mcp.scanova.io/mcp",
      "headers": {
        "Authorization": "YOUR_SCANOVA_API_KEY_HERE"
      }
    }
  }
}

Replace YOUR_SCANOVA_API_KEY_HERE with the token generated in Step A.

C. Supported tools and actions

The Scanova MCP server supports a range of actions that can be triggered using plain-text prompts or directly via supported MCP-compatible tools:

Tool	Description	Example Phrase
`create_qr_code`	Create a new QR Code	“create qr”, “make qr code”
`list_qr_codes`	List all QR Codes	“list qr codes”, “show qrs”
`update_qr_code`	Edit name or URL of a QR Code	“update qr”, “edit qr code”
`retrieve_qr_code`	Get QR Code details	“get qr details”, “qr info”
`download_qr_code`	Download QR Code image	“download qr”, “get qr image”
`activate_qr_code`	Reactivate a deactivated QR Code	“activate qr”
`deactivate_qr_code`	Deactivate a QR Code	“deactivate qr”

These tools use the Scanova API through the MCP layer to ensure a smooth and secure experience.

D. Public GitHub repository for Scanova MCP

Scanova provides an open-source MCP server that can be cloned, extended, or run locally for development purposes.

Visit: Scanova MCP on GitHub

The repository includes:

Installation steps
Docker deployment instructions
Local testing guidelines
Full list of supported tools and API endpoints

E. Troubleshooting

Issue	Suggested Action
“API key is required”	Ensure the token is correctly added under `Authorization` in the config file
“Invalid token” error	Regenerate the token from the Scanova dashboard
“Connection error”	Confirm the URL is correct and internet access is available
“Tool not found”	Restart the IDE and ensure the configuration is valid

The health of the MCP server can be checked by visiting: https://mcp.scanova.io/health

If further assistance is needed

For additional guidance or help with MCP setup, users can visit this knowledge base or reach out to the customer relations team at support@scanova.io .