docs: improve MCP API documentation structure and formatting#1514

jdorfman wants to merge 3 commits intomainsourcegraph/docs:mainfrom

jd/mcp-tocsourcegraph/docs:jd/mcp-tocCopy head branch name to clipboard