# MCP

## Resumen

El servidor MCP de Violet brinda a las herramientas de IA acceso seguro a tus datos estructurados de Violet. Utiliza el [Protocolo de Contexto de Modelos](https://modelcontextprotocol.io/docs/getting-started/intro) para funcionar sin problemas con asistentes y agentes de IA como Claude, ChatGPT, Cursor y Copilot.

Esto te permite obtener respuestas rápidas, crear insights potentes o construir tus propios paneles y aplicaciones, en todas tus fuentes de datos.

## Primeros pasos

### Requisitos previos

Antes de conectar Violet Agent, necesitarás:

1. Un espacio de trabajo de Violet activo
2. Un cliente de IA compatible con MCP (Claude Desktop, Cursor, ChatGPT, etc.)

### Conectar

<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">Imagen de portada</th></tr></thead><tbody><tr><td><img src="/files/c56ab17f0d93ac82a6994b3a74ba9dcf544223c8" alt="" data-size="line"> Claude</td><td><a href="/pages/8d831a6a22ccdef11f3da82893afc9c3799080b9#claude">/pages/8d831a6a22ccdef11f3da82893afc9c3799080b9#claude</a></td><td></td></tr><tr><td><img src="/files/196f61ed6e81e3f5ee379258858bd6befddac32f" alt="" data-size="line"> ChatGPT</td><td><a href="/pages/8d831a6a22ccdef11f3da82893afc9c3799080b9#chatgpt">/pages/8d831a6a22ccdef11f3da82893afc9c3799080b9#chatgpt</a></td><td></td></tr><tr><td><img src="/files/485cbbecf037af0a7ec210b00fec50c5c2c59c8b" alt="" data-size="line"> Copilot</td><td><a href="/pages/8d831a6a22ccdef11f3da82893afc9c3799080b9#copilot">/pages/8d831a6a22ccdef11f3da82893afc9c3799080b9#copilot</a></td><td></td></tr><tr><td>Clave de API (Cursor, Github Copilot, Windsurf, etc.)</td><td><a href="/pages/8d831a6a22ccdef11f3da82893afc9c3799080b9#connect-with-an-api-key">/pages/8d831a6a22ccdef11f3da82893afc9c3799080b9#connect-with-an-api-key</a></td><td></td></tr></tbody></table>

### Claude

En [Claude](https://claude.ai/) o en Claude Desktop, ve a Personalizar > Conectores y haz clic en **Añadir conector personalizado:**

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

Proporciona un nombre y la URL del servidor MCP remoto (abajo) y luego haz clic en **Añadir.**

* Si usas Violet estándar, tu URL es `https://mcp.violetlabs.com/mcp`
* Si usas VioletGov, tu URL es `https://mcp.violetgov.com/mcp`&#x20;

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

Selecciona el nuevo conector Violet y haz clic en **Conectar**; luego inicia sesión con tu dirección de correo electrónico y contraseña.

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

Una vez que hayas iniciado sesión, selecciona el espacio de trabajo al que te gustaría conectar y haz clic en **Continuar**. Serás dirigido de vuelta a tu espacio de trabajo de Claude.

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

### ChatGPT

En [ChatGPT](https://chatgpt.com/)ve a Configuración > Aplicaciones > Configuración avanzada. Activa el Modo desarrollador y luego haz clic en **Crear aplicación:**

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

Proporciona un nombre y la URL del servidor MCP (abajo), luego marca "Entiendo" y haz clic en **Crear.** Se te dirigirá para iniciar sesión con tu dirección de correo electrónico y contraseña de Violet.

* Si usas Violet estándar, tu URL es `https://mcp.violetlabs.com/mcp`
* Si usas VioletGov, tu URL es `https://mcp.violetgov.com/mcp`&#x20;

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

Una vez que hayas iniciado sesión, selecciona el espacio de trabajo al que te gustaría conectar y haz clic en **Continuar**. Serás dirigido de vuelta a tu espacio de trabajo de ChatGPT.

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

### Copilot

{% stepper %}
{% step %}

#### Crear una clave de API

En [Violet](https://app.violetlabs.com/violet-api-keys/) (o [VioletGov](https://app.violetlabs.gov/violet-api-keys/)), ve a **Configuración > Claves de API** y haz clic en **Crear clave de API**.
{% endstep %}

{% step %}

#### Añadir una herramienta

En Copilot o Copilot Studio, ve a **Herramientas > Añadir una herramienta > Nueva herramienta > MCP.** Selecciona **Protocolo de Contexto de Modelos**.

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

Completa los campos obligatorios para **Nombre del servidor** (p. ej., "Violet"), **Descripción del servidor**y **URL del servidor:**

* Si usas Violet estándar, tu URL es `https://mcp.violetlabs.com/mcp`
* Si usas VioletGov, tu URL es `https://mcp.violetgov.com/mcp`&#x20;

En **Autenticación**, selecciona **Clave de API.** En **Tipo,** selecciona **Encabezado**. Introduce el nombre del encabezado "X-API-Key" y luego haz clic en **Crear.**

Activado **Añadir herramienta**, selecciona **Crear una nueva conexión.**
{% endstep %}
{% endstepper %}

### Conectar con una clave de API

Para [Cursor](https://cursor.com/), [Windsurf](https://windsurf.com/) o cualquier otra herramienta compatible con MCP que acepte una clave de API, también puedes conectarte de esa manera.

{% stepper %}
{% step %}

#### Crear una clave de API

En [Violet](https://app.violetlabs.com/violet-api-keys/) (o [VioletGov](https://app.violetlabs.gov/violet-api-keys/)), ve a **Configuración > Claves de API** y haz clic en **Crear clave de API**.
{% endstep %}

{% step %}

#### Conectar Violet MCP

Añade la configuración de Violet MCP a continuación con tu clave de API y la URL correspondiente:

* Si usas Violet estándar, tu URL es `https://mcp.violetlabs.com/mcp`
* Si usas VioletGov, tu URL es `https://mcp.violetgov.com/mcp`.

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

{% endstep %}
{% endstepper %}

## Seguridad

Recomendamos autenticar Violet MCP con OAuth, lo que significa que tú:

* Inicias sesión con credenciales existentes de Violet
* Tienes la capacidad de seleccionar un espacio de trabajo
* No tienes que ocuparte de gestionar o rotar claves de API

Algunas notas importantes sobre el acceso a los datos:

* Violet MCP *solo* operará dentro de tu espacio de trabajo seleccionado
* Tienes los mismos permisos y acceso a los datos que tu cuenta de usuario de Violet
* Los datos nunca se comparten con sistemas externos (a menos que lo configures así)


---

# 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/es/ia/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.