Hutte MCP

Agentic workflows with Hutte MCP.

Overview

The Hutte MCP (Model Context Protocol) server exposes your Hutte projects, sandbox features, and scratch orgs directly to AI assistants — including Claude, Cursor, and any MCP-compatible client. Once connected, you can manage Salesforce orgs conversationally without leaving your IDE or chat interface.

What you can do:

  • List all your features and scratch orgs across projects
  • Authenticate a sandbox or scratch org with the local sf CLI in one step
  • Open an org directly in the browser via a one-time login URL
  • Claim pool orgs for immediate use

Prerequisites

  • A Hutte account with at least one project
  • Salesforce CLI (sf) installed locally if you plan to authenticate orgs

Installation

The Hutte MCP server is hosted at https://app.hutte.io/mcp. No local installation is required — you reference it directly in your client's MCP configuration.

Claude.ai

  1. Open claude.ai → click your profile icon → Settings
  2. Navigate to Integrations → Add Integration
  3. Enter the server URL: https://app.hutte.io/mcp
  4. Authenticate when prompted — Claude will redirect you to Hutte's OAuth flow

Claude Code

Run in your terminal:

claude mcp add hutte \
  --transport sse \
  --url https://app.hutte.io/mcp

Or add manually to ~/.claude/mcp.json:

{
  "mcpServers": {
    "hutte": {
      "transport": "sse",
      "url": "https://app.hutte.io/mcp"
    }
  }
}

Cursor

  1. Open Cursor Settings (Cmd/Ctrl + ,) → MCP
  2. Click Add MCP Server
  3. Set transport to SSE and URL to https://app.hutte.io/mcp
  4. Save — Cursor will prompt you to sign in to Hutte

Or edit .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "hutte": {
      "transport": "sse",
      "url": "https://app.hutte.io/mcp"
    }
  }
}

Other MCP Clients

Setting Value
Transport SSE (Server-Sent Events)
URL https://app.hutte.io/mcp
Auth OAuth (Hutte account login)

Available Tools

Tool Description Key Parameters
list_projects List all Hutte projects you have access to
list_features List open sandbox features across all projects or a single project project_id (optional)
list_scratch_orgs List active scratch orgs across all projects or a single project project_id (optional)
authenticate_org Authenticate a sandbox or scratch org with the local sf CLI — returns a ready-to-run command feature_id or scratch_org_id
get_org_login_url Generate a one-time browser login URL for instant org access feature_id or scratch_org_id
take_pool_org Claim a pre-created scratch org from a project pool project_id

Usage

Listing Features and Orgs

"List my Hutte features" "Show all open features for the ACME4 project" "What scratch orgs do I have active?"

Authenticating an Org with the sf CLI

"Authenticate the Cleanup account page layout feature from ACME4" "Authenticate my scratch org for HUT-55"

The assistant calls authenticate_org and returns a shell command to run in your terminal:

echo "force://..." | sf org login sfdx-url \
  --alias "hutte-" \
  --set-default \
  --sfdx-url-stdin

The org is then available to all sf CLI commands under the alias shown.

Opening an Org in the Browser

"Open the ACME4 Cleanup account layout feature in the browser" "Give me a login URL for my HUT-55 scratch org"

The assistant returns a one-time Salesforce frontdoor URL. Open it immediately — it expires within minutes.

Claiming a Pool Scratch Org

"Take a pool org from the ACME4 project"

The assistant calls take_pool_org and returns the new org's details. You can then authenticate it or open it in the browser.

Combined Workflows

The Hutte MCP tools compose naturally with Salesforce DX MCP tools:

"Create a helper class that calculates an Account health score and a corresponding test class. Authenticate the ‘Account Health Score’ feature and deploy both classes. Execute the tests" "List my features, pick the one for HUT-55, open it in the browser”