> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Using with Claude Desktop

> Connect BoostGPT MCP servers to Claude Desktop

## Overview

Connect your BoostGPT MCP servers to Claude Desktop to use your custom tools with Claude.

## Prerequisites

* Claude Desktop app installed
* At least one MCP server created in BoostGPT

## Setup

**1. Get MCP URL**

**Dashboard -> MCP Servers -> Your Server**

Copy your MCP URL:

```text theme={null}
https://mcp.your-server-id.boostgpt.co
```

**2. Open Claude Desktop Config**

Open Claude Desktop configuration file:

**macOS/Linux:**

```bash theme={null}
~/Library/Application Support/Claude/claude_desktop_config.json
```

**Windows:**

```bash theme={null}
%APPDATA%\Claude\claude_desktop_config.json
```

**3. Add MCP Server**

Add your BoostGPT MCP server to the config:

```json theme={null}
{
  "mcpServers": {
    "my-crm": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.your-server-id.boostgpt.co"
      ]
    }
  }
}
```

**4. Add Authentication**

If your MCP server requires authentication:

```json theme={null}
{
  "mcpServers": {
    "my-crm": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.your-server-id.boostgpt.co",
        "--header",
        "Authorization: Bearer your-api-token"
      ]
    }
  }
}
```

**5. Restart Claude Desktop**

Close and reopen Claude Desktop to load the new MCP server

**6. Test**

In Claude Desktop, try using your custom tools:

```text theme={null}
You: "Look up customer john@acme.com"
Claude: *uses your MCP server* "Found customer..."
```

## Multiple MCP Servers

Add multiple BoostGPT MCP servers:

```json theme={null}
{
  "mcpServers": {
    "crm": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.crm-server.boostgpt.co"
      ]
    },
    "inventory": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.inventory-server.boostgpt.co"
      ]
    },
    "billing": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.billing-server.boostgpt.co"
      ]
    }
  }
}
```

Claude Desktop will have access to all tools from all servers.

## Example Configuration

Complete example with authentication:

```json theme={null}
{
  "mcpServers": {
    "internal-crm": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.abc123.boostgpt.co",
        "--header",
        "Authorization: Bearer sk_live_abc123xy",
         "--header",
        "X-Custom-Header: Bearer custom-value"
      ]
    },
    "company-database": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.def456.boostgpt.co",
        "--header",
        "X-API-Key: your-api-key"
      ]
    }
  }
}
```

## Authentication

### API Key

```json theme={null}
{
  "mcpServers": {
    "my-api": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.your-server.boostgpt.co",
        "--header",
        "X-API-Key: your-api-key"
      ]
    }
  }
}
```

### Bearer Token

```json theme={null}
{
  "mcpServers": {
    "my-api": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.your-server.boostgpt.co",
        "--header",
        "Authorization: Bearer your-token"
      ]
    }
  }
}
```

Get your authentication details from:
**Dashboard -> MCP Servers -> Your Server -> Settings**

## Example Usage

After setup, use your tools in Claude Desktop:

```text theme={null}
You: "Query our CRM for customers in California"

Claude: *uses your MCP server's query_customers tool*
        Found 42 customers in California:
        1. Acme Corp - Los Angeles
        2. TechStart - San Francisco
        ...

You: "Create a deal for Acme Corp worth $25K"

Claude: *uses create_deal tool*
        Deal created successfully!
        Deal ID: DEAL-12345

You: "Send them a follow-up email"

Claude: *uses send_email tool*
        Email sent to contact@acmecorp.com
```

## Use Cases

### Personal Assistant

```text theme={null}
Connect your personal tools:
- Calendar: Schedule meetings
- Email: Send messages
- Notes: Save information

Claude becomes your AI assistant with access to your systems
```

### Development Workflow

```text theme={null}
Connect development tools:
- GitHub: Create issues, review PRs
- Database: Query data
- CI/CD: Trigger builds

Claude helps with coding tasks using your tools
```

### Business Intelligence

```text theme={null}
Connect analytics systems:
- Database: Run queries
- Reporting: Generate reports
- Visualization: Create charts

Claude analyzes your business data
```

## Troubleshooting

> [accordion] Config file not found
>
> Create the directory and file manually if it doesn't exist. Use the paths shown in Setup step 2.

> [accordion] MCP server not connecting
>
> * Verify the URL is correct
> * Check that your MCP server is active in Dashboard
> * Restart Claude Desktop after config changes

> [accordion] Authentication errors
>
> Ensure headers match what your MCP server expects. Check Dashboard -> MCP Servers -> Settings.

> [accordion] Tools not appearing
>
> * Restart Claude Desktop
> * Check for JSON syntax errors in config file
> * Verify MCP server URL is accessible

## Best Practices

1. **Name servers clearly** - Use descriptive names in config
2. **Test individually** - Add one MCP server at a time
3. **Monitor usage** - Check logs in Dashboard -> MCP Servers
4. **Keep updated** - Update authentication tokens when needed

## Next Steps

> [card] [Create MCP Server](/docs/integrations/custom/overview.md)
>
> Build custom MCP servers

> [card] [BoostGPT AI Teammates](/docs/integrations/external/boostgpt-agents.md)
>
> Use with BoostGPT AI teammates


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.