MCP troubleshooting

Use this checklist when tools do not appear or requests fail.

Tools are not showing up

Restart your MCP client after changing configuration.
Confirm at least one valid product key is set.
Confirm your server URL is exactly https://mcp.salesforge.ai/mcp.

Authentication errors

Verify the correct header name per product.
Verify each key value is correct and active.
In command-based configs, keep header format exact: X-Salesforge-Key:YOUR_KEY.

Missing product tools

Tools only appear for products with valid keys configured. Example:

No X-Primeforge-Key -> no Primeforge tools.
No X-Warmforge-Key -> no Warmforge tools.

Invalid workspace errors

Some tools require a workspace ID. First run a workspace-listing prompt and reuse a valid ID.

Multiple accounts

If you manage multiple client accounts, add multiple MCP server entries with different names and keys:

{
  "mcpServers": {
    "salesforge-client-a": {
      "url": "https://mcp.salesforge.ai/mcp",
      "headers": {
        "X-Salesforge-Key": "CLIENT_A_SALESFORGE_KEY"
      }
    },
    "salesforge-client-b": {
      "url": "https://mcp.salesforge.ai/mcp",
      "headers": {
        "X-Salesforge-Key": "CLIENT_B_SALESFORGE_KEY"
      }
    }
  }
}

Add extra product headers in each entry when needed.

MCP documentation

Tools are not showing up

Authentication errors

Missing product tools

Invalid workspace errors

Multiple accounts

More setup details

​Tools are not showing up

​Authentication errors

​Missing product tools

​Invalid workspace errors

​Multiple accounts

​More setup details

Tools are not showing up

Authentication errors

Missing product tools

Invalid workspace errors

Multiple accounts

More setup details