Q
Overview

Configuration Guide for Claude Code

This guide explains how to configure QVeris MCP server and skills in Claude Code at the user level.

Prerequisites#

  • Node.js installed (for running MCP servers)
  • Claude Code installed
  • QVeris API key (create one in Dashboard / API Keys)

1. MCP Server Configuration#

You can generate the command with QVeris CLI:

qveris mcp configure --target claude-code

Or run the command manually:

Run the following command (replace your-api-key-here with your actual API key):

Mac:

claude mcp add qveris --transport stdio --scope user --env QVERIS_API_KEY=your-api-key-here -- npx -y @qverisai/mcp

Windows (Command Prompt):

claude mcp add qveris --transport stdio --scope user --env QVERIS_API_KEY=your-api-key-here -- cmd /c npx -y @qverisai/mcp

Managing MCP Servers:

claude mcp list          # List all configured servers
claude mcp get qveris    # Get details for a specific server
claude mcp remove qveris # Remove a server

2. Skills Configuration#

Download the QVeris MCP/client skill from the GitHub repository:

Repository: https://github.com/QVerisAI/qveris-agent-toolkit/tree/main/skills/qveris

Mac:

mkdir -p ~/.claude/skills/qveris
curl -sL https://raw.githubusercontent.com/QVerisAI/qveris-agent-toolkit/main/skills/qveris/SKILL.md -o ~/.claude/skills/qveris/SKILL.md

Windows (PowerShell):

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude\skills\qveris"
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/QVerisAI/qveris-agent-toolkit/main/skills/qveris/SKILL.md" -OutFile "$env:USERPROFILE\.claude\skills\qveris\SKILL.md"

Your skills directory should look like:

~/.claude/skills/
└── qveris/
    └── SKILL.md

Verification#

  1. Restart Claude Code
  2. Run /mcp command to see connected servers
  3. Run claude mcp list to verify configuration

Usage#

Reference QVeris skills in your prompts with @.claude/skills/qveris/ (Mac/Linux) or @.claude\skills\qveris\ (Windows):

Write a python script that prints the current bitcoin price using @.claude/skills/qveris/

Troubleshooting#

MCP Server Not Connecting:

  • Verify Node.js is installed: node --version
  • Test the MCP server manually: npx -y @qverisai/mcp
  • Check your API key is correct

Windows Issues:

  • Ensure you're using cmd /c wrapper for stdio servers with npx
  • Check that Node.js is in your PATH