docs → tools → claude-desktop

Frenchie in Claude Desktop

Natural language. Requires --global install.

Install

From your project root:

npx @lab94/frenchie install --agent claude-desktop --global --api-key fr_your_key_here

Need help picking an agent? See the invocation matrix.

Invoke

Primary pattern:

Use Frenchie to OCR TOR.pdf

Claude Desktop reads only user-level MCP config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS), so the --global flag is required — auto-detect will not write under $HOME without it.

Example

You:

Use Frenchie to OCR TOR.pdf

Agent:

Claude Desktop resolves to ocr_to_markdown with a file path you pick from the file chooser or paste in. The server saves .frenchie/TOR/result.md in your current working directory.

Known gotchas

Fully quit before reopening

Claude Desktop caches MCP configs in-process — a soft reload is not enough. Fully quit (Cmd+Q on macOS) and reopen after install. Otherwise the new stdio entry won't be picked up.

Main Frenchie docs — MCP tools, credits, rate limits, full API
All agent guides — the full invocation matrix
Troubleshooting — symptom-first fixes for every error we've seen
Migration guide — upgrading from 0.1.x, 0.2.x, 0.3.0, or 0.3.1