These guides take you from a specific problem to a result you can verify. New to MCPProxy? Install it first, then follow the Quick Start.
| Your task | What you will finish with |
|---|---|
| Reuse one MCP setup in two AI clients | Claude Code and Codex using the same upstream, with a successful call from each recorded in Activity. |
| Find out why an agent cannot use a tool | A diagnosed connection, approval, access or call failure, followed by a verified retry. |
| Discover tools on demand | A measured comparison of initial tool definitions and a successful call through discovery. |
| Review a tool before use | A deliberate approval decision for a new server and a changed tool definition. |
Choose the right reference
- How tools reach the agent: Routing modes explains discovery, direct tools and code execution. The two-client guide uses the default
retrieve_toolsmode. - What a client can access: Profiles and agent tokens cover access restrictions.
- What is held for review: Security quarantine explains server admission and tool changes.
- Exact flags and fields: use the CLI, configuration and REST API references.