From ba9662aeaf4c381a65750e0845bff2ed7ef9c2d8 Mon Sep 17 00:00:00 2001 From: Jean-Luc Makiola Date: Fri, 3 Apr 2026 13:39:07 +0200 Subject: [PATCH] docs: add MCP server configuration and auth docs to CLAUDE.md Co-Authored-By: Claude Opus 4.6 (1M context) --- CLAUDE.md | 42 +++++++++++++++++++++++++++++++++++++++++- 1 file changed, 41 insertions(+), 1 deletion(-) diff --git a/CLAUDE.md b/CLAUDE.md index 07de72a..97bfd85 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -68,4 +68,44 @@ bun run build # Vite build → dist/client/ - **Thread resolution**: Resolving a thread copies the winning candidate's data into a new item in the collection, sets `resolvedCandidateId`, and changes status to "resolved". - **Setup item sync**: `PUT /api/setups/:id/items` replaces all setup_items atomically (delete all, re-insert). - **Image uploads**: `POST /api/images` saves to `./uploads/` with UUID filename, returned as `imageFilename` on item/candidate records. -- **Aggregates** (weight/cost totals): Computed via SQL on read, not stored on records. \ No newline at end of file +- **Image URL fetching**: `POST /api/images/from-url` fetches an image from a URL, saves locally, returns `{ filename, sourceUrl }`. +- **Aggregates** (weight/cost totals): Computed via SQL on read, not stored on records. +- **Authentication**: Public-read, authenticated-write. Cookie sessions for web UI, API keys for programmatic access. `POST /api/auth/setup` for first-time account creation. + +## MCP Server + +GearBox includes a built-in MCP server for integration with Claude Code and Claude Desktop. Enabled by default, disable with `GEARBOX_MCP=false`. + +### Configuration + +**Claude Code** (`.claude/settings.json`): +```json +{ + "mcpServers": { + "gearbox": { + "type": "streamable-http", + "url": "http://localhost:3000/mcp", + "headers": { + "X-API-Key": "" + } + } + } +} +``` + +**Claude Desktop** (`claude_desktop_config.json`): +```json +{ + "mcpServers": { + "gearbox": { + "type": "streamable-http", + "url": "http://localhost:3000/mcp", + "headers": { + "X-API-Key": "" + } + } + } +} +``` + +Generate an API key from Settings > API Keys after logging in. \ No newline at end of file