# omp-worker-mcp Documentation **Comprehensive guides, architectural workflows, client configurations, and operational references for `omp-worker-mcp`.**

English • 简体中文 • Back to Root README

--- ## Overview Welcome to the `omp-worker-mcp` documentation hub. This directory contains in-depth documentation covering agent supervisor workflows, multi-client stdio integration guides, operational state management, and complete MCP tool references. If you are looking for a high-level project summary or quick start instructions, please visit the root [README](../README.md). --- ## Documentation Layout To maintain clear boundaries and eliminate redundant content, documentation responsibilities are divided across dedicated guides: | Document | Primary Scope & Responsibilities | Key Topics Covered | | :--- | :--- | :--- | | [**Author Workflow Enablement & Architecture**](author-workflow.md) | Enablement tutorial, policy templates, and architecture reference. | • Tool availability, direct namespace access, and selection policy
• Codex-specific `direct_only_tool_namespaces` setup
• Reusable project-level policy templates (`AGENTS.md` / `CLAUDE.md`)
• Verification prompt and observable behavior
• Host-Worker supervision loop (6-step lifecycle)
• Execution strategy matrix (Direct vs. Single vs. Batch DAG)
• Author's personal Gemini/Antigravity setup (non-guaranteed reference)
• Safety guardrails for documenting workflows | | [**Client Configurations**](client-configurations.md) | MCP host harness connection and configuration guides. | • Local stdio compatibility prerequisites
• Evidence-based support tiers (Verified vs. Documented vs. Conditional)
• Generic `mcpServers` JSON template
• Client setups (Codex, Claude Code, Cursor, VS Code / Copilot, Windsurf, Continue)
• Official reference links and direct-use boundaries | | [**ChatGPT Secure MCP Tunnel Guide**](chatgpt-secure-tunnel.md) | Remote Supervisor-Worker setup connecting ChatGPT Web to local `omp-worker-mcp`. | • OpenAI `tunnel-client` stdio MCP connection
• `OMP_WORKER_ALLOWED_ROOTS` workspace allowlisting
• symlink / junction escape protection
• runtime health checks and trust boundaries | | [**Operations & State Lifecycle**](operations.md) | Runtime configuration, persistence internals, and operational maintenance. | • Environment variable reference table
• On-disk state directory layout (`~/.codex/state/omp-worker`)
• Retention and cleanup policies (TTL & size bounds)
• Server restart, crash safety, and process decoupling | | [**Tool Reference & Safety Contract**](tool-reference.md) | Detailed specifications for all exposed MCP tools and security contracts. | • Single-task delegation tools (`omp_run_compact`, `omp_delegate`, etc.)
• Batch and DAG orchestration tools (`omp_run_batch_compact`, etc.)
• Path ownership isolation rules (`write` vs. `read_only`)
• Structured output envelope contract (`OMP_WORKER_RESULT`) | | [**Official MCP Registry Publishing Guide**](registry-publishing.md) | Maintainer release workflow for npm and the Official MCP Registry. | • Key metadata files (`package.json`, `server.json`)
• Release sequence (npm publish & MCP Publisher CLI)
• Version verification and publishing safety boundaries | --- ## Quick Navigation - **New to Agent Delegation?** Start with [Author Workflow Enablement & Architecture](author-workflow.md) to enable project policies and understand the Host-Worker paradigm. - **Configuring your MCP client?** Head over to [Client Configurations](client-configurations.md) for verified configs and templates. - **Calling local OMP from ChatGPT Web?** Read the [ChatGPT Secure MCP Tunnel Guide](chatgpt-secure-tunnel.md). - **Managing production or CI environments?** Check [Operations & State Lifecycle](operations.md) for retention settings and state layout. - **Developing agent prompts or custom integrations?** Consult the [Tool Reference & Safety Contract](tool-reference.md). - **Publishing or maintaining releases?** Review the [Official MCP Registry Publishing Guide](registry-publishing.md). --- ## Language Synchronization Every document in this directory is maintained synchronously in both English and Simplified Chinese: - **English**: `docs/.md` - **简体中文**: `docs/.zh-CN.md`