Skip to content

Add Salient to Claude Desktop

Connect Salient's MCP server to the Claude Desktop app.

Configuration

Open your Claude Desktop config file:

open ~/Library/Application\ Support/Claude/claude_desktop_config.json
%APPDATA%\Claude\claude_desktop_config.json

Add the Salient MCP server:

{
  "mcpServers": {
    "ttx-salient": {
      "command": "python3",
      "args": ["/full/path/to/salient/tools/mcp-ttx/server.py"],
      "env": {
        "SALIENT_API_URL": "https://salient.yourdomain.com",
        "SALIENT_TOKEN": "your-jwt-token"
      }
    }
  }
}

Use absolute paths

Claude Desktop requires absolute paths for the server script. Replace /full/path/to/salient/ with the actual path to your Salient installation.

Restart Claude Desktop

After saving the config, fully quit and reopen Claude Desktop. The MCP server connects on startup.

Verify

In a new Claude Desktop conversation, you should see the MCP tools icon. Click it to see the list of available Salient tools.

Try:

What tabletop exercises are available on my Salient platform?

Claude should call list_scenarios and show you the available exercises.

Getting a Token

  1. Open your Salient web UI
  2. Log in with GitHub or Google OAuth
  3. Navigate to Settings
  4. Copy your API token
  5. Paste it as the SALIENT_TOKEN value in the config

Adding SSH Access (Optional)

To manage your production droplet from Claude Desktop:

{
  "mcpServers": {
    "ttx-salient": { "...": "..." },
    "salient-droplet": {
      "command": "python3",
      "args": ["/full/path/to/salient/tools/mcp-ssh/server.py"],
      "env": {
        "SSH_HOST": "root@your-droplet-ip",
        "SSH_IDENTITY_FILE": "~/.ssh/salient-key"
      }
    }
  }
}