Connect Salt MCP to Claude Code
Connect Claude Code to the hosted Salt MCP server and verify read-only access to your Salt account.
Connect Claude Code to Salt MCP, authorize access in your browser, and confirm the connection by reading your account and Pipeline information.
This guide grants read-only access. To create, change, run, or delete Salt resources after you connect, follow Enable write access in Claude Code.
Prerequisites
You need:
- A Salt account
- Claude Code 2.1.196 or later
Connect Claude Code
Add the Salt MCP server
Run this command in your terminal:
claude mcp add-json --scope user salt-mcp \
'{"type":"http","url":"https://salt-api-prod.salt.ai/mcp","oauth":{"scopes":"read"}}'Claude Code registers salt-mcp as an HTTP MCP server in your user configuration and pins OAuth access to the read scope.
Open the MCP connection menu
Enter:
/mcpClaude Code lists salt-mcp and marks it as requiring authentication.
Start authentication
Choose salt-mcp and follow the authentication prompt.
Your browser opens the Salt Authorize app page. If the browser does not open, copy the URL that Claude Code provides and open it yourself.
Review the authorization request
Check the account under Signed in as and the callback under Redirects to.
The permissions list shows "Read your Salt account (workflows, nodes, deployments, knowledge bases)." It does not show "Modify your Salt account and run workflows on your behalf."
If the page includes the permission to modify your Salt account, click Cancel. Remove salt-mcp, then add it again with the command above so Claude Code requests only read.
Grant access
Click Authorize.
Salt redirects to Claude Code's local callback, and salt-mcp shows as connected.
If the callback cannot reach Claude Code, copy the full callback URL from your browser's address bar and paste it into the URL prompt in Claude Code.
Request your Salt profile
Ask Claude Code:
Use get_current_user to show my Salt profile.Claude Code displays profile information for your Salt account.
List your Pipelines
Ask Claude Code:
Use workflow_list with limit 20 to list my Salt Pipelines.Claude Code displays up to 20 Pipelines from your Salt account.