> ## Documentation Index
> Fetch the complete documentation index at: https://developer.salesforge.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP troubleshooting

> Fix common setup and authentication issues when connecting Forge MCP tools.

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:

```json theme={null}
{
  "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.

## More setup details

* [Client setup guides](/mcp/client-setup)
* [MCP overview](/mcp/overview)
* [Salesforge help article](https://help.salesforge.ai/en/articles/10333582-salesforge-mcp-server-with-claude-for-cold-email-and-linkedin-outreach)
* [Forge MCP GitHub repository](https://github.com/SalesforgeAI/forge-mcp)