docs: add best practices for server and client implementors#36

Draft

tadasant wants to merge 11 commits into

mainfrom

docs/best-practices

Commits on Jun 26, 2026

docs: add best practices for server and client implementors

tadasant
and
claude
committed
docs: use precise MCP Catalog terminology in best practices

tadasant
and
claude
committed
docs: frame Server Card as a standalone connection entry point

tadasant
and
claude
committed
docs: keep Server Card auth framing advisory, tighten prose

tadasant
and
claude
committed
docs: make client-side domain probing specific with concrete hook points

tadasant
and
claude
committed
docs: match CORS/cache wording to discovery.md normative levels

tadasant
and
claude
committed
docs: focus best practices on AI Catalog, drop MCP Catalog references

tadasant
and
claude
committed
docs: ground client discovery in concrete Goose integration points

tadasant
and
claude
committed
docs: scope normative pointer to Server Cards, soften Goose tool naming

tadasant
and
claude
committed
docs: add network-egress discovery option, frame client probing as a spectrum

tadasant
and
claude
committed
docs: clarify breadth cost in egress discovery option

tadasant
and
claude
committed