connect

/odoo-semantic-mcp:connect

Interactive command to connect Claude Code to your Odoo Semantic MCP server.

Run this after claude plugin install - userConfig values are not always prompted at install time. Without this step the odoo-semantic-mcp plugin's .mcp.json template cannot resolve and the odoo-semantic MCP server silently fails to load.

Steps for the AI agent

1. Ask user for MCP server URL. Default: https://odoo-semantic.viindoo.com/mcp.

2. Ask user to paste their API key. Must match ^osm_[A-Za-z0-9_-]+$. Re-prompt on format mismatch. Do not echo the key back in plain text.

3. Run the following with the Bash tool (substitute <URL> and <KEY>):

   claude mcp add --scope user --transport http odoo-semantic <URL> \
     --header "X-API-Key: <KEY>"
   

   If claude mcp add reports the name already exists, run claude mcp remove odoo-semantic --scope user first, then retry. If exit code is non-zero for any other reason, report stderr to the user and stop.

   Then harden the entry against a hung server: Claude Code's default per-tool-call timeout (MCP_TOOL_TIMEOUT) is ~28 hours, so if OSM accepts the connection but stalls mid-request the agent would block effectively forever instead of falling back to reading source. claude mcp add has no timeout flag, so set a 90s (90000 ms) per-server timeout directly in ~/.claude.json (the file claude mcp add --scope user just wrote to). Run this exact block with the Bash tool - it backs up, refuses to corrupt invalid JSON, only touches the odoo-semantic entry, and is idempotent. Copy the fenced block verbatim without re-indenting - the heredoc body must start at column 0.

   CLAUDE_JSON="$HOME/.claude.json"
   python3 - "$CLAUDE_JSON" <<'PY'
   import json, os, sys, time, shutil
   p = sys.argv[1]
   if not os.path.exists(p):
       print(f"⚠ {p} not found - skipping timeout hardening (entry may be in another scope).")
       sys.exit(0)
   try:
       with open(p) as f:
           data = json.load(f)
   except json.JSONDecodeError as e:
       print(f"✗ {p} is not valid JSON ({e}). Refusing to overwrite.", file=sys.stderr)
       sys.exit(2)
   srv = (data.get("mcpServers") or {}).get("odoo-semantic")
   if not isinstance(srv, dict):
       print("⚠ mcpServers.odoo-semantic not found in ~/.claude.json - skipping (re-run step 3 first).")
       sys.exit(0)
   if srv.get("timeout") == 90000:
       print("✓ odoo-semantic timeout already 90000 ms - no change.")
       sys.exit(0)
   shutil.copy2(p, f"{p}.bak.{int(time.time())}")
   srv["timeout"] = 90000
   with open(p, "w") as f:
       json.dump(data, f, indent=2)
       f.write("\n")
   print("✓ Set odoo-semantic per-tool-call timeout to 90000 ms in ~/.claude.json.")
   PY
   

   On exit code 2 (invalid JSON): surface the stderr line verbatim and stop; do not retry or delete the file. A ⚠ (exit 0) is non-fatal - registration may have used a different scope; continue. On ✓: continue to step 4.

4. Verify the server is reachable and the key is accepted via HTTP probe. Do not try to call the MCP tool model_inspect here - Claude Code v2.x does not hot-reload MCP servers, so odoo-semantic is invisible to the AI agent until the user restarts the session (anthropics/claude-code#46426 - "not planned"). Use curl via the Bash tool instead. Substitute <URL> (full URL ending in /mcp) and <KEY>:

   BASE_URL=$(echo "<URL>" | sed 's:/mcp/*$::')
   curl -sfo /dev/null "${BASE_URL}/health" \
     || { echo "✗ Server unreachable at ${BASE_URL}/health"; exit 1; }
   STATUS=$(curl -s -o /dev/null -w "%{http_code}" \
     -H "X-API-Key: <KEY>" "${BASE_URL}/mcp")
   case "$STATUS" in
     401|403) echo "✗ API key rejected (HTTP $STATUS)"; exit 1 ;;
     *)       echo "✓ Server reachable, key accepted (HTTP $STATUS)" ;;
   esac
   

   The MCP endpoint returns 401/403 only for missing or invalid keys. A valid key reaches the FastMCP handler, which responds 200/202/405/406 to a plain GET - any of those is success for the purposes of this probe.

   • On ✓: continue to step 5.
   • On ✗: surface the curl output and stop. Common fixes: VPN/firewall, server restarted with server-side key rotation, key revoked on the server.