MCP Server — Use QRcodly with AI

Use AI assistants to create and manage QR codes — just by chatting. The QRcodly MCP server lets tools like Claude, ChatGPT, Cursor, and VS Code Copilot work directly with your QRcodly account.

Example: Simply tell your AI assistant "Create a QR code for my website https://example.com" and it will do the rest.

What is MCP?

MCP (Model Context Protocol) is an open standard that lets AI assistants connect to external services. Think of it as a bridge between your AI tool and QRcodly. Once connected, the AI can:

• Create QR codes (URLs, WiFi, vCards, events, and more)
• List and search your existing QR codes
• Update or delete QR codes
• Manage short URLs, tags, and design templates
• View analytics for your short URLs

Before You Start

You'll need:

1. A QRcodly account — Sign up for free
2. An API key from your QRcodly dashboard
3. One of the supported AI tools (see setup guides below)

Step 1: Get Your API Key

1. Log in to your QRcodly account
2. Go to Settings → API Keys in the dashboard
3. Click Create API Key
4. Give it a name (e.g., "Claude Desktop") and click Create
5. Copy the key — you'll need it in the next step

Step 2: Connect Your AI Tool

Choose your AI tool below and follow the instructions.

Claude Code (CLI)

Run this command in your terminal (replace YOUR_API_KEY with your actual key):

claude mcp add qrcodly --transport http https://mcp.qrcodly.de/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

That's it! You can now ask Claude Code to manage your QR codes.

Claude Desktop

1. Open the Claude Desktop app
2. Go to Settings → Developer → Edit Config
3. Add the following to your configuration file:

{
	"mcpServers": {
		"qrcodly": {
			"command": "npx",
			"args": [
				"-y",
				"mcp-remote",
				"https://mcp.qrcodly.de/mcp",
				"--header",
				"Authorization:Bearer YOUR_API_KEY"
			]
		}
	}
}

4. Replace YOUR_API_KEY with your actual API key
5. Save the file and restart Claude Desktop

Cursor

1. Open Cursor
2. Go to Settings → MCP Servers
3. Click Add Server and enter:
   • Name: qrcodly
   • URL: https://mcp.qrcodly.de/mcp
4. Add a custom header:
   • Key: Authorization
   • Value: Bearer YOUR_API_KEY
5. Click Save

Or add it manually to your .cursor/mcp.json:

{
	"mcpServers": {
		"qrcodly": {
			"url": "https://mcp.qrcodly.de/mcp",
			"headers": {
				"Authorization": "Bearer YOUR_API_KEY"
			}
		}
	}
}

VS Code (GitHub Copilot)

1. Open VS Code
2. Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
3. Search for "MCP: Add Server"
4. Enter the URL: https://mcp.qrcodly.de/mcp
5. When prompted for headers, add: Authorization: Bearer YOUR_API_KEY

Or add it to your VS Code settings.json:

{
	"mcp": {
		"servers": {
			"qrcodly": {
				"url": "https://mcp.qrcodly.de/mcp",
				"headers": {
					"Authorization": "Bearer YOUR_API_KEY"
				}
			}
		}
	}
}

ChatGPT / OpenAI

If you're using the OpenAI Agents SDK, configure the MCP server like this:

from agents import Agent
from agents.mcp import MCPServerStreamableHttp

mcp_server = MCPServerStreamableHttp(
    url="https://mcp.qrcodly.de/mcp",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)

agent = Agent(
    name="qr-assistant",
    instructions="You help users create and manage QR codes.",
    mcp_servers=[mcp_server]
)

Windsurf

Add to your Windsurf MCP configuration:

{
	"mcpServers": {
		"qrcodly": {
			"serverUrl": "https://mcp.qrcodly.de/mcp",
			"headers": {
				"Authorization": "Bearer YOUR_API_KEY"
			}
		}
	}
}

What You Can Do

Once connected, try asking your AI assistant things like:

Create QR Codes

"Create a QR code for https://example.com"

"Create a QR code for https://example.com using my 'Corporate' template"

"Create a WiFi QR code for my network. SSID: MyWifi, Password: secret123, Encryption: WPA"

"Create a vCard QR code for John Doe, email [email protected], phone +49123456789"

"Create an event QR code for our team meeting on June 15th at 2pm"

"Create a QR code for my LinkedIn profile using the 'Blue Gradient' template"

Manage QR Codes

"List all my QR codes"

"Show me the details of my latest QR code"

"Update the URL of QR code 'My Website' to https://new-url.com"

"Delete the QR code named 'Test'"

Use Templates

"Show me my saved templates"

"Create a QR code for https://example.com using my 'Corporate' template"

"Create a WiFi QR code with the 'Dark Mode' template. SSID: Office, Password: welcome123"

"Create 3 QR codes for different URLs, all using my 'Brand' template"

When you mention a template name, the AI looks up your templates and applies the saved design — including colors, shapes, and logo — automatically.

Short URLs & Analytics

"List my short URLs"

"Show analytics for my short URL 'abc123'"

"Create a short URL for https://example.com/very-long-path"

Tags

"Show all my tags"

"Create a tag called 'Marketing' with color red"

"Tag my QR code 'Website' with the 'Marketing' tag"

Available Tools

The MCP server provides 31 tools in total:

Supported QR Code Types

Troubleshooting

"Invalid or expired API key"

• Check that you copied the full API key (starts with ak_)
• Make sure there are no extra spaces
• Verify the key is still active in your QRcodly dashboard

"Connection refused" or "Server not responding"

• Check your internet connection
• The MCP server URL must be exactly: https://mcp.qrcodly.de/mcp
• If the issue persists, try again in a few minutes

AI tool doesn't show QRcodly tools

• Restart your AI tool after adding the MCP server configuration
• Check the configuration file for JSON syntax errors
• Verify the API key is correctly set in the Authorization header

"Rate limit exceeded"

• The API has rate limits to prevent abuse
• Wait a moment and try again
• If you consistently hit limits, contact support

Need Help?

If you're having trouble connecting, contact our support team and we'll help you get started.