Claude Code Gateway Setup

Get secure MCP tools working in Claude Code in under 60 seconds.

Step 1: Install the CLI Tools

One command installs both the developer tools (workshop) and runtime (siteboss):

source <(curl -sSL https://registry.buildeverything.ai/install.sh) -- both

This automatically installs:

• siteboss - MCP gateway and component runner
• wasmtime - WebAssembly runtime (if missing)

Step 2: Add the Gateway to Claude Code

Run this command in your terminal:

claude mcp add --transport stdio tool-gateway \
    -- siteboss mcp gateway

Step 3: Verify Installation

claude mcp list

You should see tool-gateway with status connected.

Step 4: Start Using Tools

Ask Claude: "What tools are available for generating QR codes?"

Claude will:

1. Search the registry using tool_search
2. Find test/qr-generator:v1.0.0
3. Ask if you want to load it
4. Load and use the tool instantly - no restart needed!

Available Meta-Tools

Tool	Purpose
tool_search	Search registry by natural language
tool_load	Pull and instantiate a component
tool_list	Show loaded tools and their functions
tool_call	Execute a loaded tool's function
tool_unload	Remove component from memory

Troubleshooting

Gateway not connecting?

• Ensure siteboss is in your PATH: which siteboss
• Verify installation: siteboss --version
• Test gateway directly: siteboss mcp gateway --help

Tools not loading?

• Check network connectivity: curl https://registry.mcpsearchtool.com/v2/
• Verify tool reference format: namespace/name:version