×
Connecting OpenCode to the QR Code MCP Server

Connecting OpenCode to the QR Code MCP Server

A step-by-step guide to connecting our QR Code platform directly to your OpenCode workspace.

book reader icon
2 Minutes
facebook logo gray
blueskylogo gray
linkedin logo gray
mail logo gray
Ready to put your QR Code management on autopilot? The Model Context Protocol (MCP) allows AI models and AI Coding Agents like OpenCode to safely interact with external platforms. In just a few minutes, this guide will show you how to securely connect Claude to the QR Planet platform. Once set up, you’ll be able to use natural language prompts to pull scan statistics, generate SVG codes inline, or audit your dynamic business cards without ever leaving your AI workspace.
 
For a deep dive into the underlying architecture or to see alternative AI client configurations, check out our core QR Code MCP integration overview.

How to connect to our QR Code Platform using MCP

1. Get the API Key from our QR Code Platform

Please log into your administrator account on our QR Platform.

Login

Login
Login Form
Once logged in, click on the menu API settings and in the area API v2 click on <SHOW SECRET API KEY> to see the full API key.
Click on the menu API settings and in the area API v2 click on <SHOW SECRET API KEY> and copy the Secret API key
Click on the menu API settings and in the area API v2 click on and copy the Secret API key.

Once the Secret API key is revealed, mark it and copy&paste it to an editor - we will need it later!

2. Add to OpenCode MCP Config

First, we have to add our MCP Server to your OpenCode config. Open the the following file in your editor of choice (eg VS Code): 

~/.config/opencode/opencode.json

Make sure that the mcp object with the qrplanet-mcp entry is in the file.

If there is no mcp block in the file yet, copy the whole block into it. If already available only add the qrplanet-mcp entry into the object.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "qrplanet-mcp": {
      "type": "remote",
      "url": "https://api.qrplanet.com/mcp",
      "enabled": true,
      "oauth": {
        "clientId": "opencode"
      },
      "scope": "mcp:tools"
    }
  }
}

3. Authorize via OAuth2

Next, we need to authorize OpenCode to access the MCP Server. In order to do that run the following command in your terminal:

opencode mcp auth qrplanet-mcp

A popup opens now where you enter the Secret API Key you copied before.

Enter the Secret API Key you copied before and click on Authorize
Enter the Secret API Key you copied before and click on Authorize

After you entered the correct API Key you will see a success message from OpenCode.

Success Message from OpenCode
Success Message from OpenCode

Now you are ready to actually use the QR Code MCP Server.

4. Start a Chat session using MCP

After we configured the MCP Connector we are finally able to chat with the QR Codes. Therefore open a new chat session and start to ask questions about your QR Codes.

Prompt Examples
  • Make a table with the 5 oldest QR Codes in my QR Planet account
  • How many Digital Business Cards are created in my account?
  • Create a new QR Code that points to https://test.de
  • How many scans has my QR Code easter-promotion2
  • Get the SVG of the QR Code​ easter-promotion2 and show it inline.

Congratulations, you now can use our QR Planet MCP server to access all your QR Code data from Claude.

 
Last update 1 hour ago