> For the complete documentation index, see [llms.txt](https://modelmesh.gitbook.io/cline-zhong-wen-ban-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://modelmesh.gitbook.io/cline-zhong-wen-ban-docs/mcp-marketplace.md).

# MCP Marketplace

#### What's an MCP Server? <a href="#whats-an-mcp-server" id="whats-an-mcp-server"></a>

MCP servers are specialized extensions that enhance Cline's capabilities. They enable Cline to perform additional tasks like fetching web pages, processing images, accessing APIs, and much more.

#### MCP Marketplace Walkthrough <a href="#mcp-marketplace-walkthrough" id="mcp-marketplace-walkthrough"></a>

The MCP Marketplace provides a one-click installation experience for hundreds of MCP servers across various categories.

**1. Access the Marketplace**

* In Cline, click the "Extensions" button (square icon) in the top toolbar
* The MCP marketplace will open, showing available servers by category

**2. Browse and Select a Server**

* Browse servers by category (Search, File-systems, Browser-automation, Research-data, etc.)
* Click on a server to see details about its capabilities and requirements

**3. Install and Configure**

* Click the install button for your chosen server
* If the server requires an API key (most do), Cline will guide you through:
  * Where to get the API key
  * How to enter it securely
* The server will be added to your MCP settings automatically

**4. Verify Installation**

* Cline will show confirmation when installation is complete
* Check the server status in Cline's MCP settings UI

**5. Using Your New Server**

* After successful installation, Cline will automatically integrate the server's capabilities
* You'll see new tools and resources available in Cline's system prompt
* Simply ask Cline to use the capabilities of your new server
* Example: "Search the web for recent React updates using Perplexity"

**Corporate Users:** If you're using Cline in a corporate environment, ensure you have permission to install third-party MCP servers according to your organization's security policies.

#### What Happens Behind the Scenes <a href="#what-happens-behind-the-scenes" id="what-happens-behind-the-scenes"></a>

When you install an MCP server, several things happen automatically:

**1. Installation Process**

* The server code is cloned/installed to `/Users/<username>/Documents/Cline/MCP/`
* Dependencies are installed
* The server is built (TypeScript/JavaScript compilation or Python package installation)

**2. Configuration**

* The MCP settings file is updated with your server configuration
* This file is located at: `/Users/<username>/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
* Environment variables (like API keys) are securely stored
* The server path is registered

**3. Server Launch**

* Cline detects the configuration change
* Cline launches your server as a separate process
* Communication is established via stdio or HTTP

**4. Integration with Cline**

* Your server's capabilities are added to Cline's system prompt
* Tools become available via `use_mcp_tool` commands
* Resources become available via `access_mcp_resource` commands
* Cline can now use these capabilities when prompted by the user

#### Troubleshooting <a href="#troubleshooting" id="troubleshooting"></a>

**System Requirements**

Make sure your system meets these requirements:

* **Node.js 18.x or newer**
  * Check by running: `node --version`
  * Install from: <https://nodejs.org/>
  * Required for JavaScript/TypeScript implementations
* **Python 3.10 or newer**
  * Check by running: `python --version`
  * Install from: <https://python.org/>
  * Note: Some specialized implementations may require Python 3.11+
* **UV Package Manager**
  * Modern Python package manager for dependency isolation
  * Install using:

    Copy

    ```
    curl -LsSf https://astral.sh/uv/install.sh | sh
    ```

    Or: `pip install uv`
  * Verify with: `uv --version`

If any of these commands fail or show older versions, please install/update before continuing!

**Common Installation Issues**

* Ensure your internet connection is stable
* Check that you have the necessary permissions to install new software
* Verify that the API key was entered correctly (if required)
* Check the server status in the MCP settings UI for any error messages

**How to Remove an MCP Server**

To completely remove a faulty MCP server:

1. Open the MCP settings file: `/Users/<username>/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
2. Delete the entire entry for your server from the `mcpServers` object
3. Save the file
4. Restart Cline

**I'm Still Getting an Error**

If you're getting an error when using an MCP server, you can try the following:

* Check the MCP settings file for errors
* Use a Claude Sonnet model for installation
* Verify that paths to your server's files are correct
* Ensure all required environment variables are set
* Check if another process is using the same port (for HTTP-based servers)
* Try removing and reinstalling the server (remove from both the `cline_mcp_settings.json` file and the `/Users/<username>/Documents/Cline/MCP/` directory)
* Use a terminal and run the command with its arguments directly. This will allow you to see the same errors that Cline is seeing

#### MCP Server Rules <a href="#mcp-server-rules" id="mcp-server-rules"></a>

Cline is already aware of your active MCP servers and what they are for, but when you have a lot of MCP servers enabled, it can be useful to define when to use each server.

Utilize a `.clinerules` file or custom instructions to support intelligent MCP server activation through keyword-based triggers, making Cline's tool selection more intuitive and context-aware.

**How MCP Rules Work**

MCP Rules group your connected MCP servers into functional categories and define trigger keywords that activate them automatically when detected in your conversations with Cline.

Copy

```
{
  "mcpRules": {
    "webInteraction": {
      "servers": [
        "firecrawl-mcp-server",
        "fetch-mcp"
      ],
      "triggers": [
        "web", "scrape", "browse", "website"
      ],
      "description": "Tools for web browsing and scraping"
    }
  }
}
```

**Configuration Structure**

1. **Categories**: Group related servers (e.g., "webInteraction", "mediaAndDesign")
2. **Servers**: List server names in each category
3. **Triggers**: Keywords that activate these servers
4. **Description**: Human-readable category explanation

**Benefits of MCP Rules**

* **Contextual Tool Selection**: Cline selects appropriate tools based on conversation context
* **Reduced Friction**: No need to manually specify which tool to use
* **Organized Capabilities**: Logically group related tools and servers
* **Prioritization**: Handle ambiguous cases with explicit priority ordering

**Example Usage**

When you write "Can you scrape this website?", Cline detects "scrape" and "website" as triggers, automatically selecting web-related MCP servers.

For finance tasks like "What's Apple's stock price?", keywords like "stock" and "price" trigger finance-related servers.

**Quick Start Template**

Copy

```
{
  "mcpRules": {
    "category1": {
      "servers": [
        "server-name-1",
        "server-name-2"
      ],
      "triggers": [
        "keyword1", "keyword2", "phrase1", "phrase2"
      ],
      "description": "Description of what these tools do"
    },
    "category2": {
      "servers": [
        "server-name-3"
      ],
      "triggers": [
        "keyword3", "keyword4", "phrase3"
      ],
      "description": "Description of what these tools do"
    },
    "category3": {
      "servers": [
        "server-name-4",
        "server-name-5"
      ],
      "triggers": [
        "keyword5", "keyword6", "phrase4"
      ],
      "description": "Description of what these tools do"
    }
  },
  "defaultBehavior": {
    "priorityOrder": [
      "category1",
      "category2",
      "category3"
    ],
    "fallbackBehavior": "Ask user which tool would be most appropriate"
  }
}
```

Add this to your `.clinerules` file or to your custom instructions to make Cline's MCP server selection more intuitive and context-aware.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://modelmesh.gitbook.io/cline-zhong-wen-ban-docs/mcp-marketplace.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.