> 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/getting-started.md).

# Getting Started

Get your first Luciq MCP response in under two minutes. Find your MCP settings in the dashboard, connect your IDE, and run a first query.

Get your first MCP response in under two minutes.

***

## Prerequisites

* A Luciq account (MCP is available on **all plans**, no extra setup required)
* An MCP-compatible IDE: Cursor, Claude Code, Claude Desktop, VS Code, or any MCP client

***

## Step 1: Find Your MCP Settings

MCP server settings live in your Luciq dashboard under **Account Management**.

1. Log in to your [Luciq dashboard](https://dashboard.luciq.ai)
2. Click your **profile avatar** (top-right corner)
3. Select **Account Management**
4. In the left sidebar, click **Luciq MCP**

![Navigate to Account Management > Luciq MCP](https://2991836969-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCha1KrkvNKPdcC0aGvuB%2Fuploads%2Fgit-blob-8cbb30464709b04179d690d5e83e03cb98fa8698%2Fmcp-settings-navigation.gif?alt=media)

From this page you can:

* View integration settings for each supported MCP client
* Generate a personal access token (for token-based auth)
* See your current token and authentication status

***

## Step 2: Connect Your IDE

The **Luciq MCP** page in your dashboard shows setup instructions tailored to each supported client. Select your IDE there to get the exact configuration for your account.

You can also use the server URL directly:

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

{% tabs %}
{% tab title="Cursor" %}
Create or edit `~/.cursor/mcp.json` with the following configuration:

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

{% endtab %}

{% tab title="Claude Code" %}
Run the following command in your terminal:

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

{% endtab %}

{% tab title="VS Code" %}
Open Command Palette (**Cmd+Shift+P**) > **MCP: Add Server** > select **HTTP** > paste the server URL:

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

{% endtab %}

{% tab title="Claude Desktop" %}
Copy the configuration below and paste it into your `claude_desktop_config.json` file:

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

{% endtab %}

{% tab title="Other clients" %}
Copy the server URL below and add it to your MCP client settings as a remote MCP server:

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

Your client will initiate a connection and open an OAuth authorization in your browser. Log in via your Luciq account and grant access.
{% endtab %}
{% endtabs %}

For detailed setup instructions, visit the [Setup by IDE](/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server/setup-by-ide.md) page or check the setup guide on your dashboard's **Luciq MCP** page.

***

## Step 3: Try Your First Query

Once connected, try one of these prompts in your IDE:

{% hint style="success" %}
"List my applications"\
"Show me the top crashes in production this week"\
"What are the most common app hangs?"
{% endhint %}

![MCP connection test in Claude Code](https://2991836969-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCha1KrkvNKPdcC0aGvuB%2Fuploads%2Fgit-blob-9ff02461282d6973e005d06351aeed2ca89e05ff%2Fmcp-claude-code-setup.gif?alt=media)

If you see your apps or crash data, you're connected and ready to go.

***

## What's Next?

* [**Setup by IDE**](/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server/setup-by-ide.md) - Detailed guides for every supported IDE
* [**Use Cases & Workflows**](/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server/use-cases-and-workflows.md) - Real-world debugging workflows with prompt sequences
* [**Tools Reference**](/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server/mcp-tools-reference.md) - All 37 tools documented with parameters and examples
* [**Authentication & Security**](/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server/authentication-and-security.md) - OAuth, tokens, permissions, and security details
* [**FAQ & Troubleshooting**](/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server/faq-and-troubleshooting.md) - Common issues and how to resolve them


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.luciq.ai/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server/getting-started.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.