ContextKeep Codex MCP Handshake Fix
active
Edit Selected
Issue on 2026-03-19: Codex failed to start MCP client for ContextKeep with handshake error. Error showed Codex using a streamable HTTP client and receiving text/plain 405 Method Not Allowed during initialize. Root cause: /home/svc-admin/.codex/config.toml had ContextKeep registered as url = http://127.0.0.1:5100/sse, which Codex interpreted as transport=streamable_http. Local ContextKeep server at /home/svc-admin/ai-projects/projects/homelab/contextkeep/server.py supports stdio and sse, not streamable HTTP. Server log confirmed GET /sse returned 200 but POST /sse returned 405. Fix applied: removed MCP registration and re-added ContextKeep as a stdio server using command /home/svc-admin/ai-projects/projects/homelab/contextkeep/venv/bin/python with arg /home/svc-admin/ai-projects/projects/homelab/contextkeep/server.py. Verification: codex mcp get contextkeep now reports transport: stdio, and contextkeep-server plus contextkeep-webui systemd services were active. Expected result after restarting Codex: no startup handshake error for ContextKeep.