# Setup by IDE

Connect Luciq MCP to your IDE. OAuth handles authentication automatically - just add the server URL and approve access in your browser.

{% hint style="info" %}
**Your dashboard has the latest setup instructions.** Go to **Account Management > Luciq MCP** in your Luciq dashboard for per-client setup guides tailored to your account, including a one-click Connect option for Cursor.
{% endhint %}

### Server URL

```
https://api.luciq.ai/api/mcp
```

***

## Cursor

Create or edit `~/.cursor/mcp.json` with the following configuration:

```json
{
  "mcpServers": {
    "luciq": {
      "url": "https://api.luciq.ai/api/mcp"
    }
  }
}
```

Or use the **Connect** button on your dashboard's Luciq MCP settings page to open Cursor and install the Luciq MCP server directly.

![Cursor Connect button on the Luciq MCP dashboard](https://2991836969-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCha1KrkvNKPdcC0aGvuB%2Fuploads%2Fgit-blob-ad4e29d496919737ab5627d22569095ffe5fe769%2Fmcp-dashboard-cursor-connect.png?alt=media)

***

## Claude Code

Run the following command in your terminal:

```bash
claude mcp add --transport http luciq https://api.luciq.ai/api/mcp
```

The OAuth flow will open your browser automatically for authorization.

***

## VS Code / GitHub Copilot

Open Command Palette (**Cmd+Shift+P**) > **MCP: Add Server** > select **HTTP** > paste the server URL:

```
https://api.luciq.ai/api/mcp
```

***

## Claude Desktop

Copy the configuration below into your `claude_desktop_config.json` file:

```json
{
  "mcpServers": {
    "luciq": {
      "url": "https://api.luciq.ai/api/mcp"
    }
  }
}
```

**Config file location:**

| Platform | Path                                                              |
| -------- | ----------------------------------------------------------------- |
| macOS    | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Windows  | `%APPDATA%\Claude\claude_desktop_config.json`                     |

***

## Other MCP Clients

Any client that supports the [MCP standard](https://modelcontextprotocol.io/) can connect to Luciq. Add the server URL as a remote MCP server in your client's settings:

```
https://api.luciq.ai/api/mcp
```

Your client will initiate a connection and open an OAuth authorization in your browser. Log in with your Luciq account and grant access.

***

## Verifying Your Connection

After setup, try this prompt in your IDE:

{% hint style="success" %}
"List my applications"
{% endhint %}

If you see your Luciq apps listed, you're connected and ready to go.

If the connection isn't working, check the [FAQ & Troubleshooting](https://docs.luciq.ai/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server/faq-and-troubleshooting) page for common issues and IDE-specific fixes.

***

## Using Token-Based Auth Instead of OAuth

If you're in an environment where interactive OAuth isn't practical (CI/CD pipelines, remote terminals over SSH, automated workflows), you can use token-based authentication. See [Authentication & Security](https://docs.luciq.ai/product-guides-and-integrations/product-guides/ai-features/authentication-and-security#token-based-authentication) for setup instructions.