Claude Desktop
Wire Pinax into Anthropic's official Claude Desktop client.
Claude Desktop reads MCP servers from a JSON config file. On macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%\Claude\claude_desktop_config.json.
1. Index a docs site
pinax add stripe
2. Add the server entry
{
"mcpServers": {
"pinax": {
"command": "pinax",
"args": ["serve"],
},
},
}
A single pinax serve covers every manifest you’ve added. To pin a single
docs site:
{
"mcpServers": {
"stripe-docs": {
"command": "pinax",
"args": ["serve", "stripe"],
},
},
}
Or let Pinax write the snippet for you:
pinax config claude # prints the unified snippet
pinax config claude --split # one entry per manifest
3. Restart Claude Desktop
Quit and relaunch - the app only reads the config file at startup. You should see a small plug icon in the conversation header confirming the server is connected.
4. Try it
Ask Claude something only the docs would know:
Using the pinax tools, find the Stripe API method for confirming a PaymentIntent and quote its required parameters.
Claude will call list_sections → search_pages → get_page and answer
from the live page.
Troubleshooting
- “Failed to load tools” in the Claude UI usually means
pinaxisn’t on the PATH the desktop app inherits. Use an absolute path incommand(the output ofwhich pinax). - No tools listed at all - quit Claude Desktop fully (Cmd-Q on macOS, not just close the window) and relaunch.
- For deeper debugging, run
pinax serve --httpin a terminal and watch the log UI athttp://localhost:8423/while Claude makes calls.