Proxy guides, tested configurations and error diagnostics, with an optional local route check.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add ipvolt-proxy-toolkit --env IPVOLT_PROXY_URL='<IPVOLT_PROXY_URL>' -- npx -y @ipvolt/proxy-toolkit-mcp~/.codex/config.toml
[mcp_servers.ipvolt-proxy-toolkit]
command = "npx"
args = ["-y", "@ipvolt/proxy-toolkit-mcp"]
env = { IPVOLT_PROXY_URL = "<IPVOLT_PROXY_URL>" }
# codex mcp add ipvolt-proxy-toolkit --env IPVOLT_PROXY_URL='<IPVOLT_PROXY_URL>' -- npx -y @ipvolt/proxy-toolkit-mcp~/.cursor/mcp.json
{
"mcpServers": {
"ipvolt-proxy-toolkit": {
"command": "npx",
"args": [
"-y",
"@ipvolt/proxy-toolkit-mcp"
],
"env": {
"IPVOLT_PROXY_URL": "<IPVOLT_PROXY_URL>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"ipvolt-proxy-toolkit": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ipvolt/proxy-toolkit-mcp"
],
"env": {
"IPVOLT_PROXY_URL": "<IPVOLT_PROXY_URL>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"ipvolt-proxy-toolkit": {
"command": "npx",
"args": [
"-y",
"@ipvolt/proxy-toolkit-mcp"
],
"env": {
"IPVOLT_PROXY_URL": "<IPVOLT_PROXY_URL>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"ipvolt-proxy-toolkit": {
"command": "npx",
"args": [
"-y",
"@ipvolt/proxy-toolkit-mcp"
],
"env": {
"IPVOLT_PROXY_URL": "<IPVOLT_PROXY_URL>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"ipvolt-proxy-toolkit": {
"command": "npx",
"args": [
"-y",
"@ipvolt/proxy-toolkit-mcp"
],
"env": {
"IPVOLT_PROXY_URL": "<IPVOLT_PROXY_URL>"
}
}
}
}Remote
claude mcp add --transport http ipvolt-proxy-toolkit https://mcp.ipvolt.com/mcp~/.codex/config.toml
[mcp_servers.ipvolt-proxy-toolkit]
url = "https://mcp.ipvolt.com/mcp"
# codex mcp add ipvolt-proxy-toolkit --url https://mcp.ipvolt.com/mcp~/.cursor/mcp.json
{
"mcpServers": {
"ipvolt-proxy-toolkit": {
"url": "https://mcp.ipvolt.com/mcp"
}
}
}.vscode/mcp.json
{
"servers": {
"ipvolt-proxy-toolkit": {
"type": "http",
"url": "https://mcp.ipvolt.com/mcp"
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"ipvolt-proxy-toolkit": {
"httpUrl": "https://mcp.ipvolt.com/mcp"
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"ipvolt-proxy-toolkit": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.ipvolt.com/mcp"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"ipvolt-proxy-toolkit": {
"url": "https://mcp.ipvolt.com/mcp"
}
}
}Environment variables
IPVOLT_PROXY_URL
Replace the placeholders with your own credentials and keep them out of version control.