MCP setup

Generic config that works with any MCP-aware client. Editor-specific tweaks live on their own pages.

The minimum config

{
  "mcpServers": {
    "soriku": {
      "command": "python",
      "args": ["/absolute/path/to/soriku/mcp_server.py"],
      "env": {
        "SORIKU_MCP_API_KEY": "sk-soriku-local"
      }
    }
  }
}

The SORIKU_MCP_API_KEY is the auth header Soriku checks. In local mode sk-soriku-local is the conventional value. In Simezu mode use a key generated through the Simezu workspace.

Verify the connection

Call soriku_health from your MCP client. If it returns server uptime and model count, you're connected.

Common issues

command not found — use the absolute path to your venv's Python, not the system python
No models available — Ollama isn't running, or no models pulled. See Model not loading
Auth failed — the SORIKU_MCP_API_KEY doesn't match what Soriku expects

Tools reference →