Scanova

You can create, manage, and download QR codes through a Model Context Protocol (MCP) server that bridges the Scanova API with MCP-compatible IDEs. This server lets you generate dynamic QR codes, view and modify them, obtain details, and download images directly from your editor.

How to use

Use a compatible MCP client to interact with the Scanova MCP server. You can create new QR codes, list existing ones, update their URLs or names, retrieve detailed information, download QR code images in various formats, and activate or deactivate codes. Each action maps to a dedicated tool you can invoke from your editor’s MCP interface.

Set up the MCP connection in your editor and start issuing commands to the server. The server’s HTTP endpoint is designed to be called from your MCP client, and your API key is supplied in the request headers to authorize actions with the Scanova service.

How to install

Prerequisites: you need a Scanova API key and an MCP-compatible IDE such as Cursor, VS Code, or Claude Desktop.

Follow these concrete steps to configure your editor and start using the MCP server.

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

Additional configuration and troubleshooting

Configure your MCP client in your editor of choice using the HTTP transport and the MCP URL shown above. Replace YOUR_SCANOVA_API_KEY_HERE with your actual Scanova API key. If you encounter issues, verify that the API key is correct and that the server URL is reachable.

Common issues and tips:

• API key is required: ensure the Authorization header contains your Scanova API key.
• Invalid token: regenerate the API key if needed and update the header.
• Connection errors: confirm the server URL is correct and the editor can reach the MCP endpoint.
• Tool not found: restart the editor after adding the MCP configuration and ensure the MCP config is valid.

Usage notes

All operations must be performed through the MCP client in your editor. The server exposes endpoints to create, list, update, retrieve, download, activate, and deactivate QR codes via the MCP interface, translating your commands into actions on the Scanova API.

Available tools

create_qr_code

Create a new QR code with a dynamic URL and optional metadata.

list_qr_codes

List existing QR codes with pagination to browse your collection.

update_qr_code

Modify properties of an existing QR code, such as its URL or name.

retrieve_qr_code

Fetch detailed information for a specific QR code.

download_qr_code

Download the QR code image in supported formats.

activate_qr_code

Activate a QR code to make it active and usable.

deactivate_qr_code

Deactivate a QR code to temporarily disable it.