> 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/pt/programadores/codex-plugin.md). # Plugin do Codex Configure o plugin MCP do AirOps no Codex com Aplicações Interativas O plugin AirOps MCP liga o Codex ao seu espaço de trabalho AirOps. Fornece configuração com um clique e suporte para Apps interativas, incluindo gráficos e interfaces de revisão do Brand Kit renderizadas diretamente na sua tarefa. ## Configuração rápida 1. Abra o [plugin MCP da AirOps](https://chatgpt.com/plugins/plugin_asdk_app_6a8774407d4081919100aae8d18bba79). 2. Selecione **Instalar plugin**. 3. Conclua o fluxo de início de sessão da AirOps quando solicitado. Após a instalação e autenticação, a AirOps fica disponível como uma origem de plugin nas visualizações de tarefas do Codex suportadas. {% hint style="info" %} A disponibilidade do plugin depende do seu plano do Codex, das definições do espaço de trabalho, da função e da região. Num espaço de trabalho gerido, um administrador pode ter de disponibilizar o plugin antes de o poder instalar ou usar. {% endhint %} ## Aplicativos Interativos O plugin do Codex suporta **Aplicativos Interativos**, interfaces em direto renderizadas diretamente na sua tarefa em vez de descrições de texto. ### O que você verá | App interativa | Caso de uso | | -------------------------------- | ------------------------------------------------------------------ | | Gráficos de linha | Tendências ao longo do tempo, incluindo taxa de menções e citações | | Gráficos de barras e de sectores | Comparações entre concorrentes, fornecedores e tópicos | | Cartões de KPI | Métricas atuais com variações no período | | Tabelas de dados | Páginas, prompts, citações e outros resultados detalhados | | Revisão do Brand Kit | Reveja e aceite ou rejeite as alterações sugeridas ao Brand Kit | ### Exemplo ``` Você: "Mostre-me como a nossa taxa de menções mudou nos últimos dois meses." Codex: [Apresenta um gráfico de tendências interativo] A sua taxa de menções aumentou de 9% para 18%. ``` ### Usando Aplicativos Interativos * **Ver em linha:** Os gráficos e as interfaces de revisão aparecem diretamente na tarefa. * **Interaja:** Passe o cursor sobre os dados do gráfico ou use os controlos fornecidos pela app. * **Refine:** Peça ao Codex para alterar o intervalo de datas, as métricas, o agrupamento ou o tipo de gráfico. * **Reveja as alterações:** Aceite ou rejeite as edições sugeridas ao Brand Kit antes de as aplicar. As Apps interativas aparecem automaticamente quando o Codex chama uma ferramenta AirOps suportada. ### Resolução de problemas das Apps interativas Se uma App interativa não aparecer: 1. Confirme que o plugin AirOps está selecionado em **Sources → Use plugins**. 2. Peça explicitamente um gráfico ou uma revisão do Brand Kit, como "Mostre-me um gráfico da tendência da minha taxa de menções." 3. Verifique se a sua conta AirOps pode aceder ao Brand Kit e aos dados solicitados. 4. Inicie uma nova tarefa depois de voltar a ligar o plugin. ## Usar a AirOps no Codex Numa visualização de tarefa do Codex suportada: 1. Abrir **Origens**. 2. Selecione **Usar plugins**. 3. Procure e selecione o plugin AirOps instalado. 4. Peça ao Codex para trabalhar com os seus dados da AirOps. Por exemplo: ``` Revise o desempenho da nossa pesquisa por IA nos últimos 30 dias e identifique as maiores oportunidades. ``` ## Gerir o plugin ### Reconectar Se a AirOps precisar novamente de autenticação, abra o plugin a partir de **Sources → Use plugins** e conclua o fluxo de início de sessão quando solicitado. ### Acesso ao espaço de trabalho Os administradores do espaço de trabalho podem gerir a disponibilidade do plugin a partir de **Definições do espaço de trabalho → Plugins**. Podem rever as capacidades incluídas do plugin e escolher se fica disponível para os membros instalarem ou se é instalado automaticamente para funções elegíveis. O acesso ao plugin não contorna as permissões da conta AirOps ligada. ## Resolução de problemas ### Plugin não encontrado Verifique se: 1. Está a usar uma visualização de tarefa do Codex suportada. 2. O plugin está instalado para a sua conta ou função. 3. O administrador do seu espaço de trabalho ativou o acesso se usar um espaço de trabalho gerido. As alterações no diretório do Codex podem demorar a atualizar. Se o plugin tiver sido publicado ou ativado recentemente, tente novamente mais tarde. ### Autenticação necessária Abrir **Sources → Use plugins**, selecione AirOps e conclua o fluxo de autenticação. Se o problema continuar, termine a sessão da AirOps no seu navegador e autentique-se novamente. ### Ferramentas ou dados não estão disponíveis Confirme que: * O plugin AirOps está selecionado para a tarefa. * A sua conta AirOps pode aceder aos dados solicitados do espaço de trabalho. * Está a pedir uma capacidade suportada pelo plugin. ## Plugin do Codex vs configuração direta do MCP | Funcionalidade | plugin MCP da AirOps | Configuração direta do MCP | | ----------------------- | -------------------------------------------------- | ------------------------------------------------------------ | | Configuração | Instalar a partir do diretório de plugins do Codex | Configurar manualmente o servidor MCP | | Aplicativos Interativos | Sim | Depende do cliente MCP | | Autenticação | Concluir o fluxo de configuração do plugin | Autenticar no seu cliente MCP | | Ideal para | Tarefas do Codex | Claude Code, Cursor, VS Code, Windsurf e outros clientes MCP | O plugin usa o servidor MCP da AirOps em `https://app.airops.com/mcp`. ## O que pode fazer * **Revise a inteligência de pesquisa de IA:** Acompanhe a taxa de menções, a taxa de citações e a quota de voz * **Analise concorrentes:** Compare o desempenho em várias plataformas de IA * **Encontre oportunidades:** Descubra páginas a perder citações ou perto de ranquear * **Crie relatórios:** Gere painéis guardados para as partes interessadas * **Acompanhe por fornecedor:** Compare ChatGPT, Perplexity, Gemini e Claude * **Gerir a identidade da marca:** Atualize o nome da marca, a descrição, o tom de escrita e a persona * **Configurar entidades da marca:** Gira linhas de produtos, públicos, regiões, tipos de conteúdo, regras de escrita e concorrentes * **Pesquisar bases de conhecimento:** Encontre conteúdo relevante nos seus documentos usando pesquisa 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/pt/programadores/codex-plugin.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.