Setup Guide

Prerequisites

For Python-based MCP servers:

Install uv (uvx) globally - Installation Guide

For Node.js-based MCP servers:

Install Node.js (npx) globally - Download Node.js

Installation

Remote SSE Access

You can access directly via SSE endpoint:

http://localhost:12007/sse with Authorization: Bearer <create an api key first>

Alternatively, if you cannot set headers, you can use this URL-based endpoint:

http://localhost:12007/api-key/<create an api key first>/sse

Legacy Installation Methods (for local access): you can still use this even if your workspace is in Default Remote Mode

Notice: you can manage your API Keys in the API Keys Page

Manual Configuration

For Claude Desktop, locate the configuration file at:

macOS:

 ~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

 %APPDATA%\Claude\claude_desktop_config.json

Generally the JSON Configuration Template will look like this:

{
  "mcpServers": {
    "MetaMCP": {
      "command": "npx",
      "args": ["-y", "@metamcp/mcp-server-metamcp@latest"],
      "env": {
        "METAMCP_API_KEY": "<create an api key first>",
        "METAMCP_API_BASE_URL": "http://localhost:12005"
      }
    }
  }
}

Cursor Configuration

For Cursor, you can configure MetaMCP directly in the settings:

Open Cursor and go to Cursor Settings
Navigate to the Features section
Find 'MCP Servers' and click 'Add new MCP Server'
Use the following command:

npx -y @metamcp/mcp-server-metamcp@latest --metamcp-api-key <create an api key first> --metamcp-api-base-url http://localhost:12005

Windows Configuration

For Windows, you can use the following configuration options:

You can use the following command for Cursor:

cmd /c npx -y @metamcp/mcp-server-metamcp@latest --metamcp-api-key <create an api key first> --metamcp-api-base-url http://localhost:12005

Or configure it using json:

{
  "mcpServers": {
    "MetaMCP": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@metamcp/mcp-server-metamcp@latest"
      ],
      "env": {
        "METAMCP_API_KEY": "<create an api key first>",
        "METAMCP_API_BASE_URL": "http://localhost:12005"
      }
    }
  }
}

Standalone SSE Server

You can also use the following command to start a standalone SSE server:

mcp-server-metamcp --metamcp-api-key <create an api key first> --transport sse --port 12006

Then use following json configuration:

{
  "mcpServers": {
    "MetaMCP": {
      "url": "http://localhost:12006"
    }
  }
}

Smithery Windows Configuration

We recommend to use Smithery to run MCPs in docker on cloud for max compatibility. To setup Smithery CLI on Windows check this out: https://smithery.ai/docs/smithery-cli.

Visit MetaMCP server listing directly on Smithery: https://smithery.ai/server/@metatool-ai/mcp-server-metamcp

For Smithery on Windows, you can also use the following configuration options:

You can run the Smithery command directly in your terminal:

smithery run @metatool-ai/mcp-server-metamcp --config '{"metamcpApiKey":"<create an api key first>"}'

Or configure it in your Claude Desktop configuration file:

{
  "mcpServers": {
    "MetaMCP": {
      "command": "smithery",
      "args": [
        "run",
        "@metatool-ai/mcp-server-metamcp",
        "--config",
        "{\"metamcpApiKey\":\"<create an api key first>\"}"
      ]
    }
  }
}