Prodloop MCP Bridge

Local stdio MCP bridge that lets any stdio-compatible MCP client call Prodloop Assistant using the user's existing Prodloop/Firebase login.

The included prodloop-mcp-install command currently automates Claude Desktop config. For other MCP clients, point their stdio MCP config at dist/index.js with the same environment variables.

Automatic Claude Desktop install

After building or installing the package, run:

prodloop-mcp-install

For local development from this folder:

npm install
npm run build
node dist/install-claude.js --local

This updates Claude Desktop's config while preserving existing MCP servers. By default it installs npx -y --package=@prodloop/mcp@latest prodloop-mcp. Restart Claude Desktop after running it.

Manual Claude Desktop config

If you prefer manual config, add this to Claude Desktop's config file:

macOS:

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

Example:

{
  "mcpServers": {
    "prodloop-ai": {
      "command": "npx",
      "args": ["-y", "--package=@prodloop/mcp@latest", "prodloop-mcp"]
    }
  }
}

For local development from this repository:

{
  "mcpServers": {
    "prodloop-ai": {
      "command": "node",
      "args": ["/absolute/path/to/porter_audit_fronted/development_nama_yatri/tools/prodloop-mcp/dist/index.js"]
    }
  }
}

First use

1. Restart Claude Desktop.
2. Ask Claude to use Prodloop.
3. The bridge opens /mcp/connect in the browser.
4. User logs into the existing Prodloop frontend.
5. Click Connect Claude Desktop.
6. Return to Claude.

The bridge stores Firebase refresh credentials at:

~/.prodloop/mcp-auth.json

The file is created with 0600 permissions. For production packaging, replace this with OS keychain storage.

Tools

• prod_ai_chat: ask Prodloop Assistant a question.
• prodloop_list_tenants: inspect available tenant IDs.
• prodloop_set_default_tenant: set the tenant used by default.
• prodloop_login_status: inspect local login/tenant cache; opens browser login if needed.
• prodloop_logout: clear local MCP login cache.
• prodloop_reconnect: clear local cache and start browser login again.

Optional environment overrides

No environment variables are required for the default deployment.

• PRODLOOP_FRONTEND_URL: override frontend URL. Defaults to https://audit.prodloop.com.
• PRODLOOP_BACKEND_URL: override backend URL. Defaults to https://uat-audit-backend-600640376612.asia-southeast1.run.app.
• PRODLOOP_TENANT_ID: optional tenant override when a user has multiple tenants.
• PRODLOOP_FIREBASE_WEB_API_KEY: optional Firebase web API key override.