mcp

Kit recipe vs OSS MCP boilerplate (honest)

An open-source MCP boilerplate gives you a scaffold: a server skeleton, a few stub tools, and usually a local stdio setup. A kit-backed remote OAuth recipe gives you the Connect path end to end: Protected Resource Metadata (PRM), surviving the 401 challenge, PKCE, the drift between Cursor and Claude, the static CLIENT_ID path when DCR isn’t available, and a failure card for when Connect breaks. They do different jobs, so this page compares jobs, not scores. If your server only runs over stdio on your own machine, a free OSS boilerplate may be all you need.

Who this is for

Builders who have cloned an MCP template, gotten tools working locally, and then hit a wall when the server has to be remote and authenticated for Cursor and Claude. If your server only runs over stdio on your own machine, a free OSS boilerplate may be all you need, and that's fine. If the question is "why does Connect fail after the browser hop?", keep reading.

This is not a "best MCP starter kit" listicle. There's no leaderboard here, no ranked scores, and no SaaS-boilerplate comparison. It's one honest contrast between two kinds of starting point.

What OSS MCP boilerplates usually own

Most open-source MCP templates do a solid job at:

  • Server skeleton: transport wiring, a request handler, project layout.
  • Tool stubs: one or two example tools that show the schema shape.
  • Local-first setup: stdio transport, run it next to your editor, no auth needed.
  • Community breadth: many languages and frameworks, free to fork.

What they often leave to you is the remote auth story: discovery metadata, challenge headers, client registration, and the small ways different MCP clients read the same spec. That isn't a flaw. A scaffold is a scaffold. But auth drift is where most "it works locally" servers stop working.

What a kit-backed remote OAuth recipe owns

The MCP Starter Kit is opinionated about the part boilerplates skip:

  • PRM: serving the protected-resource metadata clients look for, so discovery doesn't dead-end.
  • Challenge survival: a `401` with the right `WWW-Authenticate` shape, so the client actually starts OAuth instead of giving up.
  • PKCE: done the way the clients expect, not "almost."
  • Cursor vs Claude drift: where the two clients differ on redirect handling and registration, and how one server serves both.
  • Static `CLIENT_ID` path: for when Dynamic Client Registration isn't available or isn't wanted. Field names live in docs and secret values live in env, never in a published `mcp.json`.
  • Failure card: symptom → likely cause → fix, so you're reading a known list instead of guessing.

The full walkthrough is in the live pillar: Build a remote MCP server with OAuth that Cursor and Claude can both Connect to.

Contrast table (jobs, not scores)

JobTypical OSS MCP boilerplateKit-backed remote OAuth recipe
Server skeleton + tool stubsYes, its core jobIncluded, but not the point
Local stdio dev loopYesYes
Remote transportSometimesYes
PRM / discovery metadataUsually left to youYes
`401` challenge shapeUsually left to youYes
PKCE flow wired for real clientsVariesYes
Cursor vs Claude Connect differencesRarely coveredYes, documented
Static `CLIENT_ID` (non-DCR) pathRarely coveredYes
Failure card for Connect errorsRarelyYes
PriceFree$27

Read it as "who does which job." Neither column wins. If your rows are all at the top of the table, free is the right answer.

When OSS is enough vs when the kit earns its keep

OSS is enough when:

  • The server is local-only (stdio) and only you use it.
  • You're learning MCP and want to read a variety of scaffolds.
  • You already know OAuth well and want to wire discovery and PKCE yourself.

The kit earns its keep when:

  • The server has to be remote and authenticated for Cursor and Claude.
  • You've already lost an afternoon to "Connect opens the browser, then nothing."
  • You want a working recipe and a failure card instead of piecing together specs, issues, and forum threads.

Either way, keep secrets out of examples: name env vars, never paste values. See never put secrets in chat.

Proof of category: the live pillar

You don't have to buy anything to see what the kit's approach looks like. The MCP OAuth pillar walks through the same Connect path in public. The kit packages that path as a working recipe, plus the failure card and client-drift notes, so you aren't rebuilding it from the article.

Soft next step

Write down which rows of the contrast table your server actually needs. If they're all scaffold rows, stay on your OSS boilerplate. If any are auth rows, read the MCP OAuth pillar first, start on /free, and pick up the MCP Starter Kit ($27) when you want the recipe in hand. No rush, and the table is useful either way.

FAQ

Is ShipKits’ MCP Starter Kit just another OSS wrapper?+

No. It isn’t a rebranded scaffold. Its job is the remote OAuth Connect path (PRM, challenge, PKCE, Cursor/Claude drift, static CLIENT_ID) plus a failure card. The skeleton is included, but it isn’t what you’re paying for.

When is a free OSS boilerplate enough?+

When the server is local stdio, single-user, or a learning project, or when you’re comfortable wiring OAuth discovery yourself. Free is the right call there.

Does a kit replace reading Cursor’s and Claude’s MCP docs?+

No. Client docs are still the source of truth and they change. The kit gives you a working reference path and tells you where the clients tend to differ, so the docs make sense faster.

How is this different from “best MCP starter kit” listicles?+

This page doesn’t rank anything. It compares two jobs, scaffold vs auth recipe, so you can tell which one your problem needs.

Can I start with an OSS boilerplate and add the kit later?+

Yes. A common path is to prove your tools locally on a free scaffold, then bring in the recipe when you go remote and Connect starts failing.

What’s the soft next step if Connect still fails?+

Check the failure-card order in the OAuth pillar: discovery, then challenge, then registration, then redirect.

Get the free starter

Value first, then a kit when you are ready. No fake urgency. Start with Harness Desk Starter at /free.