> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/es/desarrolladores/getting-started.md).

# Primeros pasos

Instrucciones de configuración para asistentes de IA usando MCP

Conecta tu asistente de IA a AirOps usando el servidor MCP. Esta guía cubre la configuración para Codex, Claude Code, Cursor, VS Code, Windsurf y otros clientes MCP.

{% hint style="info" %}
**¿Claude Web o de escritorio?** Usa la [Conector de Claude](/docs/es/desarrolladores/claude-connector.md) para configuración con un clic y aplicaciones interactivas.
{% endhint %}

**URL del servidor:** `https://app.airops.com/mcp`

Las herramientas de recursos requieren un espacio de trabajo de AirOps de pago, incluidas las pruebas de nivel de pago elegibles. Los espacios de trabajo gratuitos pueden conectarse y enumerar espacios de trabajo, pero no pueden consultar ni cambiar datos del espacio de trabajo a través de MCP. Consulta [acceso al plan](/docs/es/desarrolladores/tools.md#plan-access).

La autenticación usa OAuth 2.0: inicia sesión con tu cuenta de AirOps a través del navegador.

## Codex

Usa la [Complemento MCP de AirOps](/docs/es/desarrolladores/codex-plugin.md) para configuración con un clic en Codex.

## Claude Code

Ejecuta en tu terminal:

```bash
claude mcp add --transport http airops https://app.airops.com/mcp
```

Luego autentícate:

1. Ejecuta `/mcp` en Claude Code
2. Selecciona el servidor de AirOps
3. Elige **Autenticar**
4. Completa el inicio de sesión en tu navegador

## Cursor

1. Abrir **Configuración de Cursor → Herramientas y MCP → Nuevo servidor MCP**
2. Añade la configuración:

```json
{
  "mcpServers": {
    "airops": {
      "url": "https://app.airops.com/mcp"
    }
  }
}
```

3. Haz clic en **Conectar** para autenticarte

## VS Code (Copilot)

1. Abrir **Configuración** (Ctrl/Cmd + ,)
2. Busca "mcp" y haz clic en **Editar en settings.json**
3. Añade:

```json
{
  "mcp": {
    "servers": {
      "airops": {
        "command": "npx",
        "args": ["-y", "mcp-remote", "https://app.airops.com/mcp"]
      }
    }
  }
}
```

## Windsurf

1. Abrir **Configuración de Windsurf → Cascade → Servidores MCP**
2. Haz clic en **Añadir servidor → Añadir servidor personalizado**
3. Añade:

```json
{
  "mcpServers": {
    "airops": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.airops.com/mcp"]
    }
  }
}
```

## Otros clientes

La mayoría de los clientes MCP admiten transporte HTTP:

* **Transporte:** HTTP (HTTP transmisible)
* **URL:** `https://app.airops.com/mcp`

Para clientes que requieren transporte SSE, usa `mcp-remote` como proxy:

```bash
npx -y mcp-remote https://app.airops.com/mcp
```

## Solución de problemas

### Autenticación

<details>

<summary>Error de "Necesita autenticación"</summary>

**Claude Code:** Ejecuta `/mcp`, selecciona AirOps, elige **Autenticar**.

**Cursor:** Haz clic en **Conectar** botón en la configuración de MCP.

**Otros clientes:** Elimina y vuelve a añadir el servidor para borrar los tokens almacenados en caché.

</details>

<details>

<summary>OAuth no funciona (WSL/red corporativa)</summary>

**Usuarios de WSL:** OAuth del navegador puede fallar desde WSL. Ejecuta tu cliente desde Windows en su lugar.

**Redes corporativas:** Tu red puede bloquear las redirecciones de OAuth. Prueba con una red personal o contacta a TI para incluir en la lista blanca `app.airops.com`.

</details>

### Conexión

<details>

<summary>Conexión rechazada o tiempo de espera agotado</summary>

Comprueba que puedas acceder a `https://app.airops.com` en tu navegador. Algunas redes corporativas bloquean las conexiones MCP.

</details>

<details>

<summary>Las herramientas no aparecen</summary>

1. Reinicia tu asistente de IA
2. **Claude Code:** Ejecuta `/mcp` para verificar la conexión
3. Elimina y vuelve a añadir el servidor

</details>

### Borrar autenticación almacenada en caché

Elimina el servidor y añádelo de nuevo:

**Claude Code:**

```bash
claude mcp remove airops
claude mcp add --transport http airops https://app.airops.com/mcp
```

**Otros clientes:** Elimina el servidor de tu configuración y vuelve a añadirlo.

## Siguientes pasos

* [Casos de uso](/docs/es/desarrolladores/use-cases.md) — Ejemplos de informes y optimización
* [Referencia de herramientas](/docs/es/desarrolladores/tools.md) — Todas las herramientas disponibles
* [Preguntas frecuentes](/docs/es/desarrolladores/faq.md) — Preguntas frecuentes


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/es/desarrolladores/getting-started.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.