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

# Connect a client

> Connect Claude, Cursor, VS Code, Windsurf, or the Gumloop CLI to the Gumloop MCP server.

```text theme={"dark"}
https://mcp.gumloop.com/gumloop/mcp
```

<Info>
  You'll need a Gumloop API key. Get one from the [Gumloop API Key connector](https://www.gumloop.com/settings/profile/connectors?view=connected\&search=Gumloop+API+Key). The server handles OAuth automatically: you'll be prompted to sign in and authorize access the first time you connect.
</Info>

## Claude

Navigate to **Settings > Connectors** and add a new MCP integration with this URL:

```text theme={"dark"}
https://mcp.gumloop.com/gumloop/mcp
```

## Cursor

1. Open Cursor Settings (Cmd/Ctrl + Shift + J)
2. Go to **MCP** and click **Add new MCP server**
3. Select **Type: SSE** and enter the server URL:

```text theme={"dark"}
https://mcp.gumloop.com/gumloop/mcp
```

## VS Code

Add this configuration to your `.vscode/mcp.json`:

```json theme={"dark"}
{
  "mcpServers": {
    "gumloop": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.gumloop.com/gumloop/mcp"]
    }
  }
}
```

## Windsurf

1. Open Windsurf settings (Cmd/Ctrl + ,)
2. Scroll to **Cascade > MCP servers**
3. Select **Add Server > Add custom server**
4. Add this configuration:

```json theme={"dark"}
{
  "mcpServers": {
    "gumloop": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.gumloop.com/gumloop/mcp"]
    }
  }
}
```

## Gumloop CLI

Explore and call tools from your terminal:

```bash theme={"dark"}
gumloop mcp list                                    # List connected servers
gumloop mcp tools gumloop                           # Browse available tools
gumloop mcp call gumloop list_agents --args-json '{}' # Call a tool
```

See the full reference in the [CLI MCP docs](/cli/mcp).

For connection issues, see [Gumloop MCP troubleshooting](/help/mcp/gumloop-mcp-troubleshooting).