# MCP

## Overview

Violet's MCP server gives AI tools secure access to your structured Violet data. It uses the [Model Context Protocol](https://modelcontextprotocol.io/docs/getting-started/intro) to work seamlessly with AI assistants and agents like Claude, ChatGPT, Cursor and Copilot.

This enables you to get quick answers, create powerful insights, or build your own dashboards and apps - across all of your data sources.

## Getting started

### Prerequisites

Before connecting Violet Agent, you'll need:

1. An active Violet workspace
2. An MCP-compatible AI client (Claude Desktop, Cursor, ChatGPT, etc.)

### Connect

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><img src="/files/nqtcsDHzUJGUqGldvBnP" alt="" data-size="line"> Claude</td><td><a href="/pages/sZjF9UlkOSo6PSCtdzLK#claude">/pages/sZjF9UlkOSo6PSCtdzLK#claude</a></td><td></td></tr><tr><td><img src="/files/bQWUtMRmyy13JTMIHMIV" alt="" data-size="line"> ChatGPT</td><td><a href="/pages/sZjF9UlkOSo6PSCtdzLK#chatgpt">/pages/sZjF9UlkOSo6PSCtdzLK#chatgpt</a></td><td></td></tr><tr><td><img src="/files/yPqujtPUeKZmAOSHUzXJ" alt="" data-size="line"> Copilot</td><td><a href="/pages/sZjF9UlkOSo6PSCtdzLK#copilot">/pages/sZjF9UlkOSo6PSCtdzLK#copilot</a></td><td></td></tr><tr><td>API Key (Cursor, Github Copilot, Windsurf, etc.)</td><td><a href="/pages/sZjF9UlkOSo6PSCtdzLK#connect-with-an-api-key">/pages/sZjF9UlkOSo6PSCtdzLK#connect-with-an-api-key</a></td><td></td></tr></tbody></table>

### Claude

In [Claude](https://claude.ai/) or Claude desktop, navigate to Customize > Connectors and click **Add custom connector:**

<figure><img src="/files/53BVh6zcfgpEhZyazuhN" alt="" width="375"><figcaption></figcaption></figure>

Provide a Name and the Remote MCP Server URL (below) then click **Add.**

* If you use Violet standard, your URL is `https://mcp.violetlabs.com/mcp`
* If you use VioletGov, your URL is `https://mcp.violetgov.com/mcp`&#x20;

<figure><img src="/files/xORjAxBns3GTU3P0EDNI" alt="" width="375"><figcaption></figcaption></figure>

Select the new Violet connector and click **Connect**, then log in with your email address and password.

<figure><img src="/files/jUvQxwcxUta5qX5AMuhU" alt="" width="375"><figcaption></figcaption></figure>

Once you've logged in, select the workspace you'd like to connect and click **Continue**. You'll be directed back to your Claude workspace.

<figure><img src="/files/5v3psKhulGqqvJX7AdK2" alt="" width="375"><figcaption></figcaption></figure>

### ChatGPT

In [ChatGPT](https://chatgpt.com/), navigate to Settings > Apps > Advanced Settings. Toggle on Developer Mode, then click **Create App:**

<figure><img src="/files/PHlI0NZn8iy1e9DlayFm" alt="" width="375"><figcaption></figcaption></figure>

Provide a Name and the MCP Server URL (below), then check "I understand" and click **Create.** You'll be directed to log in with your Violet email address and password.

* If you use Violet standard, your URL is `https://mcp.violetlabs.com/mcp`
* If you use VioletGov, your URL is `https://mcp.violetgov.com/mcp`&#x20;

<figure><img src="/files/CbQDWKge5gtBEi8Me2gS" alt="" width="188"><figcaption></figcaption></figure>

Once you've logged in, select the workspace you'd like to connect and click **Continue**. You'll be directed back to your ChatGPT workspace.

<figure><img src="/files/XcKqyayRM2uMHWNN4iVG" alt="" width="375"><figcaption></figcaption></figure>

### Copilot

{% stepper %}
{% step %}

#### Create an API key

In [Violet](https://app.violetlabs.com/violet-api-keys/) (or [VioletGov](https://app.violetlabs.gov/violet-api-keys/)), navigate to **Settings > API Keys** and click **Create API Key**.
{% endstep %}

{% step %}

#### Add a tool

In Copilot or Copilot Studio, go to **Tools > Add a tool > New tool > MCP.** Select **Model Context Protocol**.

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

Fill in the required fields for **Server name** (eg. "Violet"), **Server description**, and **Server URL:**

* If you use Violet standard, your URL is `https://mcp.violetlabs.com/mcp`
* If you use VioletGov, your URL is `https://mcp.violetgov.com/mcp`&#x20;

Under **Authentication**, select **API Key.** Under **Type,** select **Header**. Enter the name of the header "X-API-Key", then click **Create.**

On **Add tool**, select **Create a new connection.**
{% endstep %}
{% endstepper %}

### Connect with an API key

For [Cursor](https://cursor.com/), [Windsurf](https://windsurf.com/) or any other MCP compatible tools that accept an API key, you can also connect that way.

{% stepper %}
{% step %}

#### Create an API key

In [Violet](https://app.violetlabs.com/violet-api-keys/) (or [VioletGov](https://app.violetlabs.gov/violet-api-keys/)), navigate to **Settings > API Keys** and click **Create API Key**.
{% endstep %}

{% step %}

#### Connect Violet MCP

Add the Violet MCP configuration below with your API Key and the applicable URL:

* If you use Violet standard, your URL is `https://mcp.violetlabs.com/mcp`
* If you use VioletGov, your URL is `https://mcp.violetgov.com/mcp`.

```
{
  "servers": {
    "violet": {
      "type": "http",
      "url": "https://mcp.violetgov.com/mcp",
      "headers": {
        "X-API-Key": "API Key Here"
      },
    },
  },
}
```

{% endstep %}
{% endstepper %}

## Security

We recommend authenticating Violet MCP with OAuth, which means you:

* Log in with existing Violet credentials
* Have the ability to select a workspace
* Don't have to deal with managing or rotating API keys

Some important notes about data access:

* Violet MCP will *only* operate within your selected workspace
* You have the same permissions and access to data as your Violet user account
* Data is never shared with external systems (unless you configure it to)


---

# 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://docs.violetlabs.com/ai/mcp.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.