Pick the quadrant that matches what you're trying to do.
These docs follow the Diátaxis framework: tutorials for learning, how-to guides for solving specific problems, reference for looking things up, and explanation for understanding the design.
Diátaxis quadrants
Four kinds of doc, four reasons to read
Tutorials
Learning-oriented walkthroughs. Follow them top-to-bottom; designed so you cannot fail if you copy carefully.
How-to guides
Task-oriented recipes. Each one solves a single problem and assumes you already know how to start the gateway.
Reference
Information-oriented technical descriptions. Look here for the exact answer to "what does this field do?"
Explanation
Understanding-oriented discussion. Make the right design call, not just copy a recipe.
Start here
First time with mcpgw?
Reference
Looking up a specific fact
Configuration schema
Every key in mcpgw.yaml.
Policy rule schema
Full grammar for policy.rules[].
OpenTelemetry semantic conventions
Span names, attributes, enum values.
Audit log schema
Every field in audit.jsonl.
Error codes
Every JSON-RPC + HTTP code mcpgw can return.
CLI commands and flags
mcpgw server, stdio, key generate, healthcheck, version.