Deliberationv4.6.1

Manual MCP setup

Manual MCP setup

If /setup does not work, register the MCP servers manually. Each command is idempotent (safe to rerun).

The server NAME matters. Claude Code derives each tool id from it, and the bundled commands declare those ids in allowed-tools (mcp__deliberation-gemini__gemini, mcp__deliberation-grok__grok, mcp__deliberation-openrouter__openrouter, mcp__deliberation__ask-gpt). Register under any other name and the slash commands will not reach the servers. Use the names exactly as written below.

${CLAUDE_PLUGIN_ROOT} is set by Claude Code only while a plugin is loaded, so it is EMPTY in an ordinary shell - every path below would collapse to /server/.... Point DELIB_ROOT at your copy first (the installed plugin, or a git checkout):

bash
# Installed plugin (highest version in the marketplace cache):
DELIB_ROOT="$(find "$HOME/.claude/plugins/cache" -maxdepth 6 -path '*/deliberation/*/server/mcp/index.js' -type f 2>/dev/null | sort -V | tail -1)"
DELIB_ROOT="${DELIB_ROOT%/server/mcp/index.js}"
# ...or a local checkout:  DELIB_ROOT="$HOME/src/deliberation"
[ -f "$DELIB_ROOT/server/mcp/index.js" ] || echo "DELIB_ROOT is wrong: $DELIB_ROOT"
bash
# The unified `deliberation` server - serves ask-all / consensus / the eight experts AND
# GPT (`ask-gpt`). Register this one first: without it there is no GPT at all, because
# codex-cli ships no MCP server of its own and this server spawns `codex exec` itself.
# GPT's model + reasoning effort: providers.codex.{model,reasoningEffort} in config.json,
# else ~/.codex/config.toml.
claude mcp remove deliberation >/dev/null 2>&1 || true
claude mcp add --transport stdio --scope user deliberation -- node "$DELIB_ROOT/server/mcp/index.js"

# Gemini - export GEMINI_API_KEY (AI Studio key) for advisory calls; agy is opt-in
# (workspace-write, or no key). Same env-vs-manifest tradeoff as Grok below.
claude mcp remove deliberation-gemini >/dev/null 2>&1 || true
claude mcp add --transport stdio --scope user deliberation-gemini -- node "$DELIB_ROOT/server/gemini/index.js"

# Grok (xAI) - API-based, advisory-only. Needs XAI_API_KEY.
# Default registers WITHOUT --env, so the key is NOT written to ~/.claude.json;
# export XAI_API_KEY in Claude Code's launch environment (e.g. your shell profile).
claude mcp remove deliberation-grok >/dev/null 2>&1 || true
claude mcp add --transport stdio --scope user deliberation-grok -- node "$DELIB_ROOT/server/grok/index.js"
# Alternative (persists the key in ~/.claude.json in plaintext): append
#   --env XAI_API_KEY="$XAI_API_KEY"
# before the `-- node ...` part of the command above.

# OpenRouter - API-based, advisory-only. Needs OPENROUTER_API_KEY (or the env var named
# by the record's apiKeyEnv). Same env-vs-manifest tradeoff as Grok above.
claude mcp remove deliberation-openrouter >/dev/null 2>&1 || true
claude mcp add --transport stdio --scope user deliberation-openrouter -- node "$DELIB_ROOT/server/openrouter/index.js"

Verify (same four servers the plugin manifest registers):

bash
claude mcp list
for srv in mcp gemini grok openrouter; do
  printf '{"jsonrpc":"2.0","id":"health","method":"initialize","params":{}}\n' | node "$DELIB_ROOT/server/$srv/index.js"
done

Rendered from TECHNICAL.md in the repository.

Type to search the site.