mcp

Membrane API Gateway Tutorial - MCP

This tutorial shows how to expose Membrane API Gateway as an MCP server for AI clients. It covers:

• running a local MCP server
• inspecting recent API traffic through MCP
• allowing only selected MCP tools with mcpProtection

To begin, open 10-MCP-Server.yaml and follow the instructions in the file. Then continue with 20-MCP-Protection.yaml to test a protected MCP endpoint with the MCP Inspector UI.

Use mcpProtection to restrict MCP methods and tools. If you also need client authentication, put the membraneMCPServer behind an apiKey interceptor and expose it only through the network path you actually want clients to use. If the client should keep talking to a simple local URL, you can also place a small local proxy in front of the protected MCP endpoint and let that proxy add the required authentication details.

Claude Desktop Setup

Open Settings -> Developer, edit claude_desktop_config.json, and add:

{
  "mcpServers": {
    "membrane": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:2000"
      ]
    }
  },
  "preferences": {
    "coworkScheduledTasksEnabled": true,
    "ccdScheduledTasksEnabled": true,
    "sidebarMode": "task",
    "coworkWebSearchEnabled": true
  }
}

Start membrane and restart Claude Desktop.