Annolux
EN 中文

MCP · Claude Desktop

Claude Desktop web search MCP setup

Give Claude Desktop a bounded web search tool: edit claude_desktop_config.json, restart fully, and search_web appears with fetched_at on every result.

Where the config file lives

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Or open it from the app: Settings → Developer → Edit Config.

The JSON

No separate install is needed — npx downloads annolux-mcp on first run. This block starts the limited sandbox immediately. For the full account allowance, add ANNOLUX_API_KEY to the server's env as shown on the MCP overview page.

{
  "mcpServers": {
    "annolux": {
      "command": "npx",
      "args": ["-y", "annolux-mcp"]
    }
  }
}

Use an absolute command path

GUI apps on macOS do not inherit your shell PATH. If the tool never appears, replace "npx" in the command field with its absolute path — run `which npx` in your terminal to find it (for nvm users it lives under $HOME/.nvm/versions).

Restart completely

Claude Desktop reads the config at startup. Quit the app fully — Quit from the menu bar on macOS or the tray icon on Windows, not just closing the window — then reopen it. search_web should appear in the tools menu of a new conversation.

If it does not show up

  • macOS logs: ~/Library/Logs/Claude/ — look at the mcp*.log files.
  • Windows logs: %APPDATA%\Claude\logs.
  • Test the server standalone: set the two env vars in a terminal and run npx -y annolux-mcp — it should start and wait on stdio.
  • JSON syntax errors make the whole file silently ignored — validate after editing.

Update or remove

To confirm the newest release, run npx -y annolux-mcp@latest once and restart Claude Desktop; the config file needs no change. To remove, delete the annolux entry from mcpServers and restart fully. Other MCP servers in the same file are unaffected; the file stays valid as long as the JSON does.

Boundaries and credits

search_web queries a curated English and Chinese index — not realtime, not the whole web; an empty result is a normal outcome. Only a successful 2xx search costs one credit; errors and timeouts cost zero. Every account gets 1,000 free credits each month.