Install via Claude Code & Claude Desktop

The mctx marketplace works with Claude Code. You can install any App through the CLI in Claude Code, or connect directly via the Connectors panel in Claude Desktop.

Claude Code

Add the mctx marketplace

Run this once to register the mctx marketplace with Claude Code:

/plugin marketplace add https://mctx.ai/marketplace.json

This tells Claude Code where to find mctx plugins. You only need to do this once — the marketplace persists across sessions.

Browse available servers

After adding the marketplace, you can see what is available:

/plugin list

Apps from the mctx marketplace appear alongside any other plugins you have installed. Each entry shows the App name, description, and version.

Install a server

Install any server from the marketplace:

/plugin install {slug}@mctx

Replace {slug} with the App's slug — the short identifier that appears in the App's URL and on its mctx page. For example, if the App's page is at mctx.ai/apps/weather-api, the slug is weather-api:

/plugin install weather-api@mctx

The @mctx suffix tells Claude Code which marketplace to use when there are multiple sources with similar names.

Claude Desktop

Claude Desktop supports custom connectors. You can add any mctx App directly through the Customize panel without using a terminal.

Install a server

1. Open Claude Desktop
2. Click Customize (toolbox icon) in the left pane → click Connectors
3. Click + (top right) → click Add custom connector
4. Fill in the App name and the URL from the App's page, then click Add and authenticate

The App URL follows the pattern https://{slug}.mctx.ai. You can find the exact URL and name on the App's page at mctx.ai/apps/{slug} or in your subscription details.

Claude Desktop sets up the MCP connection automatically — no manual config file editing needed.

What installing does

MCP connection — The App is added to your MCP configuration. You do not need to edit any config files manually.

For Claude Code (plugin marketplace): An about skill is also loaded into Claude's context. It describes what the App does, what tools it provides, and how to use it. Claude has this information available when you ask it to use the App.

Authentication

You do not need to set up authentication before installing. The first time Claude connects to the App, it opens your browser for an OAuth sign-in. Sign in with the same mctx account you used to subscribe, and Claude stores the token securely.

After that first sign-in, authentication is handled automatically. You will not be prompted again unless your token expires.

If you have not subscribed yet — visit the App's page at mctx.ai/apps/{slug} and subscribe first. Without an active subscription, the App will return a 402 error when Claude tries to connect.

Verify the installation

After installing via Claude Code, confirm the App is in your MCP list:

claude mcp list

You should see the App listed. If it is not there, try reinstalling or check that the marketplace is still registered with /plugin list.

Uninstall a server

Claude Code:

/plugin uninstall {slug}

Claude Desktop: Click Customize (toolbox icon) → Connectors, find the App, and remove it.

In both cases, the MCP connection and skill are removed from your configuration. Your subscription is not canceled — you can reinstall at any time without resubscribing.

Troubleshooting

The marketplace does not show any servers

The mctx marketplace only lists Apps that developers have explicitly published for Claude Code. Not every mctx App is in the marketplace — developers must enable the Claude Code toggle from their dashboard. If an App you want is not listed, try the manual install method or contact the developer.

Authentication keeps failing

Make sure you are signing in with the same mctx account you used to subscribe. If you have multiple accounts, the subscription is tied to one specific account and only that account will be authorized.

The App appears installed but tools are not loading

Wait a few seconds and try again — some clients need a moment after OAuth completes. If tools still do not appear, run claude mcp list to confirm the App entry exists and the URL looks correct.

See something wrong? Report it or suggest an improvement — your feedback helps make these docs better.