docs: add native mcp setup guide

Author: Microck

README.md

@@ -20,7 +20,7 @@
 
 the main setup path is `kagi auth`. on a real terminal it opens a guided setup flow where you choose `Session Link`, `API Key`, or `Legacy API Token`, get the official instructions inline, paste the credential, save it to `~/.config/kagi-cli/config.toml`, and validate it immediately. if you also use Kagi's paid API, the same wizard can add that too.
 
-[documentation](https://kagi.micr.dev) | [npm](https://www.npmjs.com/package/kagi-cli) | [mcp](https://github.com/Microck/kagi-mcp)
+[documentation](https://kagi.micr.dev) | [npm](https://www.npmjs.com/package/kagi-cli) | [mcp](https://kagi.micr.dev/commands/mcp)
 
 ![search demo](images/demos/search.gif)
 
@@ -470,6 +470,7 @@ for the fuller install matrix and platform-specific setup, use the [installation
 - [quickstart guide](https://kagi.micr.dev/guides/quickstart)
 - [authentication guide](https://kagi.micr.dev/guides/authentication)
 - [workflows](https://kagi.micr.dev/guides/workflows)
+- [mcp command](https://kagi.micr.dev/commands/mcp)
 
 ## contributing
 

docs/commands/mcp.mdx

@@ -13,6 +13,56 @@ Run a stdio JSON-RPC server that exposes Kagi tools for agents.
 kagi mcp
 ```
 
+## Use with Codex
+
+`kagi mcp` is a stdio server. You normally do not run it in a separate terminal; your MCP client launches it when it needs Kagi tools.
+
+Start by making sure `kagi` works from your shell:
+
+```bash
+kagi auth status
+kagi auth check
+```
+
+Then add it to Codex:
+
+```bash
+codex mcp add kagi-mcp -- "$(command -v kagi)" mcp
+```
+
+Check the saved entry:
+
+```bash
+codex mcp get kagi-mcp
+```
+
+You should see `command` pointing at the `kagi` binary and `args` set to `mcp`.
+
+If Codex will not run from the directory that contains your `./.kagi.toml`, pass credentials through the MCP entry instead:
+
+```bash
+codex mcp add kagi-mcp \
+  --env KAGI_SESSION_TOKEN="$KAGI_SESSION_TOKEN" \
+  -- "$(command -v kagi)" mcp
+```
+
+Use only the environment values you need. `KAGI_SESSION_TOKEN` unlocks subscriber-backed search, Quick Answer, and news search. Add `--env KAGI_API_KEY="$KAGI_API_KEY"` when you want current `/api/v1` Search or Extract. Add `--env KAGI_API_TOKEN="$KAGI_API_TOKEN"` when you want the legacy public summarizer.
+
+If you previously used the separate `kagi-mcp` wrapper, replace it with the native CLI server:
+
+```bash
+codex mcp remove kagi-mcp
+codex mcp add kagi-mcp -- "$(command -v kagi)" mcp
+```
+
+Restart Codex after changing MCP entries so the tool list is rediscovered.
+
+To use a named profile from `./.kagi.toml`, put `--profile` after `mcp`:
+
+```bash
+codex mcp add kagi-work -- "$(command -v kagi)" mcp --profile work
+```
+
 ## Tools
 
 - `kagi_search` - search Kagi