Skip to main content
Instead of connecting to PipesHub’s remote MCP endpoint, you can run the MCP server locally as a stdio process using the @pipeshub-ai/mcp npm package. This is useful when you prefer a local setup or need to work in environments where direct HTTP connections to the remote MCP endpoint aren’t practical.

​
Prerequisites

  • Node.js 20+ installed
  • A PipesHub instance URL
  • Authentication credentials: either a Bearer token (JWT) or OAuth Client ID + Secret

​
Placeholders

Replace these in all configurations below:
PlaceholderDescriptionExample
PIPESHUB_INSTANCE_URLYour PipesHub instance URLhttps://app.pipeshub.com
YOUR_BEARER_TOKENJWT Bearer token for authenticationeyJhbGci...
YOUR_CLIENT_IDOAuth app client IDclid_abc123...
YOUR_CLIENT_SECRETOAuth app client secretclsec_xyz789...

​
Claude Desktop

Claude Desktop has its own dedicated guide, since it can’t connect to a local HTTP MCP endpoint and needs either a custom connector (hosted) or this stdio bridge. See Claude Desktop for the full setup.

​
Cursor

Open Cursor Settings > Tools and Integrations > New MCP Server, or edit your project’s .cursor/mcp.json: 
{
  "mcpServers": {
    "pipeshub": {
      "command": "npx",
      "args": [
        "-y",
        "@pipeshub-ai/mcp",
        "start",
        "--server-url",
        "PIPESHUB_INSTANCE_URL",
        "--bearer-auth",
        "YOUR_BEARER_TOKEN"
      ]
    }
  }
}

​
Claude Code CLI

claude mcp add pipeshub -- npx -y @pipeshub-ai/mcp start \
  --server-url PIPESHUB_INSTANCE_URL \
  --bearer-auth YOUR_BEARER_TOKEN

​
Gemini CLI

gemini mcp add pipeshub -- npx -y @pipeshub-ai/mcp start \
  --server-url PIPESHUB_INSTANCE_URL \
  --bearer-auth YOUR_BEARER_TOKEN

​
VS Code

Open Command Palette > MCP: Open User Configuration, then add: 
{
  "mcpServers": {
    "pipeshub": {
      "command": "npx",
      "args": [
        "-y",
        "@pipeshub-ai/mcp",
        "start",
        "--server-url",
        "PIPESHUB_INSTANCE_URL",
        "--bearer-auth",
        "YOUR_BEARER_TOKEN"
      ]
    }
  }
}

​
Windsurf

Open Windsurf Settings > Cascade > Manage MCPs > View raw config, then add: 
{
  "mcpServers": {
    "pipeshub": {
      "command": "npx",
      "args": [
        "-y",
        "@pipeshub-ai/mcp",
        "start",
        "--server-url",
        "PIPESHUB_INSTANCE_URL",
        "--bearer-auth",
        "YOUR_BEARER_TOKEN"
      ]
    }
  }
}

​
Running from Source (Development)

To run the local MCP server from a cloned repository instead of the npm package: 
git clone https://github.com/pipeshub-ai/pipeshub-ai.git
cd pipeshub-ai
npm install
npm run build
node ./bin/mcp-server.js start --server-url PIPESHUB_INSTANCE_URL --bearer-auth YOUR_BEARER_TOKEN
For MCP client configuration, replace npx @pipeshub-ai/mcp with node ./bin/mcp-server.js: 
{
  "mcpServers": {
    "pipeshub": {
      "command": "node",
      "args": [
        "./bin/mcp-server.js",
        "start",
        "--server-url",
        "PIPESHUB_INSTANCE_URL",
        "--bearer-auth",
        "YOUR_BEARER_TOKEN"
      ]
    }
  }
}
To debug with MCP Inspector: 
npx @modelcontextprotocol/inspector node ./bin/mcp-server.js start --server-url PIPESHUB_INSTANCE_URL --bearer-auth YOUR_BEARER_TOKEN

​
CLI Help

For a full list of server arguments: 
npx @pipeshub-ai/mcp --help