Review and fix documentation errors across all install guides

Linux fixes:
- NodeSource: setup_lts.x does not exist, replaced with setup_22.x
- Added sudo apt install nodejs as simplest Ubuntu 26.04 option
- nvm version pinned to v0.40.1 (widely verified)
- Added auth token note for Gemini SSE config
- USERNAME placeholders clarified with whoami hint
- systemd service section now covers venv installs

Windows fixes:
- DILIGENCE_PATH placeholder replaced with auto-resolving PowerShell
  using double-quoted here-strings and -replace for JSON backslashes
- Claude Desktop config now sets both standard and Store paths in one block
- Added auth token note for Gemini SSE config
- ChatGPT config path caveated (varies by version)
This commit is contained in:
Claude 2026-08-03 08:01:22 +00:00
parent aba8d42123
commit 9ab9135ca2
2 changed files with 69 additions and 61 deletions

View file

@ -149,35 +149,40 @@ Create or edit the settings file:
```powershell
mkdir "$env:USERPROFILE\.gemini" -ErrorAction SilentlyContinue
Set-Content "$env:USERPROFILE\.gemini\settings.json" @'
$dp = ("$env:USERPROFILE\Downloads\Diligence-main") -replace '\\','\\\\'
@"
{
"mcpServers": {
"diligence": {
"command": "python",
"args": ["mcp_stdio.py"],
"cwd": "DILIGENCE_PATH"
"cwd": "$dp"
}
}
}
'@
"@ | Set-Content "$env:USERPROFILE\.gemini\settings.json"
```
Replace `DILIGENCE_PATH` with your actual path, using double backslashes:
`C:\\Users\\giord\\Downloads\\Diligence-main`
**Alternatively**, Gemini CLI supports SSE directly (unlike Claude Desktop), so you
can point it at the running MCP server without the stdio script:
can point it at the running MCP server without the stdio script. If your Diligence
instance has API token auth enabled (check `http://localhost:8000/agent`), include
the token in headers. Open the settings file in Notepad and paste:
```json
{
"mcpServers": {
"diligence": {
"url": "http://localhost:3001/sse"
"url": "http://localhost:3001/sse",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_FROM_AGENT_PAGE"
}
}
}
}
```
Omit the `headers` block if no token is shown on the Agent page.
**Use:**
1. Start Diligence in one terminal (`python -m diligence`)
@ -203,42 +208,31 @@ install from the Microsoft Store. Sign in with your free Claude account.
Claude Desktop reads its config from different paths depending on install method.
Set both to be safe:
**Standard install:**
Generate and save the config (this auto-resolves your Downloads path):
```powershell
$dp = ("$env:USERPROFILE\Downloads\Diligence-main") -replace '\\','\\\\'
$json = @"
{
"mcpServers": {
"diligence": {
"command": "python",
"args": ["mcp_stdio.py"],
"cwd": "$dp"
}
}
}
"@
# Standard install path
mkdir "$env:APPDATA\Claude" -ErrorAction SilentlyContinue
Set-Content "$env:APPDATA\Claude\claude_desktop_config.json" @'
{
"mcpServers": {
"diligence": {
"command": "python",
"args": ["mcp_stdio.py"],
"cwd": "DILIGENCE_PATH"
}
}
}
'@
$json | Set-Content "$env:APPDATA\Claude\claude_desktop_config.json"
# Microsoft Store install path (set both to be safe)
$storePath = "$env:LOCALAPPDATA\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude"
if (Test-Path $storePath) { $json | Set-Content "$storePath\claude_desktop_config.json" }
```
**Microsoft Store install:**
```powershell
Set-Content "$env:LOCALAPPDATA\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json" @'
{
"mcpServers": {
"diligence": {
"command": "python",
"args": ["mcp_stdio.py"],
"cwd": "DILIGENCE_PATH"
}
}
}
'@
```
Replace `DILIGENCE_PATH` with your actual path using double backslashes:
`C:\\Users\\giord\\Downloads\\Diligence-main`
**Important:** Do NOT use the "Add custom connector" button in Claude Desktop's UI.
That is for remote MCP servers and may have plan restrictions. The config file
approach above is for local MCP and works on the free plan.
@ -263,22 +257,11 @@ approach above is for local MCP and works on the free plan.
**Configure MCP:**
```powershell
mkdir "$env:APPDATA\ChatGPT" -ErrorAction SilentlyContinue
Set-Content "$env:APPDATA\ChatGPT\chatgpt_config.json" @'
{
"mcpServers": {
"diligence": {
"command": "python",
"args": ["mcp_stdio.py"],
"cwd": "DILIGENCE_PATH"
}
}
}
'@
```
Replace `DILIGENCE_PATH` with your actual path using double backslashes.
MCP configuration is shared between ChatGPT Desktop and OpenAI Codex CLI.
The config file location may vary by version — check OpenAI's documentation
for the current path. As of mid-2026, it is typically at
`%APPDATA%\ChatGPT\chatgpt_config.json`. Use the same JSON format as
Claude Desktop (Section 7b) with your Diligence path.
**Enable Developer Mode:** Settings > Developer Mode > ON