> 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/codex-plugin.md).

# Complemento de Codex

Configura el complemento AirOps MCP en Codex con aplicaciones interactivas

El complemento AirOps MCP conecta Codex a tu espacio de trabajo de AirOps. Ofrece configuración con un solo clic y compatibilidad con aplicaciones interactivas, incluidas interfaces de revisión de gráficos y Brand Kit renderizadas directamente en tu tarea.

## Configuración rápida

1. Abre el [Complemento MCP de AirOps](https://chatgpt.com/plugins/plugin_asdk_app_6a8774407d4081919100aae8d18bba79).
2. Selecciona **Instalar complemento**.
3. Completa el flujo de inicio de sesión de AirOps cuando se te solicite.

Después de la instalación y la autenticación, AirOps está disponible como fuente de complemento en las vistas de tareas de Codex compatibles.

{% hint style="info" %}
La disponibilidad del complemento depende de tu plan de Codex, la configuración del espacio de trabajo, el rol y la región. En un espacio de trabajo administrado, un administrador puede necesitar habilitar el complemento antes de que puedas instalarlo o usarlo.
{% endhint %}

## Aplicaciones interactivas

El complemento de Codex admite **Aplicaciones interactivas**, interfaces en vivo renderizadas directamente en tu tarea en lugar de descripciones de texto.

### Lo que verás

| Aplicación interactiva         | Caso de uso                                                                   |
| ------------------------------ | ----------------------------------------------------------------------------- |
| Gráficos de líneas             | Tendencias a lo largo del tiempo, incluyendo la tasa de menciones y las citas |
| Gráficos de barras y de pastel | Comparaciones entre competidores, proveedores y temas                         |
| Tarjetas KPI                   | Métricas actuales con cambios del período                                     |
| Tablas de datos                | Páginas, indicaciones, citas y otros resultados detallados                    |
| Revisión de Brand Kit          | Revisa y acepta o rechaza los cambios sugeridos de Brand Kit                  |

### Ejemplo

```
Tú: "Muéstrame cómo cambió nuestra tasa de menciones durante los últimos dos meses."
Codex: [Muestra un gráfico interactivo de tendencias]
       Tu tasa de menciones aumentó del 9% al 18%.
```

### Usando aplicaciones interactivas

* **Ver en línea:** Los gráficos y las interfaces de revisión aparecen directamente en la tarea.
* **Interactúa:** Pasa el cursor sobre los datos del gráfico o utiliza los controles proporcionados por la aplicación.
* **Refinar:** Pide a Codex que cambie el rango de fechas, las métricas, la agrupación o el tipo de gráfico.
* **Revisar cambios:** Acepta o rechaza las ediciones sugeridas de Brand Kit antes de aplicarlas.

Las aplicaciones interactivas aparecen automáticamente cuando Codex llama a una herramienta compatible de AirOps.

### Solución de problemas de aplicaciones interactivas

Si una aplicación interactiva no aparece:

1. Confirma que el complemento de AirOps esté seleccionado en **Fuentes → Usar complementos**.
2. Solicita explícitamente un gráfico o una revisión de Brand Kit, como "Muéstrame un gráfico de la tendencia de mi tasa de menciones."
3. Comprueba que tu cuenta de AirOps pueda acceder al Brand Kit y a los datos solicitados.
4. Inicia una nueva tarea después de volver a conectar el complemento.

## Usar AirOps en Codex

En una vista de tarea de Codex compatible:

1. Abrir **Fuentes**.
2. Selecciona **Usar complementos**.
3. Busca y selecciona el complemento de AirOps instalado.
4. Pide a Codex que trabaje con tus datos de AirOps.

Por ejemplo:

```
Revisa el rendimiento de nuestra búsqueda con IA durante los últimos 30 días e identifica las mayores oportunidades.
```

## Administrar el complemento

### Reconectar

Si AirOps necesita autenticación de nuevo, abre el complemento desde **Fuentes → Usar complementos** y completa el flujo de inicio de sesión cuando se te solicite.

### Acceso al espacio de trabajo

Los administradores del espacio de trabajo pueden gestionar la disponibilidad del complemento desde **Configuración del espacio de trabajo → Complementos**. Pueden revisar las capacidades incluidas del complemento y elegir si está disponible para que los miembros lo instalen o si se instala automáticamente para los roles elegibles.

El acceso al complemento no omite los permisos de la cuenta de AirOps conectada.

## Solución de problemas

### Complemento no encontrado

Comprueba que:

1. Estás usando una vista de tarea de Codex compatible.
2. El complemento está instalado para tu cuenta o rol.
3. Tu administrador del espacio de trabajo ha habilitado el acceso si utilizas un espacio de trabajo administrado.

Los cambios en el directorio de Codex pueden tardar en actualizarse. Si el complemento se publicó o habilitó recientemente, inténtalo de nuevo más tarde.

### Autenticación requerida

Abrir **Fuentes → Usar complementos**, selecciona AirOps y completa el flujo de autenticación. Si el problema continúa, cierra sesión en AirOps en tu navegador y vuelve a autenticarte.

### Las herramientas o los datos no están disponibles

Confirma que:

* El complemento de AirOps está seleccionado para la tarea.
* Tu cuenta de AirOps puede acceder a los datos del espacio de trabajo solicitados.
* Estás solicitando una capacidad compatible con el complemento.

## Complemento de Codex frente a configuración MCP directa

| Función                   | Complemento MCP de AirOps                             | Configuración MCP directa                                   |
| ------------------------- | ----------------------------------------------------- | ----------------------------------------------------------- |
| Configuración             | Instalar desde el directorio de complementos de Codex | Configurar el servidor MCP manualmente                      |
| Aplicaciones interactivas | Sí                                                    | Depende del cliente MCP                                     |
| Autenticación             | Completa el flujo de configuración del complemento    | Autentícate en tu cliente MCP                               |
| Mejor para                | Tareas de Codex                                       | Claude Code, Cursor, VS Code, Windsurf y otros clientes MCP |

El complemento usa el servidor MCP de AirOps en `https://app.airops.com/mcp`.

## Lo que puedes hacer

* **Revisar inteligencia de búsqueda con IA:** Seguimiento de la tasa de menciones, la tasa de citas y la cuota de voz
* **Analizar competidores:** Comparar el rendimiento entre plataformas de IA
* **Encontrar oportunidades:** Descubrir páginas que pierden citas o están cerca de posicionarse
* **Crear informes:** Generar paneles guardados para las partes interesadas
* **Seguir por proveedor:** Comparar ChatGPT, Perplexity, Gemini y Claude
* **Gestionar la identidad de marca:** Actualizar el nombre de la marca, la descripción, el tono de escritura y la personalidad
* **Configurar entidades de marca:** Gestionar líneas de productos, audiencias, regiones, tipos de contenido, reglas de escritura y competidores
* **Buscar en bases de conocimiento:** Encontrar contenido relevante en tus documentos mediante búsqueda semántica


---

# 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/codex-plugin.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.
