connect

/odoo-semantic-mcp:connect

Connects this Claude Code to your Odoo Semantic MCP server. The plugin already declares the server (.mcp.json) and the two values it needs (userConfig: the server URL and the key); this command gets them filled in the right place, removes what hides the plugin's server, and verifies the connection. Nothing sensitive goes through the chat: Claude Code's own configuration dialog stores the key.

Steps for the AI agent

1. Is the plugin's server hidden by an older registration? Run with the Bash tool:

   claude mcp get odoo-semantic 2>&1 | head -5
   

   A line Scope: User (or Local / Project) means a stand-alone odoo-semantic entry was registered by hand earlier (an earlier version of this command did that); Claude Code lets it SHADOW the plugin's server of the same name, so a value filled in the plugin dialog would never be used. Tell the operator this and give them the ONE command that moves what that entry holds (its URL and its value) into the plugin's configuration and then removes the entry, after a backup of the file - run by THEM, in a terminal or typed in this chat with a leading ! (it then runs on their machine, outside you); never by you:

   python3 "${CLAUDE_PLUGIN_ROOT}/scripts/migrate_connection.py" apply
   

   It prints MOVED=, REMOVED= and NEXT=/reload-plugins, and never prints a value. When it ran, step 2 is already done: continue at step 3 after /reload-plugins. An operator who prefers to keep the stand-alone entry: stop - it stays theirs to manage.

2. The values. Tell the operator, in their language:

   • the server URL: the default https://odoo-semantic.viindoo.com/mcp serves most; a self-hosted server has its own ($ARGUMENTS when given: pass it on as the URL to enter);
   • where to put them: open /plugin, choose odoo-semantic-mcp, Configure, and fill in "MCP Server URL" and "API Key" - a masked dialog stored by Claude Code itself. In a terminal the same is claude plugin configure odoo-semantic-mcp@viindoo-plugins --values-stdin with a JSON object of the two options on stdin (the plugin id is what claude plugin list shows). The key comes from your server admin or https://odoo-semantic.viindoo.com/install/.
   • then /reload-plugins: the plugin's server restarts with the configured values at once (verified); a new session is only needed for a server registered by hand. You never ask for the key, never receive it in chat, never write it anywhere.