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.
The fastest way to get your configuration is directly from the StackOne dashboard — it generates a ready-to-paste JSON block for Claude Desktop. See Connect from Dashboard.
1

Get your MCP URL from the dashboard

  1. Go to Connectors in the left nav and open the connector you want to use
  2. Click Use Connector in the top right
  3. On the Use tab, click MCP Server under “Use with Agent Client”
  4. Select a linked account from the dropdown
  5. Choose Claude Desktop as the client
  6. Copy the generated JSON block
The config uses a single token URL — no separate API key encoding required.
The token expires after one year. Regenerate it at any time using the refresh button in the MCP tile.
2

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
3

Add StackOne MCP Configuration

Paste the config from the dashboard into your claude_desktop_config.json. It looks like this:
{
  "mcpServers": {
    "gsheets": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.stackone.com/mcp?token={session_token}"
      ]
    }
  }
}
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 an entry for each. Get each token from the dashboard by selecting the relevant account.
Claude Desktop Connectors page showing multiple MCP servers configured for different integrations
{
  "mcpServers": {
    "gsheets": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.stackone.com/mcp?token={google_sheets_session_token}"
      ]
    },
    "slack": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.stackone.com/mcp?token={slack_session_token}"
      ]
    }
  }
}
If you prefer to use your API key and account ID directly, encode your API key first:
Terminal showing base64 encoding command and output
Then add to your config:
{
  "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}"
      ]
    }
  }
}
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
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