Dual Mode
The MCP server supports two operational modes: proxy mode connects through the hosted Knowz API at mcp.knowz.io, while direct mode connects directly to a self-hosted Knowz instance. Both modes expose identical tools, so agents work the same way regardless of deployment model.
How it works
In proxy mode, the MCP server authenticates via API key and routes all requests through mcp.knowz.io. This is the zero-configuration option -- just add your API key and you are connected. In direct mode, the server connects to your self-hosted Knowz API endpoint, useful for air-gapped environments or organizations requiring data sovereignty. Mode is configured via environment variables; no code changes needed.
Configuration showing proxy vs direct mode setup
Screenshot coming soon
Why it matters
Different teams have different requirements. Startups want the simplicity of hosted Knowz. Enterprises may require on-premises deployment for compliance. Dual mode ensures KnowzCode's knowledge integration works in both scenarios without any workflow changes. Agents call the same tools, get the same results -- only the transport layer differs.
Architecture diagram showing proxy and direct mode data flow
Screenshot coming soon