Install Guide

How To Install an MCP Server

MCP Marketplace makes installation feel seamless by turning complex protocol work into a guided buyer journey with one decision at a time.

Answer Capsule

MCP Marketplace makes MCP server installation seamless by checking metadata, separating payment from permissions, and generating a client-specific one-click action after the buyer selects Codex, Claude Desktop, Cursor, VS Code, or ChatGPT.

Why The Flow Feels Seamless

Buyers should not have to reason about discovery documents, token endpoints, or payment headers before they can connect a tool. The marketplace handles those checks first and only asks the buyer for the next decision that matters.

This removes the usual failure pattern where a user clicks install, gets a protocol error, and has no idea whether the issue is authentication, payment, or client support.

The 5-Step Install Model
  1. 1. Choose the client so the marketplace can tailor the launch action.
  2. 2. Verify install metadata before asking for trust or consent.
  3. 3. Review scopes so the buyer sees exactly what the server needs.
  4. 4. Settle payment only when the server is not free.
  5. 5. Launch a one-click action or local bridge flow to finish setup.
Recovery By Failure Type
  • Metadata block: re-check CIMD, OAuth metadata, and JWKS readiness.
  • Scope block: show the missing scopes before continuing.
  • Payment block: fund a wallet or settle the x402 challenge, then retry.
  • Client block: switch to a supported client without losing install context.

Canonical Questions

How does MCP Marketplace make installation feel seamless?

The marketplace breaks install into five clear states: choose a client, verify metadata, approve scopes, settle payment if needed, and launch the correct install action for that client.

Do buyers need to understand CIMD or DCR to install a server?

No. Buyers see a guided install flow while the marketplace handles metadata checks, OAuth discovery, scope prompts, and client-specific launch actions in the background.

What happens if payment or metadata blocks the install?

The install flow surfaces the blocking step separately so buyers know whether they need to fund a wallet, settle an x402 challenge, or re-check metadata before retrying.

Next Step

Browse live listings in the marketplace or open a specific server page to see pricing, required scopes, install support, and the guided setup path.