# Copilot in Claude Desktop

### Summary

This guide shows you how to install and configure the DataFlint MCP (Model Context Protocol) server in Claude Desktop.

The entire process should take just a few minutes.

The steps are:

1. Prerequisites - Ensure you have the required tools installed
2. Configure Claude Desktop
3. Authenticate with your organization
4. Verify the installation

### Prerequisites

Before installing the DataFlint MCP server, ensure you have:

* **Node.js** (version 18 or higher) installed on your system
* **npm** or **npx** available in your command line
* **Claude Desktop** application installed
* Your **organization's customer domain** - Only for BYOC (bring your own cloud) customers. Contact your DataFlint admin if you don't know this.

### Installation

#### Step 1: Locate the Claude Desktop configuration file

The configuration file location depends on your operating system:

* **MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
* **Linux**: `~/.config/Claude/claude_desktop_config.json`\
  \
  \
  \
   

You can also find the path in this way- in Claude desktop go to setting -> Developer -> clicking on 'Edit Config' button will open the path of the json in your computer

<figure><img src="/files/iIokK79A94semam7vQOb" alt=""><figcaption></figcaption></figure>

#### Step 2: Edit the configuration file

Open the `claude_desktop_config.json` file in your preferred text editor and add the DataFlint MCP server configuration:

**For SaaS customers:**

<pre class="language-json"><code class="lang-json"><strong>{
</strong>  "mcpServers": {
    "dataflint": {
      "command": "npx",
      "args": [
        "-y",
        "@dataflint/mcp-server@latest"
      ]
    }
  }
}
</code></pre>

**For BYOC (bring your own cloud) customers:**

```json
{
  "mcpServers": {
    "dataflint": {
      "command": "npx",
      "args": [
      "args": [
        "-y",
        "@dataflint/mcp-server@latest",
        "--customer-domain",
        "YOUR_COMPANY_NAME"
      ]
    }
  }
}
```

#### Step 3: Restart Claude Desktop

Close and reopen Claude Desktop for the changes to take effect.

**First-time authentication**

When you first use DataFlint MCP in Claude:

1. Your browser will automatically open to your organization's authentication page
2. Log in with your organization credentials
3. Subsequent uses will not require browser authentication

<figure><img src="/files/qEfd5ZBSHESQrFSXyDuz" alt=""><figcaption></figcaption></figure>

After successful authentication, you can close the browser and return to Claude Desktop.

<figure><img src="/files/cSZHDsEtexcFGw7kSRAY" alt=""><figcaption></figcaption></figure>

### Verify the installation

#### Check MCP connection status

1. Open Claude Desktop
2. Start a new conversation
3. Look for the 🔌 MCP icon in the bottom right corner

<figure><img src="/files/bDdDISvprw6X70DXnQXn" alt=""><figcaption></figcaption></figure>

#### Test the connection

Try asking Claude:

```
"Find my top 5 application to fix by using DataFlint MCP"
```


---

# Agent Instructions: 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:

```
GET https://dataflint.gitbook.io/dataflint-for-spark/dataflint-copilot/copilot-in-claude-desktop.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.