General Stdio Integration using `mcp-proxy` with API Key

General Stdio Integration allows any MCP client that supports stdio servers to connect to MetaMCP’s remote endpoints. Since MetaMCP endpoints are remote-only (SSE, Streamable HTTP), you’ll need a local proxy to bridge the connection.

Prerequisites

Before starting, ensure you have:

MCP client that supports stdio servers (Claude Desktop, Cursor, etc.)
MetaMCP running locally or deployed
Active endpoint configured in MetaMCP
API key generated (if authentication is enabled)
mcp-proxy installed (uvx mcp-proxy)

Basic Configuration

Using mcp-proxy (Required)

Since MetaMCP endpoints are remote only, you need mcp-proxy to convert between stdio and HTTP/SSE protocols.

{
  "mcpServers": {
    "MetaMCP": {
      "command": "uvx",
      "args": [
        "mcp-proxy",
        "--transport",
        "streamablehttp",
        "http://localhost:12008/metamcp/your-endpoint-name/mcp"
      ],
      "env": {
        "API_ACCESS_TOKEN": "sk_mt_your_api_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "MetaMCP": {
      "command": "uvx",
      "args": [
        "mcp-proxy",
        "http://localhost:12008/metamcp/your-endpoint-name/sse"
      ],
      "env": {
        "API_ACCESS_TOKEN": "sk_mt_your_api_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "MetaMCP-Dev": {
      "command": "uvx",
      "args": [
        "mcp-proxy",
        "--transport",
        "streamablehttp",
        "http://localhost:12008/metamcp/dev-tools/mcp"
      ],
      "env": {
        "API_ACCESS_TOKEN": "sk_mt_dev_key"
      }
    },
    "MetaMCP-Research": {
      "command": "uvx",
      "args": [
        "mcp-proxy",
        "http://localhost:12008/metamcp/research-tools/sse"
      ],
      "env": {
        "API_ACCESS_TOKEN": "sk_mt_research_key"
      }
    }
  }
}

Authentication Methods

API Key Authentication

Most common method using environment variable:

{
  "mcpServers": {
    "MetaMCP": {
      "command": "uvx",
      "args": [
        "mcp-proxy",
        "--transport",
        "streamablehttp",
        "http://localhost:12008/metamcp/your-endpoint-name/mcp"
      ],
      "env": {
        "API_ACCESS_TOKEN": "sk_mt_your_key_here"
      }
    }
  }
}

No Authentication

For public endpoints without authentication:

{
  "mcpServers": {
    "MetaMCP": {
      "command": "uvx",
      "args": [
        "mcp-proxy",
        "http://localhost:12008/metamcp/your-endpoint-name/sse"
      ]
    }
  }
}

Troubleshooting

Common Issues

Connection refused: Ensure MetaMCP is running and accessible
Authentication failed: Verify API key is correct and has proper permissions
mcp-proxy not found: Install with pip install mcp-proxy or uvx mcp-proxy

Debug Mode

Enable debug logging for mcp-proxy:

{
  "mcpServers": {
    "MetaMCP": {
      "command": "uvx",
      "args": [
        "mcp-proxy",
        "--transport",
        "streamablehttp",
        "--debug",
        "http://localhost:12008/metamcp/your-endpoint-name/mcp"
      ],
      "env": {
        "API_ACCESS_TOKEN": "sk_mt_your_api_key_here"
      }
    }
  }
}

Important Notes

Replace your-endpoint-name with your actual endpoint name
Replace sk_mt_your_api_key_here with your MetaMCP API key
mcp-proxy handles the protocol conversion between stdio and Streamable HTTP/SSE
Environment variables are the secure way to pass API keys

General Stdio Integration using `mcp-remote` with OAuth` with API Key

Configure any stdio-based MCP client to connect to MetaMCP endpoints using mcp-remote with OAuth

MCP OAuth Troubleshooting

Troubleshoot common OAuth-related issues

Connect to Cursor

Configure Cursor IDE to use your MetaMCP endpoints

Connect to Claude Desktop

Set up Claude Desktop with MetaMCP using mcp-proxy

Getting Started

Core Concepts

Deployment

Integrations

Development

Troubleshooting

General Stdio Integration using `mcp-proxy` with API Key

Prerequisites

Basic Configuration

Using mcp-proxy (Required)

Authentication Methods

Troubleshooting

Common Issues

Debug Mode

Important Notes

General Stdio Integration using `mcp-remote` with OAuth` with API Key

MCP OAuth Troubleshooting

Connect to Cursor

Connect to Claude Desktop

​Prerequisites

​Basic Configuration

​Using mcp-proxy (Required)

​Authentication Methods

​Troubleshooting

​Common Issues

​Debug Mode

​Important Notes

General Stdio Integration using `mcp-remote` with OAuth` with API Key

MCP OAuth Troubleshooting

Connect to Cursor

Connect to Claude Desktop

Prerequisites

Basic Configuration

Using mcp-proxy (Required)

Authentication Methods

Troubleshooting

Common Issues

Debug Mode

Important Notes