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

# Connect an AI tool to Eyk with MCP

> Connect Claude, ChatGPT, Cursor, Claude Code, VS Code, Gemini CLI, Perplexity, Vibe or n8n to your Eyk data through the Eyk MCP server.

Connect an AI tool to Eyk through the Eyk MCP server and ask questions about your data in plain language. The tool queries the same metrics you see in Eyk, straight from your BigQuery warehouse. It only sees the data your access in Eyk allows, checked on every query.

## Before you start

You need:

* An Eyk account that is an approved member of your organization.
* The AI tool installed, or open in your browser.
* For ChatGPT, Perplexity and Vibe: a paid plan. See the note under each tool.

## Server details

| Setting        | Value                                                                    |
| -------------- | ------------------------------------------------------------------------ |
| MCP server URL | `https://mcp.eykdata.com/mcp`                                            |
| Transport      | Streamable HTTP                                                          |
| Authentication | Sign in with your Eyk account in the browser. There are no keys to copy. |

## Claude

Works in Claude on the web and in the desktop app.

<Note>
  On Team and Enterprise plans an Owner must add the connector once via **Organization settings** >> **Connectors** before members can connect.
</Note>

<Steps>
  <Step title="Open Connectors">
    In Claude, go to **Customize** >> **Connectors**.
  </Step>

  <Step title="Add a custom connector">
    Click **+**, then **Add custom connector**.
  </Step>

  <Step title="Enter the server URL">
    Name it Eyk and paste the MCP server URL, then click **Add**.

    ```text theme={null}
    https://mcp.eykdata.com/mcp
    ```
  </Step>

  <Step title="Connect">
    Click **Connect** next to Eyk and sign in with your Eyk account.
  </Step>
</Steps>

See the [Claude documentation](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp).

## ChatGPT

Plugins are in beta and need a paid plan. Plus and Pro get read-only tools. Full tool access is currently limited to Business, Enterprise and Edu workspaces.

<Steps>
  <Step title="Enable Developer mode">
    On the web, enable Developer mode under **Settings** >> **Security and login**. On a workspace, an admin enables it first.
  </Step>

  <Step title="Add the plugin">
    Go to `chatgpt.com/plugins`, click **+** and name the plugin Eyk.
  </Step>

  <Step title="Enter the server URL">
    Under Connection, paste the MCP server URL. Sign in with your Eyk account when the OAuth flow opens.

    ```text theme={null}
    https://mcp.eykdata.com/mcp
    ```
  </Step>

  <Step title="Enable the plugin">
    Enable the Eyk plugin from a chat.
  </Step>
</Steps>

