Skip to main content

Overview

Generate Claude Desktop MCP configuration for a deployed server. This creates the JSON configuration needed to integrate your MCP server with Claude Desktop.

Syntax

ntcli server claude-config <server-id> [options]

Arguments

server-id
string
required
ID of the deployed server to generate configuration for

Options

-w, --workspace
string
Target workspace ID (defaults to active workspace)
--insecure
boolean
Add —insecure flag for development servers with self-signed certificates
--copy
boolean
Show instructions for copying to clipboard
--verbose
boolean
Show detailed output

Examples

Basic Configuration Generation

ntcli server claude-config echo --insecure
Output:
 🔧 Generating Claude Desktop config for echo...
 Claude Desktop config generated for echo

📋 Claude Desktop MCP Configuration:
{
  "mcpServers": {
    "echo": {
      "command": "npx",
      "args": [
        "@nimbletools/mcp-http-bridge",
        "--endpoint",
        "https://mcp.nimbletools.ai/89d4769a-d093-411f-987c-782216903383/echo/mcp",
        "--token",
        "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9....."
      ],
      "auth": null,
      "oauth": false
    }
  }
}

Production Configuration

Uses current active workspace.
ntcli server claude-config nationalparks-mcp

Specific Workspace

ntcli server claude-config echo --workspace my-prod-workspace

Configuration Structure

The generated configuration includes:
FieldDescription
commandnpx - runs packages without installing them
argsBridge arguments including endpoint and token
endpointWorkspace-specific server endpoint
tokenWorkspace access token for authentication
authAuthentication method (null for token-based)
oauthOAuth configuration (false for token-based)
No Installation Required: The configuration uses npx which automatically downloads and runs @nimbletools/mcp-http-bridge without needing to install it globally. Claude Desktop will handle this automatically.

Usage in Claude Desktop

1

Copy Configuration

Copy the entire JSON output from the command
2

Open Claude Config

Open your claude_desktop_config.json file:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux: ~/.config/claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
3

Add Server Config

Add the server configuration to the mcpServers section
4

Restart Claude

Restart Claude Desktop to load the new configuration

Security Notes

Token Security: The generated configuration contains your workspace access token. Keep this configuration file secure and don’t share it publicly.
Development vs Production: Use --insecure flag only for development environments with self-signed certificates. Production servers should use valid SSL certificates.
I