Skip to main content

​
Overview

Claude Desktop is Anthropic’s GUI application for macOS and Windows with full MCP support for tools, resources, and prompts.
For complete Claude Desktop MCP documentation, see the official MCP quickstart.

​
Setup

Claude Desktop requires the mcp-remote package to connect to remote HTTP servers.
1

Locate Configuration File

  1. Open Claude Desktop
  2. Navigate to Settings → Developer
  3. Click “Edit Config” to open the configuration file in your default editor
The config file is located at:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Claude Desktop Settings page showing Developer tab with Edit Config button highlighted
2

Encode Your API Key

Open your terminal and generate the Base64 token for authentication:Copy the output for use in the configuration.
Terminal showing base64 encoding command and output
3

Add StackOne MCP Configuration

Add the following to your claude_desktop_config.json:
{
  "mcpServers": {
    "gsheets": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.stackone.com/mcp?x-account-id={account_id}",
        "--header",
        "Authorization: Basic {base64_encoded_api_key}"
      ]
    }
  }
}
Replace:
  • {account_id}: Your StackOne linked account ID
  • {base64_encoded_api_key}: The Base64-encoded token from the previous step
Use short names for easier identification: gsheets, slack, hubspot-sales. You can prefix with stackone- or s1- if you have other MCP servers, but it’s not required.
For multiple linked accounts, add additional server entries:
Claude Desktop Connectors page showing multiple MCP servers configured for different integrations

Screenshots show 'stackone-' prefix — this is optional.

{
  "mcpServers": {
    "gsheets": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.stackone.com/mcp?x-account-id={google_sheets_account_id}",
        "--header",
        "Authorization: Basic {base64_encoded_api_key}"
      ]
    },
    "slack": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.stackone.com/mcp?x-account-id={slack_account_id}",
        "--header",
        "Authorization: Basic {base64_encoded_api_key}"
      ]
    }
  }
}
You can also pass the account ID as a header:
{
  "mcpServers": {
    "gsheets": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.stackone.com/mcp",
        "--header",
        "x-account-id: {account_id}",
        "--header",
        "Authorization: Basic {base64_encoded_api_key}"
      ]
    }
  }
}
4

Restart Claude Desktop

Close and reopen Claude Desktop to load the new configuration.

​
Verify Connection

After restarting, navigate to Settings → Developer to verify your servers are configured:
Claude Desktop Settings showing configured Local MCP servers
A green “running” badge indicates the server is connected. If you see “failed”, click Open Logs Folder to troubleshoot. Your servers will also appear in Settings → Connectors with a “Local Dev” tag, where you can configure tool permissions:
Claude Desktop Connectors page showing tool permissions with options to enable or require approval for each tool

Screenshots show servers with 'stackone-' prefix — this is optional.

Once connected, you can:
  1. List Tools: Ask “What StackOne tools are available?”
  2. Execute Operations: Request actions like “Search recent calls in Gong”
  3. Access Resources: Ask about API schemas or documentation
For troubleshooting, see Claude Desktop’s logging capabilities in the official MCP documentation.

​
Programmatic Integration

For programmatic integration with Anthropic’s Claude API, see the Anthropic SDK Framework Guide.

​
Next Steps

Claude Code

Set up MCP in Claude Code CLI

Authentication Guide

Configure authentication and security