> For the complete documentation index, see [llms.txt](https://docs.luciq.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.luciq.ai/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server/setup-by-ide.md).

# 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](/files/K5HknuFr0gjBeNV6hSIO)

***

## 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`                     |

{% hint style="info" %}
**Prefer a connector over a config file?** You can add Luciq to the Claude apps as a custom connector, including provisioning it for your whole organization in one step. See [Set Up the Claude Connector](/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server/claude-connector.md).
{% endhint %}

***

## 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](/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server/faq-and-troubleshooting.md) 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](/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server/authentication-and-security.md#token-based-authentication) for setup instructions.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.luciq.ai/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server/setup-by-ide.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.