mcpstepbystep

curated 2026-07 · official sources only

The resource shelf

Every link is a primary source — the spec itself, official docs, the actual repos — annotated with why it earns a place. No listicles, no mirrors. For our opinion on what to adopt, see the radar.

Official MCP

  • modelcontextprotocol.io ↗

    The official documentation hub — concepts, quickstarts, and SDK guides. Start with the server quickstart.

  • Specification (2025-11-25) + changelog ↗

    The current normative spec; the changelog is the fastest way to see what each revision actually changed.

  • SDK documentation ↗

    The per-language SDK index — which tier each SDK sits in and where its docs live.

  • MCP Inspector ↗

    Official docs for the debugging tool you will use most: npx it against any server, in UI or CLI mode.

  • MCP Registry ↗

    The official server registry (preview) — reverse-DNS namespaces, published via the mcp-publisher CLI.

  • MCP blog ↗

    Announcements from the spec maintainers — the primary source for spec revisions and working-group decisions.

SDKs & repos

  • python-sdk ↗

    The official Python SDK (PyPI package mcp) — FastMCP 1.0 server class, clients, and transports.

  • typescript-sdk ↗

    The official TypeScript SDK (@modelcontextprotocol/sdk) — McpServer, transports, and client code.

  • servers ↗

    Reference server implementations — the best place to read idiomatic tool, resource, and prompt code.

  • inspector ↗

    Source for the Inspector, including the CLI mode flags that make it scriptable in CI.

Client docs

  • Claude Code MCP docs ↗

    claude mcp add, transport flags, scopes, and the .mcp.json project file — the reference for wiring servers into Claude Code.

  • Claude Desktop setup ↗

    The official walkthrough for claude_desktop_config.json — where it lives and why absolute paths matter.

  • Cursor MCP docs ↗

    Cursor's .cursor/mcp.json format and its per-project versus global server configuration.

  • VS Code Copilot MCP ↗

    VS Code's native MCP support — adding servers, trust prompts, and agent-mode tool use.

  • OpenAI connectors / MCP ↗

    What ChatGPT connectors require of your remote server — OAuth 2.1, DCR, and tool-surface rules.

  • Cloudflare remote MCP guide ↗

    The most complete deploy-a-remote-server walkthrough: Workers hosting plus OAuth scaffolding.

Learning

Security

  • Security best practices (spec) ↗

    The normative page naming the real attacks — confused deputy, token passthrough, session hijacking — and the required mitigations.

  • Authorization (spec) ↗

    The OAuth resource-server model in full: RFC 8707 resource indicators and RFC 9728 protected-resource metadata.

  • OWASP MCP cheat sheet ↗

    A practitioner checklist for MCP deployments — tool poisoning, supply-chain, and permission-scoping guidance in one page.

newsletter

One practical MCP guide in your inbox. No news, no hype.

Tutorials and decision frameworks as they ship. Unsubscribe anytime.