Skip to content

Fix Windows Obsidian MCP registration #12

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
OgeonX-Ai merged 1 commit into from
Jun 21, 2026
Merged

Fix Windows Obsidian MCP registration #12

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions docs/operator-testing.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,14 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\register-global.ps1 -A

## 4. List MCP Servers In Each CLI

Use the canonical Windows profile when testing global CLI configuration. This avoids the accented-profile drift that can make a CLI read stale user-level settings:

```powershell
$env:USERPROFILE = 'C:\Users\KimHarjamaki'
$env:HOME = 'C:\Users\KimHarjamaki'
$env:AZURE_CONFIG_DIR = 'C:\Users\KimHarjamaki\.azure'
```

```powershell
codex.cmd mcp list | Select-String -Pattern 'prompt-refiner|obsidian|Connected|enabled'
claude.cmd mcp list | Select-String -Pattern 'prompt-refiner|obsidian|Connected|Configured'
Expand All @@ -64,6 +72,10 @@ Expected result:

Codex may show `Unsupported` in the status column for stdio MCP entries. Treat the registration doctor as the authoritative config drift check.

On Windows, Obsidian MCP must be registered with `npx.cmd`, not `npx`. `npx` can resolve to the PowerShell shim (`npx.ps1`) and fail under the default execution policy.

Gemini can report MCP servers as disabled when the current folder is untrusted. Start Gemini from the repo once with `--skip-trust` or accept the workspace trust prompt. Gemini also requires its own auth setup (`GEMINI_API_KEY`, Vertex AI, or Gemini Code Assist) before a trusted full CLI session can start.

## 5. Verify Dashboard Runtime Health

Start or restart the local background runtime:
Expand Down
4 changes: 3 additions & 1 deletion universal-refiner/scripts/operations/register-global.ps1
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -320,6 +320,8 @@ $profile = Resolve-NormalizedPath $ProfileRoot
$repoRoot = Resolve-NormalizedPath (Join-Path $PSScriptRoot "..\..")
$serverPath = ConvertTo-ConfigPath (Join-Path $repoRoot "dist\src\index.js")
$vaultPath = ConvertTo-ConfigPath $ObsidianVaultPath
$isWindowsHost = $env:OS -eq "Windows_NT" -or [System.IO.Path]::DirectorySeparatorChar -eq "\"
$npxCommand = if ($isWindowsHost) { "npx.cmd" } else { "npx" }

if ([string]::IsNullOrWhiteSpace($CodexHome)) {
if (-not $PSBoundParameters.ContainsKey("ProfileRoot") -and -not [string]::IsNullOrWhiteSpace($env:CODEX_HOME)) {
Expand All @@ -336,7 +338,7 @@ $servers = [ordered]@{
args = @($serverPath)
}
"obsidian" = [ordered]@{
command = "npx"
command = $npxCommand
args = @("-y", "@bitbonsai/mcpvault@latest", $vaultPath)
}
}
Expand Down