Configuration - Multivon Docs

multivon-mcp is a stdio MCP server installed as the console script multivon-mcp. Point any MCP-compatible agent at it.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "multivon": {
      "command": "multivon-mcp",
      "env": {
        "ANTHROPIC_API_KEY": "sk-ant-...",
        "OPENAI_API_KEY": "sk-proj-...",
        "GOOGLE_API_KEY": "AIza..."
      }
    }
  }
}

Restart Claude. The 22 tools appear in the tool drawer; ask Claude "use multivon to evaluate this RAG output" and it picks the right tool.

Claude Code

Claude Code does not read claude_desktop_config.json. Add the server with the CLI and verify the saved configuration:

claude mcp add --transport stdio --scope user multivon -- multivon-mcp
claude mcp get multivon

Use --scope project to create a shareable .mcp.json in the project root:

{
  "mcpServers": {
    "multivon": {
      "command": "multivon-mcp"
    }
  }
}

API keys can come from the shell environment. Claude Code also supports ${VAR} expansion inside .mcp.json; do not commit literal keys.

Cursor

.cursor/mcp.json or via Settings → MCP:

{
  "mcpServers": {
    "multivon": {
      "command": "multivon-mcp"
    }
  }
}

Cline / OpenCode / any MCP-compatible agent

Use the client’s local stdio-server configuration and point its command at multivon-mcp:

{
  "mcpServers": {
    "multivon": {
      "command": "multivon-mcp"
    }
  }
}

Local development & debugging

mcp dev multivon_mcp/server.py

This opens the MCP Inspector UI in your browser. You can call any tool by name, see the JSON schemas, and watch the request/response trace. Useful when you’re debugging tool selection in an agent — drive it manually first to confirm the inputs / outputs match what you expect.

Provider API keys are read from environment variables (ANTHROPIC_API_KEY, OPENAI_API_KEY, GOOGLE_API_KEY). The MCP server never prompts for them and never accepts them as tool arguments — they stay in the agent’s process env.

​Claude Desktop

​Claude Code

​Cursor

​Cline / OpenCode / any MCP-compatible agent

​Local development & debugging

Claude Desktop

Claude Code

Cursor

Cline / OpenCode / any MCP-compatible agent

Local development & debugging