> 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/faq.md). # Preguntas frecuentes Preguntas frecuentes sobre AirOps MCP, el complemento Codex y el conector Claude ## Primeros pasos ### ¿Qué es el conector Claude de AirOps? El conector Claude de AirOps te permite acceder a tus datos de AEO (AI Engine Optimization) directamente desde conversaciones en Claude. En lugar de alternar entre Claude y el panel de AirOps, hazle a Claude preguntas como "¿Cómo está rindiendo mi marca en la búsqueda de IA?" y obtén información al instante. Encuéntralo en el [Directorio de conectores](https://claude.ai/settings/connectors): haz clic **"Buscar y herramientas"** en tu chat y selecciona **"Añadir conectores"**, o ve a **Configuración → Conectores → Explorar conectores**. Busca "AirOps", haz clic en Conectar y autentícate con tu cuenta de AirOps. ### ¿Qué puedo hacer con AirOps en Claude? * **Supervisar la visibilidad en IA** — Comprueba la tasa de menciones, la tasa de citas y la cuota de voz * **Analizar competidores** — Compara el rendimiento en distintas plataformas de IA * **Encontrar oportunidades** — Descubre páginas que pierden citas o están cerca de posicionarse * **Crear informes** — Genera paneles guardados para las partes interesadas * **Rastrear por proveedor** — Compara ChatGPT, Perplexity, Gemini y Claude * **Explorar prompts** — Encuentra preguntas de IA en las que se te menciona o no * **Gestionar la identidad de marca** — Actualiza el nombre de la marca, el tono de escritura, la persona y el estilo * **Configurar entidades de marca** — Gestiona líneas de producto, audiencias, regiones, tipos de contenido, reglas de redacción y competidores * **Buscar en las bases de conocimiento** — Encuentra contenido relevante en todos tus documentos ### ¿Cuál es la diferencia entre Claude Connector y MCP? **Conector de Claude** es la integración nativa en el Directorio de conectores de Claude: * Configuración con un clic * Aplicaciones interactivas (gráficos renderizados en la conversación) * OAuth automático **MCP** es el protocolo subyacente. Úsalo para Cursor, VS Code, Windsurf o Claude Code: * Configuración manual * Las mismas herramientas, configuración diferente | Función | Conector de Claude | MCP | | ------------------------- | ----------------------- | ------------------------- | | Configuración | Con un clic | Manual | | Aplicaciones interactivas | Sí | Depende del cliente | | Mejor para | Claude Web y escritorio | Cursor, VS Code, Windsurf | ### ¿Qué aplicaciones de Claude son compatibles con AirOps? | Aplicación | Método de conexión | Aplicaciones interactivas | | -------------- | ------------------------- | ------------------------- | | Codex | Complemento MCP de AirOps | Sí | | Claude Web | Conector de Claude | Sí | | Claude Desktop | Conector de Claude | Sí | | Claude Code | MCP | No | ### ¿Qué planes necesito? **AirOps:** Un espacio de trabajo de pago, incluida una prueba elegible del nivel de pago. Las consultas de Insights también requieren que AEO esté habilitado y un Brand Kit configurado. Los espacios de trabajo gratuitos pueden conectarse y usar `list_workspaces`, pero las herramientas de recursos devuelven una restricción del plan. **Claude:** Pro, Team o Enterprise. El plan gratuito no admite conectores. *** ## Aplicaciones interactivas ### ¿Qué son las aplicaciones interactivas? Algunos complementos y conectores muestran interfaces interactivas en vivo en tu conversación o tarea, en lugar de devolver solo texto. Puedes ver el gráfico o la interfaz de revisión directamente donde estás trabajando. En Codex, instala y selecciona el complemento de AirOps para usar sus aplicaciones interactivas. En Claude, los conectores con esta capacidad muestran una **insignia "Interactivo"** en el directorio. ### ¿AirOps admite aplicaciones interactivas? Sí. Cuando preguntas sobre tendencias o métricas, AirOps puede mostrar: * **Gráficos de líneas** para tendencias a lo largo del tiempo * **Gráficos de barras** para comparaciones * **Tarjetas KPI** para métricas actuales * **Tablas de datos** para datos detallados ### ¿Por qué no veo visualizaciones? 1. **Comprueba tu conexión:** En Codex, selecciona AirOps en **Fuentes → Usar complementos**. En Claude, verifica que AirOps esté conectado en **Configuración → Conectores**. 2. **Comprueba el acceso:** Confirma que tu cuenta puede acceder al Brand Kit y a los datos solicitados de AirOps. 3. **Sé explícito:** Prueba con "Muéstrame un gráfico de la tendencia de mi tasa de menciones." 4. **Reconecta:** Reconecta AirOps y luego inicia una nueva conversación o tarea. *** ## Conexión ### ¿Cómo conecto Claude (web/escritorio)? 1. Ve a **Configuración → Conectores** 2. Busca **"AirOps"** 3. Haz clic en **Conectar** 4. Inicia sesión con tu cuenta de AirOps ### ¿Cómo conecto Claude Code? ```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 OAuth en tu navegador ### ¿Necesito una clave de API? No. El conector usa OAuth: inicias sesión con tu cuenta de AirOps y Claude se encarga del resto. No hay claves de API ni tokens que gestionar. ### ¿Cómo sé si estoy conectado? En Claude web/escritorio: * Ve a **Configuración → Conectores** * AirOps debería mostrarse como "Conectado" También puedes comprobarlo preguntándole a Claude: ``` "¿A qué Brand Kits tengo acceso en AirOps?" ``` Si Claude devuelve la lista de tus Brand Kits, estás conectado. ### ¿Cómo me desconecto o me reconecto? **Para desconectarte:** 1. Ve a **Configuración → Conectores** 2. Encuentra AirOps 3. Haz clic en **Desconectar** **Para reconectarte:** Sigue de nuevo los pasos de conexión. Si tienes problemas, desconéctate primero para borrar la autenticación almacenada en caché. ### ¿Cómo se gestiona la autenticación? 1. Haces clic en **Conectar** en Claude 2. Claude te redirige a AirOps 3. Inicias sesión con tus credenciales de AirOps 4. AirOps emite un token OAuth para Claude 5. Claude usa este token para las solicitudes 6. Los tokens se actualizan automáticamente; no necesitas volver a autenticarte No se almacenan contraseñas ni claves de API en Claude. Puedes revocar el acceso en cualquier momento desconectándote. *** ## Casos de uso ### ¿Cómo compruebo mi visibilidad en IA? ``` "¿Cómo le está yendo a mi marca en la búsqueda por IA?" "¿Cuál ha sido mi tasa de menciones en los últimos 30 días?" "Muéstrame las tendencias de visibilidad en IA de los últimos 2 meses" ``` ### ¿Cómo me comparo con la competencia? ``` "¿Cómo me comparo con mis competidores?" "¿Cuál es mi cuota de voz frente a Clari?" "¿Qué competidores están obteniendo más citas?" ``` ### ¿Cómo hago un seguimiento por proveedor de IA? ``` "¿Cómo me va en ChatGPT frente a Perplexity frente a Gemini?" "¿Qué proveedor de IA menciona más mi marca?" ``` ### ¿Cómo encuentro oportunidades de optimización? ``` "¿Qué páginas están perdiendo citas de IA?" "Encuentra páginas cerca de posicionarse en las respuestas de IA" "Muéstrame prompts de alto volumen en los que no se me menciona" ``` ### ¿Cómo creo informes? ``` "Crea un informe que resuma el rendimiento de visibilidad en IA" "Guarda un informe que pueda compartir con mi equipo" ``` Los informes se guardan en AirOps y Claude devuelve un enlace compartible. ### ¿Cómo creo cuadrículas de acción? ``` "Crea una cuadrícula de acción para las páginas que están perdiendo visibilidad" "Configura una cuadrícula para optimizar estas páginas" ``` Claude crea una cuadrícula en AirOps con tus páginas, lista para agentes avanzados. Ver [Casos de uso](/docs/es/desarrolladores/use-cases.md) para más ejemplos y mejores prácticas. *** ## Mejores prácticas ### ¿Cuáles son las mejores preguntas para hacer? **Sé específico sobre el alcance:** * Bien: "Muéstrame las páginas que han perdido citas en los últimos 30 días" * Menos bien: "Muéstrame todos mis datos" **Ve de forma progresiva:** 1. "¿Cómo estoy rindiendo en general?" 2. "¿En qué temas soy más fuerte?" 3. "Muéstrame las páginas principales en ese tema" **Especifica rangos de tiempo:** * "Compara este mes con el mes pasado" * "Muéstrame la tendencia de las últimas 8 semanas" **Usa preguntas orientadas a resultados:** * "¿Qué debería optimizar primero?" * "¿Dónde estoy perdiendo frente a los competidores?" * "¿Cuáles son mis mayores oportunidades?" ### ¿Cómo selecciono un Brand Kit? Si tienes varios Brand Kits, especifícalos por nombre: ``` "¿Cómo le está yendo a Gong en la búsqueda por IA?" "Usa el Brand Kit de Acme Corp" ``` O pregunta: "¿A qué Brand Kits tengo acceso?" Claude recuerda tu selección durante la conversación. ### ¿Puedo realizar acciones o solo leer datos? Ambas cosas. Puedes: * **Crear informes** — Guardados en AirOps con enlaces compartibles * **Crear cuadrículas de acción** — Páginas organizadas para su optimización * **Obtener enlaces directos** — Ir directamente a páginas, informes y cuadrículas en AirOps *** ## Herramientas ### ¿Qué herramientas están disponibles? **Espacio de trabajo y Brand Kit:** | Herramienta | Descripción | | ----------------------- | -------------------------------------------------------------------------------- | | `list_workspaces` | Lista los espacios de trabajo a los que tienes acceso | | `list_brand_kits` | Lista los Brand Kits con las funciones de AEO y gestión de marca activadas | | `get_brand_kit` | Obtén la identidad de marca, el estilo de escritura y las entidades relacionadas | | `get_insights_settings` | Obtén la configuración de AEO (competidores, personas, cantidad de prompts) | | `update_brand_kit` | Actualiza el nombre de la marca, la URL, el tono de escritura y la persona | | `publish_brand_kit` | Publica los cambios del borrador para activarlos | | `get_legacy_brand_kit` | Obtén el Brand Kit heredado para flujos de migración | **Gestión de Brand Kit:** | Herramienta | Descripción | | ---------------------------------- | ------------------------------------------- | | `manage_brand_kit_product_line` | Crear o actualizar líneas de producto | | `manage_brand_kit_competitor` | Crear o actualizar competidores | | `manage_brand_kit_audience` | Crear o actualizar audiencias | | `manage_brand_kit_region` | Crear o actualizar regiones | | `manage_brand_kit_content_type` | Crear o actualizar tipos de contenido | | `manage_brand_kit_content_sample` | Crear o actualizar muestras de contenido | | `manage_brand_kit_writing_rule` | Crear o actualizar reglas de redacción | | `manage_brand_kit_custom_variable` | Crear o actualizar variables personalizadas | Las ediciones del Brand Kit usan `update_brand_kit` y `manage_brand_kit_*` después de la confirmación del usuario. Permanecen en borrador hasta que el usuario las confirme explícitamente `publish_brand_kit`. Consulta [Edita un borrador de Brand Kit](/docs/es/desarrolladores/tools.md#edit-a-brand-kit-draft). **Analítica de AEO:** | Herramienta | Descripción | | -------------------------- | ------------------------------------------------------------------------------------ | | `list_aeo_prompts` | Prompts de IA rastreados para un Brand Kit | | `get_prompt_answers` | Respuestas de IA para un prompt específico | | `get_answer` | Respuesta completa de IA con citas y menciones | | `list_aeo_citations` | URLs citadas en las respuestas de IA | | `get_aeo_citation` | Detalles de una URL citada específica | | `list_aeo_domains` | Dominios citados en las respuestas de IA | | `list_pages` | Páginas con recuentos de AEO, GSC, GA4 y Agent Analytics | | `list_aeo_agent_analytics` | Recuentos diarios de rastreos y visitas de agentes de IA por motor y tipo de rastreo | | `get_page_details` | Métricas detalladas para una página específica | | `get_page_prompts` | Prompts de IA que citan una página específica | | `list_topics` | Temas configurados para un Brand Kit | | `list_personas` | Personas configuradas para un Brand Kit | | `query_analytics` | Consultas de métricas personalizadas con dimensiones flexibles | | `analytics_chart` | Visualización interactiva de gráficos (solo Claude Web y Desktop) | | `create_report` | Crear informes analíticos guardados | | `list_reports` | Listar informes guardados | | `get_report` | Obtener un informe específico | **Bases de conocimiento:** | Herramienta | Descripción | | ----------------------- | ------------------------------------------------------------- | | `list_knowledge_bases` | Listar las bases de conocimiento disponibles | | `search_knowledge_base` | Buscar en una base de conocimiento usando similitud semántica | Ver [Referencia de herramientas](/docs/es/desarrolladores/tools.md) para la documentación completa. *** ## Otros asistentes de IA ### ¿Puedo usar AirOps con Cursor, VS Code o Windsurf? Sí. AirOps funciona con cualquier cliente compatible con MCP. **Cursor:** ```json { "mcpServers": { "airops": { "url": "https://app.airops.com/mcp" } } } ``` **VS Code / Windsurf:** ```json { "mcp": { "servers": { "airops": { "command": "npx", "args": ["-y", "mcp-remote", "https://app.airops.com/mcp"] } } } } ``` Ver [Primeros pasos](/docs/es/desarrolladores/getting-started.md) para instrucciones detalladas de configuración. *** ## Solución de problemas ### Claude dice "necesita autenticación" **Claude web/escritorio:** 1. Ve a **Configuración → Conectores** 2. Encuentra AirOps y haz clic en **Reconectar** 3. Completa el inicio de sesión OAuth **Claude Code:** 1. Ejecuta `/mcp` 2. Selecciona el servidor de AirOps 3. Elige **Autenticar** 4. Completa OAuth en el navegador ### Las herramientas no aparecen 1. **Reinicia Claude** — Cierra y vuelve a abrir la aplicación 2. **Verifica la conexión** — Configuración → Conectores debería mostrar "Conectado" 3. **Reconectar** — Desconecta y vuelve a conectar la integración ### Conexión rechazada o tiempo de espera agotado * Verifica que puedas acceder a `https://app.airops.com` en tu navegador * Las redes corporativas pueden bloquear las conexiones MCP; contacta con TI * Prueba a desconectar temporalmente la VPN ### OAuth no funciona (WSL/corporativo) **Usuarios de WSL:** Es posible que OAuth del navegador falle desde WSL. Ejecuta Claude desde Windows en su lugar. **Redes corporativas:** Tu red puede bloquear las redirecciones OAuth. Prueba con una red personal o pide a TI que incluya en la lista blanca `app.airops.com`. ### ¿Cómo borro la autenticación almacenada en caché? 1. Desconecta: **Configuración → Conectores → Desconectar** 2. Reconéctate y completa OAuth de nuevo Para Claude Code: ```bash claude mcp remove airops claude mcp add --transport http airops https://app.airops.com/mcp ``` *** ## Seguridad ### ¿Mis datos están seguros? Sí. El conector usa: * **OAuth 2.0 con PKCE** — Autenticación estándar de la industria * **HTTPS** — Todos los datos cifrados en tránsito * **Permisos a nivel de usuario** — Accede solo a tus Brand Kits * **Sin almacenamiento de credenciales** — Los tokens OAuth se gestionan de forma segura ### ¿A qué puede acceder el conector? **Acceso de lectura:** * Brand Kits para los que tienes permiso * Páginas y métricas * Datos analíticos * Prompts y citas * Bases de conocimiento **Crear y actualizar:** * Informes (guardados en tu cuenta) * Cuadrículas de acción * Configuración del Brand Kit (nombre, URL, tono de escritura, persona) * Entidades del Brand Kit (líneas de producto, competidores, audiencias, regiones, tipos de contenido, muestras de contenido, reglas de redacción) * Publica los borradores del Brand Kit para activar los cambios **No puede:** * Eliminar ningún dato * Acceder a los espacios de trabajo de otros usuarios *** ## Recursos **Documentación de AirOps** * [Conector de Claude](/docs/es/desarrolladores/claude-connector.md) * [Primeros pasos](/docs/es/desarrolladores/getting-started.md) * [Casos de uso](/docs/es/desarrolladores/use-cases.md) * [Referencia de herramientas](/docs/es/desarrolladores/tools.md) **Documentación de Claude** * [Configuración de integraciones](https://support.anthropic.com/en/articles/10168395-setting-up-claude-integrations) * [Directorio de conectores](https://support.anthropic.com/en/articles/11724452-using-the-connectors-directory-to-extend-claude-s-capabilities) * [MCP remoto](https://support.anthropic.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp) --- # 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/faq.md?ask=&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.