From effafd2c0b6f3c941c921660bb92569c4295d478 Mon Sep 17 00:00:00 2001
From: server <server@jakubkadlec.dev>
Date: Tue, 14 Apr 2026 12:08:04 +0200
Subject: [PATCH] Document Codex and Claude Code MCP setup

---
 README.md           |  1 +
 docs/agent-setup.md | 67 +++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 68 insertions(+)
 create mode 100644 docs/agent-setup.md

diff --git a/README.md b/README.md
index 0b414e2..cb5c736 100644
--- a/README.md
+++ b/README.md
@@ -157,3 +157,4 @@ Export a client config header for `m2dev-client-src/src/PackLib/M2PackKeys.h`:
 
 See [docs/format.md](docs/format.md) and
 [docs/client-integration.md](docs/client-integration.md).
+For Codex and Claude Code MCP setup, see [docs/agent-setup.md](docs/agent-setup.md).
diff --git a/docs/agent-setup.md b/docs/agent-setup.md
new file mode 100644
index 0000000..c607c8a
--- /dev/null
+++ b/docs/agent-setup.md
@@ -0,0 +1,67 @@
+# Agent setup
+
+This repository ships a Python MCP server for local Linux workflows.
+
+## Paths on the current host
+
+- Python: `/home/mt2.jakubkadlec.dev/metin/repos/m2pack-secure/.venv-mcp/bin/python`
+- MCP server: `/home/mt2.jakubkadlec.dev/metin/repos/m2pack-secure/mcp_server.py`
+- `m2pack` binary: `/home/mt2.jakubkadlec.dev/metin/repos/m2pack-secure/build/m2pack`
+
+## Codex
+
+Use this MCP server entry:
+
+```json
+{
+  "mcpServers": {
+    "m2pack-secure": {
+      "command": "/home/mt2.jakubkadlec.dev/metin/repos/m2pack-secure/.venv-mcp/bin/python",
+      "args": [
+        "/home/mt2.jakubkadlec.dev/metin/repos/m2pack-secure/mcp_server.py"
+      ],
+      "env": {
+        "M2PACK_BINARY": "/home/mt2.jakubkadlec.dev/metin/repos/m2pack-secure/build/m2pack"
+      }
+    }
+  }
+}
+```
+
+## Claude Code
+
+Use the same stdio server config:
+
+```json
+{
+  "mcpServers": {
+    "m2pack-secure": {
+      "command": "/home/mt2.jakubkadlec.dev/metin/repos/m2pack-secure/.venv-mcp/bin/python",
+      "args": [
+        "/home/mt2.jakubkadlec.dev/metin/repos/m2pack-secure/mcp_server.py"
+      ],
+      "env": {
+        "M2PACK_BINARY": "/home/mt2.jakubkadlec.dev/metin/repos/m2pack-secure/build/m2pack"
+      }
+    }
+  }
+}
+```
+
+## Local verification
+
+```bash
+cd /home/mt2.jakubkadlec.dev/metin/repos/m2pack-secure
+. .venv-mcp/bin/activate
+python scripts/mcp_smoke_test.py
+```
+
+## Exposed tools
+
+- `pack_keygen`
+- `pack_build`
+- `pack_list`
+- `pack_verify`
+- `pack_extract`
+- `pack_export_client_config`
+- `pack_binary_info`