mcp-server

Thin MCP stdio shim over core-lib's curated helpdesk operations (SPEC §2.3, docs/approved/ide-helpdesk/SPEC.md in the soltein repo). No business logic lives here — every tool validates its input (zod) and dispatches straight to the matching core-lib function.

Runs standalone, independent of the VS Code extension and its SecretStorage-backed auth — see SPEC §2.4 and Success Criterion 7/8.

Configuration

Reads its Odoo connection from environment variables (never from VS Code's SecretStorage, never committed anywhere):

| Variable | Example | |---|---| | SOLT_HELPDESK_ODOO_URL | http://localhost:9069 | | SOLT_HELPDESK_ODOO_DB | odoo_server_17 | | SOLT_HELPDESK_ODOO_LOGIN | [email protected] | | SOLT_HELPDESK_ODOO_API_KEY | a standard Odoo API key from your own user's Account Security preferences |

All four are required — the server exits with a clear error listing whichever are missing.

Installing

Published to GitHub Packages as @soltein-net/solt-helpdesk-mcp, not the public npm registry. One-time setup (needs a GitHub PAT with read:packages scope):

npm login --scope=@soltein-net --registry=https://npm.pkg.github.com
npm install -g @soltein-net/solt-helpdesk-mcp --registry=https://npm.pkg.github.com

The global install exposes it on your PATH as solt-helpdesk-mcp (this package's own bin entry) — no need to know or reference its node_modules path anywhere below.

Running standalone

SOLT_HELPDESK_ODOO_URL=... SOLT_HELPDESK_ODOO_DB=... \
SOLT_HELPDESK_ODOO_LOGIN=... SOLT_HELPDESK_ODOO_API_KEY=... \
solt-helpdesk-mcp

It speaks MCP over stdio — nothing to see on its own; connect an MCP host or client.

Registering with an MCP host

Claude Desktop (claude_desktop_config.json) / Claude Code CLI (claude mcp add) / any other stdio-based MCP host — point command at the globally-installed binary, no args needed:

{
  "mcpServers": {
    "solt-helpdesk": {
      "command": "solt-helpdesk-mcp",
      "env": {
        "SOLT_HELPDESK_ODOO_URL": "http://localhost:9069",
        "SOLT_HELPDESK_ODOO_DB": "odoo_server_17",
        "SOLT_HELPDESK_ODOO_LOGIN": "[email protected]",
        "SOLT_HELPDESK_ODOO_API_KEY": "..."
      }
    }
  }
}

PyCharm's AI Assistant (Settings → Tools → AI Assistant → Model Context Protocol → Add): command solt-helpdesk-mcp, no arguments, same four environment variables set in its own env var fields.

VS Code's Copilot agent mode: handled automatically by solt-vscode-helpdesk's own McpServerProvider (Task 14) if you're using the extension — nothing to configure by hand there.

Tools

One per core-lib operation: list_my_issues, search_issues, get_issue, add_issue_note, create_problem, get_problem, update_problem, advance_problem_stage, list_issue_transitions, change_issue_stage, resolve_issue, close_issue, reopen_issue, create_issue. Each tool's description and input schema are self-documenting via tools/list.