DevelopersMCP
Install in Claude Desktop
Add the SaaSFlow MCP server to Claude Desktop using stdio and an API key.
The stdio transport runs the MCP server locally as a Node subprocess. Claude Desktop launches it on demand and pipes JSON-RPC over stdin/stdout.
Prerequisites
- Claude Desktop installed.
- Node.js 22+ on your PATH (Claude uses your shell to launch
npx). - A SaaSFlow API key — see API keys.
Configure
Open Claude Desktop's settings file:
| OS | Path |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
Add the SaaSFlow server under mcpServers:
{
"mcpServers": {
"saasflow": {
"command": "npx",
"args": ["-y", "@saasflow/mcp"],
"env": {
"SAASFLOW_API_KEY": "sf_...",
"SAASFLOW_COMPANY_ID": "<optional default company id>"
}
}
}
}Quit and reopen Claude Desktop. The SaaSFlow tools should appear under the 🔌 icon in the chat composer.
Environment variables
| Variable | Required | Default | Purpose |
|---|---|---|---|
SAASFLOW_API_KEY | yes | — | Your SaaSFlow API key. |
SAASFLOW_BASE_URL | no | https://api.saasflow.com | Override for staging or local dev. |
SAASFLOW_COMPANY_ID | no | — | Default company id. When set, tool calls without a companyId arg fall back to this. |
SAASFLOW_MCP_WRITES | no | unset | Set to 1 to register write tools (none yet — placeholder). |
What you can ask
The server is read-only, so:
"Show me my top 10 customers by MRR this month."
"How did MRR change in Q1 compared to Q4 last year?"
"Search for transactions to AWS in the last 90 days."
"What's our cash flow forecast for the next 6 months?"
Claude picks the right MCP tool based on the prompt — see MCP tools.
Troubleshooting
| Symptom | Likely cause |
|---|---|
| Tools don't appear after restart | JSON syntax error in claude_desktop_config.json. |
Calls return 401 | Wrong / revoked SAASFLOW_API_KEY. |
| Every call asks "for which company?" | Set SAASFLOW_COMPANY_ID to skip the disambiguation. |
npx: command not found | Install Node.js 22+ and restart Claude Desktop. |