See the [ChatGPT documentation](https://developers.openai.com/apps-sdk/deploy/connect-chatgpt/).

## Cursor

<Steps>
  <Step title="Add the server">
    Add this block to `~/.cursor/mcp.json` for all projects, or to `.cursor/mcp.json` in the project.

    ```json theme={null}
    {
      "mcpServers": {
        "eyk": {
          "url": "https://mcp.eykdata.com/mcp"
        }
      }
    }
    ```
  </Step>

  <Step title="Open Customize">
    Open the **Customize** page from the Cursor sidebar. The Eyk server appears under MCPs.
  </Step>

  <Step title="Sign in">
    Sign in with your Eyk account when the browser opens.
  </Step>
</Steps>

See the [Cursor documentation](https://cursor.com/docs/mcp).

## Claude Code

<Steps>
  <Step title="Add the server">
    Run this command in your project.

    ```bash theme={null}
    claude mcp add --transport http eyk https://mcp.eykdata.com/mcp
    ```
  </Step>

  <Step title="Sign in">
    Run `/mcp` inside Claude Code, select Eyk, and complete the browser login with your Eyk account.
  </Step>
</Steps>

See the [Claude Code documentation](https://code.claude.com/docs/en/mcp).

## VS Code

Works with Copilot in agent mode.

<Note>
  VS Code 1.102 or newer is required, because older versions cannot sign in to MCP servers that require authentication.
</Note>

<Steps>
  <Step title="Add a server">
    Open the Command Palette and run **MCP: Add Server**.
  </Step>

  <Step title="Enter the server details">
    Choose **HTTP (HTTP or Server-Sent Events)** and paste the MCP server URL. Name the server `eyk` and pick **Workspace Settings** or **User Settings**. This is the equivalent configuration:

    ```json theme={null}
    {
      "servers": {
        "eyk": {
          "type": "http",
          "url": "https://mcp.eykdata.com/mcp"
        }
      }
    }
    ```
  </Step>

  <Step title="Start the server">
    Run **MCP: List Servers**, select Eyk and choose **Start Server**.
  </Step>

  <Step title="Sign in">
    Confirm you trust the server, then sign in with your Eyk account when the browser opens.
  </Step>

  <Step title="Use Agent mode">
    Open Copilot Chat and switch it to **Agent** mode to use Eyk's tools.
  </Step>
</Steps>

See the [VS Code documentation](https://code.visualstudio.com/docs/agent-customization/mcp-servers).

## Gemini CLI

<Steps>
  <Step title="Add the server">
    Add this block to `~/.gemini/settings.json`, or run `gemini mcp add --transport http eyk https://mcp.eykdata.com/mcp`.

    ```json theme={null}
    {
      "mcpServers": {
        "eyk": {
          "httpUrl": "https://mcp.eykdata.com/mcp"
        }
      }
    }
    ```
  </Step>

  <Step title="Confirm the server">
    Restart the CLI and run `/mcp` to confirm Eyk is listed.
  </Step>

  <Step title="Sign in">
    Sign in with your Eyk account in the browser popup on first connection.
  </Step>
</Steps>

See the [Gemini CLI documentation](https://geminicli.com/docs/tools/mcp-server/).

## Perplexity

Custom connectors require a paid plan. In organizations, an admin must allow members to add them.

<Steps>
  <Step title="Open Connectors">
    Go to **Account settings** >> **Connectors** and click **+ Custom connector**.
  </Step>

  <Step title="Select Remote">
    In the pop-up, select **Remote**.
  </Step>

  <Step title="Enter the server details">
    Fill in the name Eyk and the MCP server URL. Set Authentication to **OAuth** and Transport to **Streamable HTTP**.

    ```text theme={null}
    https://mcp.eykdata.com/mcp
    ```
  </Step>

  <Step title="Add the connector">
    Check the risk acknowledgement box and click **Add**.
  </Step>

  <Step title="Sign in">
    Click the Eyk connector card and sign in with your Eyk account.
  </Step>
</Steps>

See the [Perplexity documentation](https://www.perplexity.ai/help-center/en/articles/13915507-adding-custom-remote-connectors).

## Vibe

Vibe is Mistral's assistant, formerly Le Chat. Custom connectors are an administrator-only feature. On Free, Pro and Student plans the account owner is the administrator.

<Steps>
  <Step title="Open Connectors">
    In **Work** mode, open the **Connectors** page.
  </Step>

  <Step title="Add a connector">
    Click **+ Add Connector** and switch to the **Custom MCP Connector** tab.
  </Step>

  <Step title="Enter the server details">
    Enter a connector name without spaces and the MCP server URL, then click **Connect**.

    ```text theme={null}
    https://mcp.eykdata.com/mcp
    ```
  </Step>

  <Step title="Sign in">
    Complete the OAuth sign-in with your Eyk account.
  </Step>

  <Step title="Enable Eyk">
    In a chat, open **Tools** and make sure Eyk is enabled.
  </Step>
</Steps>

See the [Vibe documentation](https://docs.mistral.ai/vibe/work/connectors/mcp-connectors).

## n8n

<Note>
  n8n 1.104 or newer is required for the HTTP Streamable transport.
</Note>

<Steps>
  <Step title="Add a node">
    Add an **MCP Client Tool** node to give an AI Agent Eyk's tools. To call the tools as workflow steps instead, add the **MCP Client** node.
  </Step>

  <Step title="Set the endpoint">
    Set the endpoint to the MCP server URL and pick the **HTTP Streamable** transport.

    ```text theme={null}
    https://mcp.eykdata.com/mcp
    ```
  </Step>

  <Step title="Set authentication">
    Set Authentication to **OAuth2**, create a credential pointing at Eyk and complete the sign-in. You can reuse the credential across workflows.
  </Step>
</Steps>

See the [n8n documentation](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.toolmcp).

## Any other client

<Steps>
  <Step title="Point the client at Eyk">
    Point your MCP client at the MCP server URL over streamable HTTP.

    ```text theme={null}
    https://mcp.eykdata.com/mcp
    ```
  </Step>

  <Step title="Sign in">
    Sign in with your Eyk account when prompted.
  </Step>

  <Step title="Use the tools">
    Tools and prompts are discovered automatically.
  </Step>
</Steps>

See [Connect to remote MCP servers](https://modelcontextprotocol.io/docs/develop/connect-remote-servers) in the MCP documentation.

## Check it worked

Ask the tool: "Which organizations can I access in Eyk?" It answers by calling Eyk's `list_organizations` tool and lists your organizations. Then ask a data question, for example "What was my net sales last month?".

## What the tool can do

| Tool                 | What it does                                                        |
| -------------------- | ------------------------------------------------------------------- |
| `list_organizations` | Lists the Eyk organizations you can access.                         |
| `list_metrics`       | Lists the measures and dimensions you may query in an organization. |
| `query_data`         | Runs a query and returns the data.                                  |

The tool sees the same data you see in Eyk. Your access is checked on every query. The server also provides an Eyk analytics reference that explains measure semantics and query rules, which tools read on their own.

## Troubleshooting

<AccordionGroup>
  <Accordion title="The sign-in fails or the tool says access is denied">
    You need an approved membership of an Eyk organization. Ask your organization admin to invite you.
  </Accordion>

  <Accordion title="The tool has no option to add a custom connector">
    ChatGPT, Perplexity and Vibe keep custom connectors behind a paid plan or an admin setting. See the note under the tool.
  </Accordion>

  <Accordion title="VS Code does not sign in">
    Update to VS Code 1.102 or newer.
  </Accordion>

  <Accordion title="n8n has no HTTP Streamable transport">
    Update to n8n 1.104 or newer.
  </Accordion>
</AccordionGroup>