Choose your AI platform below.
Claude Code (recommended, easiest)
Claude Code connects directly to the MCP server; no bridge needed.
API endpoints:
https://qtrl.me/mcp/sse - MCP over SSE (Claude Code)
https://qtrl.me/mcp - MCP over Streamable HTTP (the bridge and your own clients)
Quick test:
curl -X POST https://qtrl.me/mcp \
-H "Authorization: Bearer YOUR_API_TOKEN_HERE" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
The reply lists the tools in the table above. 401 means the key is wrong.
Step 1: Install Claude Code
npm install -g @anthropic-ai/claude-code
# or
curl -fsSL https://claude.ai/install.sh | sh
Step 2: Add qtrl.me as an MCP server
claude mcp add --transport sse qtrlme https://qtrl.me/mcp/sse \
--header "Authorization: Bearer YOUR_API_TOKEN_HERE"
Step 3: Start talking
Done. Start Claude and ask about your devices:
claude
Then type for example: "List my hubs"
Claude Desktop (requires a bridge)
Claude Desktop only talks to local programs (stdio), so a small bridge forwards the calls to qtrl.me.
API endpoints:
https://qtrl.me/mcp - MCP over Streamable HTTP (the bridge and your own clients)
Quick test:
curl -X POST https://qtrl.me/mcp \
-H "Authorization: Bearer YOUR_API_TOKEN_HERE" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
The reply lists the tools in the table above. 401 means the key is wrong.
Step 1: Download the bridge
Save the bridge somewhere permanent:
Step 2: Configure Claude Desktop
Edit the Claude Desktop configuration file:
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"qtrlme": {
"command": "node",
"args": [
"C:\\qtrlme\\qtrlme-bridge.js",
"https://qtrl.me/mcp",
"YOUR_API_TOKEN_HERE"
]
}
}
}
Note: Change the bridge path to where you saved it. On macOS/Linux use forward slashes: /Users/yourname/qtrlme-bridge.js
Step 3: Restart Claude Desktop
Quit Claude Desktop completely and start it again so the configuration is loaded.
ChatGPT / OpenAI
API endpoints:
GET https://qtrl.me/api/openai/functions - list the available functions
POST https://qtrl.me/api/openai/functions/execute - execute a function
Quick test:
curl https://qtrl.me/api/openai/functions \
-H "Authorization: Bearer YOUR_API_TOKEN_HERE"
Python example:
import openai
import requests
# Fetch QtrlMe functions
response = requests.get("https://qtrl.me/api/openai/functions",
headers={"Authorization": "Bearer YOUR_TOKEN"})
functions = response.json()["functions"]
# Use with ChatGPT
client = openai.OpenAI(api_key="your_openai_key")
response = client.chat.completions.create(
model="gpt-4",
messages=[{"role": "user", "content": "List my RF-HUBs"}],
functions=functions
)
Node.js example:
const OpenAI = require('openai');
const axios = require('axios');
const client = new OpenAI({ apiKey: 'your_openai_key' });
// Fetch QtrlMe functions
const { data } = await axios.get('https://qtrl.me/api/openai/functions', {
headers: { Authorization: 'Bearer YOUR_TOKEN' }
});
// Use with ChatGPT
const response = await client.chat.completions.create({
model: 'gpt-4',
messages: [{ role: 'user', content: 'List my RF-HUBs' }],
functions: data.functions
});
// Handle function call
if (response.choices[0].message.function_call) {
const { name, arguments: args } = response.choices[0].message.function_call;
const result = await axios.post('https://qtrl.me/api/openai/functions/execute',
{ name, arguments: args },
{ headers: { Authorization: 'Bearer YOUR_TOKEN' }}
);
console.log(result.data.content);
}
Authentication: All requests require your API key as a Bearer token in the Authorization header.
Google Gemini
API endpoints:
GET https://qtrl.me/api/gemini/functions - list the available functions
POST https://qtrl.me/api/gemini/functions/execute - execute a function
Quick test:
curl https://qtrl.me/api/gemini/functions \
-H "Authorization: Bearer YOUR_API_TOKEN_HERE"
Python example:
import google.generativeai as genai
import requests
# Fetch QtrlMe functions
response = requests.get("https://qtrl.me/api/gemini/functions",
headers={"Authorization": "Bearer YOUR_TOKEN"})
functions = response.json()["functionDeclarations"]
# Use with Gemini
genai.configure(api_key="your_gemini_key")
model = genai.GenerativeModel(
model_name="gemini-pro",
tools=[{"function_declarations": functions}]
)
chat = model.start_chat()
response = chat.send_message("List my RF-HUBs")
Node.js example:
const { GoogleGenerativeAI } = require('@google/generative-ai');
const axios = require('axios');
const genAI = new GoogleGenerativeAI('your_gemini_key');
// Fetch QtrlMe functions
const { data } = await axios.get('https://qtrl.me/api/gemini/functions', {
headers: { Authorization: 'Bearer YOUR_TOKEN' }
});
// Use with Gemini
const model = genAI.getGenerativeModel({
model: 'gemini-pro',
tools: [{ functionDeclarations: data.functionDeclarations }]
});
const chat = model.startChat();
const result = await chat.sendMessage('List my RF-HUBs');
// Handle function call
const call = result.response.functionCalls()?.[0];
if (call) {
const executeResult = await axios.post(
'https://qtrl.me/api/gemini/functions/execute',
{ name: call.name, args: call.args },
{ headers: { Authorization: 'Bearer YOUR_TOKEN' }}
);
console.log(executeResult.data.response);
}
Authentication: All requests require your API key as a Bearer token in the Authorization header.