Sweet MCP Server

Stateless HTTP MCP service for Claude and other MCP clients.

Stack

• @modelcontextprotocol/server + streamable HTTP transport
• Forwards bearer install tokens to Sweet backend runtime routes

Local setup

cp .env.example .env
npm install
npm run dev

MCP endpoint: http://localhost:3002/mcp

Requires the Sweet backend running on http://localhost:3001.

Tools

Tool	Description
quickbooks_definitions	Registry-backed CLI field definitions and resource catalog
quickbooks_companies	List connected QuickBooks companies
quickbooks_cli	Execute virtual QuickBooks CLI commands

OAuth for Claude web

Claude web connectors require OAuth 2.1 with PKCE. Sweet exposes:

Endpoint	Purpose
GET /.well-known/oauth-protected-resource	Resource metadata (RFC 9728)
GET /.well-known/oauth-authorization-server	Authorization server metadata
POST /oauth/register	Dynamic client registration
GET /oauth/authorize	User sign-in + consent
POST /oauth/token	Authorization code exchange

Set MCP_SERVER_PUBLIC_URL in the backend .env to your public HTTPS MCP URL (for example your ngrok URL ending in /mcp) before connecting Claude web.

Install tokens (sweet_mcp_…) still work for Claude Desktop and Cursor.