Skip to main content

Overview

Claude Desktop provides full MCP support for tools, resources, and prompts.

Claude Desktop Setup

Step 1: Locate Configuration File

Claude Desktop uses a JSON configuration file:
  • macOS
  • Windows
~/Library/Application Support/Claude/claude_desktop_config.json

Step 2: Add StackOne MCP Configuration

Add the following to your claude_desktop_config.json:
{
  "mcpServers": {
    "stackone": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/client-http",
        "https://api.stackone.com/mcp"
      ],
      "env": {
        "MCP_HTTP_HEADERS": "{\"Authorization\":\"Basic YOUR_BASE64_TOKEN\",\"x-account-id\":\"YOUR_ACCOUNT_ID\",\"MCP-Protocol-Version\":\"2025-06-18\"}"
      }
    }
  }
}
Replace:
  • YOUR_BASE64_TOKEN: Base64-encoded your_api_key: (see Authentication Guide)
  • YOUR_ACCOUNT_ID: Your StackOne account ID
Encode your API key:
echo -n "<stackone_api_key>" | base64
For complete MCP configuration options, see the official Claude Desktop MCP documentation.

Step 3: Restart Claude Desktop

Close and reopen Claude Desktop to load the new configuration.

Step 4: Verify Connection

In Claude Desktop, you can now:
  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

Programmatic Integration

For programmatic integration with Anthropic’s Claude API, see our dedicated Anthropic SDK Framework Guide which provides comprehensive examples and production-ready code.

Configuration Options

For multiple accounts or environments, you can configure multiple MCP servers. The exact format depends on Claude Desktop’s configuration system - refer to the official documentation for current syntax.

Usage

Once configured, you can interact with Claude Desktop to access StackOne operations. Ask about data from your connected integrations, and Claude will execute the appropriate StackOne tools to provide responses.

Debug Logging

For troubleshooting connection issues, refer to Claude Desktop’s logging capabilities as documented in their official MCP integration guide.

Next Steps