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

# Use Avala con IA

> Conecte Avala a Claude, Cursor, VS Code y ChatGPT con MCP

El [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) es un estándar abierto que permite a los asistentes de IA llamar herramientas externas y acceder a fuentes de datos. El servidor MCP de Avala expone sus datasets, proyectos y exportaciones como herramientas, para que pueda gestionar su flujo de trabajo de anotación a través de lenguaje natural en Claude, Cursor, VS Code o ChatGPT.

## Configuración rápida

Instale el servidor MCP con cualquier cliente de IA compatible. Necesitará **Node.js 18+** y una [API key de Avala](/docs/api-reference/authentication).

Para Claude Desktop, agregue a su archivo de configuración (`~/Library/Application Support/Claude/claude_desktop_config.json` en macOS):

<Warning>
  Nunca incluya archivos de configuración que contengan API keys reales en el control de versiones. Configure `AVALA_API_KEY` como variable de entorno del sistema, o reemplace `"your-api-key"` con su clave real localmente.
</Warning>

```json theme={null}
{
  "mcpServers": {
    "avala": {
      "command": "npx",
      "args": ["-y", "@avala-ai/mcp-server"],
      "env": {
        "AVALA_API_KEY": "your-api-key"
      }
    }
  }
}
```

Reinicie Claude Desktop. Las herramientas de Avala aparecerán en el selector de herramientas.

<Info>
  MCP se ejecuta en modo solo lectura por defecto en el servidor incluido. Para habilitar herramientas de escritura/eliminación, configure `AVALA_MCP_ENABLE_MUTATIONS=true` antes de iniciar el servidor MCP.
</Info>

## Qué puede hacer

Una vez conectado, puede pedirle a su asistente de IA que interactúe con Avala usando lenguaje natural:

```
List all my datasets
```

```
Show the status of the "Pedestrian Detection" project
```

```
How many tasks are completed in "Lidar QA"?
```

```
Show export jobs for dataset ds_abc123
```

```
Show my workspace stats
```

El asistente llama a la herramienta MCP de Avala apropiada, procesa la respuesta y presenta los resultados. Puede encadenar múltiples solicitudes en una sola conversación — por ejemplo, listar datasets, elegir uno y luego iniciar una exportación.

## Guía de configuración completa

Para VS Code, ChatGPT y una lista completa de herramientas MCP disponibles, consulte la guía completa de [configuración del servidor MCP](/docs/integrations/mcp-setup).

<CardGroup cols={2}>
  <Card title="Configuración del servidor MCP" icon="plug" href="/docs/integrations/mcp-setup">
    Instrucciones de configuración completas para todos los clientes de IA soportados y la referencia completa de herramientas.
  </Card>

  <Card title="Autenticación de API" icon="key" href="/docs/api-reference/authentication">
    Cree y gestione las API keys utilizadas por el servidor MCP.
  </Card>
</CardGroup>