> 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/faq.md). # Perguntas frequentes Perguntas frequentes sobre AirOps MCP, o Plugin Codex e o Connector Claude ## Primeiros passos ### O que é o Conector Claude da AirOps? O Conector Claude da AirOps permite-lhe aceder diretamente aos seus dados de AEO (AI Engine Optimization) a partir das conversas no Claude. Em vez de alternar entre o Claude e o painel da AirOps, faça ao Claude perguntas como "Como está a minha marca a ter desempenho na pesquisa em IA?" e obtenha insights instantâneos. Encontre-o no [Diretório de Conectores do Claude](https://claude.ai/settings/connectors): clique **"Pesquisa e ferramentas"** na sua conversa e selecione **"Adicionar conectores"**, ou vá para **Definições → Conectores → Explorar conectores**. Procure "AirOps", clique em Ligar e autentique-se com a sua conta AirOps. ### O que posso fazer com o AirOps no Claude? * **Monitorizar a visibilidade em IA** — Verificar a taxa de menções, a taxa de citações, a quota de voz * **Analisar concorrentes** — Comparar o desempenho entre plataformas de IA * **Encontrar oportunidades** — Descobrir páginas a perder citações ou perto de entrar no ranking * **Criar relatórios** — Gerar painéis guardados para as partes interessadas * **Acompanhar por fornecedor** — Comparar ChatGPT, Perplexity, Gemini e Claude * **Explorar prompts** — Encontrar perguntas de IA em que é ou não é mencionado * **Gerir a identidade da marca** — Atualizar o nome da marca, o tom de escrita, a persona e o estilo * **Configurar entidades da marca** — Gerir linhas de produtos, públicos, regiões, tipos de conteúdo, regras de escrita e concorrentes * **Pesquisar Bases de Conhecimento** — Encontrar conteúdo relevante nos seus documentos ### Qual é a diferença entre o Claude Connector e o MCP? **Conector Claude** é a integração nativa no Diretório de Conectores do Claude: * Configuração com um clique * Aplicações interativas (gráficos renderizados na conversa) * OAuth automático **MCP** é o protocolo subjacente. Use-o para Cursor, VS Code, Windsurf ou Claude Code: * Configuração manual * Mesmas ferramentas, configuração diferente | Funcionalidade | Conector Claude | MCP | | ----------------------- | -------------------- | ------------------------- | | Configuração | Um clique | Manual | | Aplicativos Interativos | Sim | Depende do cliente | | Ideal para | Claude Web e Desktop | Cursor, VS Code, Windsurf | ### Que aplicações do Claude suportam o AirOps? | App | Método de ligação | Aplicativos Interativos | | -------------- | -------------------- | ----------------------- | | Codex | plugin MCP da AirOps | Sim | | Claude Web | Conector Claude | Sim | | Claude Desktop | Conector Claude | Sim | | Claude Code | MCP | Não | ### De que planos preciso? **AirOps:** Um espaço de trabalho pago, incluindo um teste elegível do nível pago. As consultas de insights também requerem AEO ativado e um Brand Kit configurado. Os espaços de trabalho gratuitos podem ligar e usar `list_workspaces`, mas as ferramentas de recursos devolvem uma restrição de plano. **Claude:** Pro, Team ou Enterprise. O plano gratuito não suporta conectores. *** ## Aplicativos Interativos ### O que são Aplicações Interativas? Alguns plugins e conectores apresentam interfaces dinâmicas e interativas na sua conversa ou tarefa, em vez de devolverem apenas texto. Pode ver o gráfico ou rever a interface diretamente onde está a trabalhar. No Codex, instale e selecione o plugin AirOps para usar as suas Aplicações Interativas. No Claude, os conectores com esta capacidade mostram um **selo "Interativo"** no diretório. ### O AirOps suporta Aplicações Interativas? Sim. Quando pergunta sobre tendências ou métricas, o AirOps pode apresentar: * **Gráficos de linha** para tendências ao longo do tempo * **Gráficos de barras** para comparações * **Cartões de KPI** para métricas atuais * **Tabelas de dados** para dados detalhados ### Porque é que não vejo visualizações? 1. **Verifique a sua ligação:** No Codex, selecione AirOps em **Sources → Use plugins**. No Claude, verifique se o AirOps está ligado em **Configurações → Conectores**. 2. **Verifique o acesso:** Confirme que a sua conta pode aceder ao Brand Kit e aos dados do AirOps solicitados. 3. **Seja explícito:** Experimente "Mostre-me um gráfico da minha tendência de taxa de menções." 4. **Volte a ligar:** Volte a ligar o AirOps e, em seguida, inicie uma nova conversa ou tarefa. *** ## Ligação ### Como ligo o Claude (web/desktop)? 1. Vá para **Configurações → Conectores** 2. Procure por **"AirOps"** 3. Clique em **Conectar** 4. Entre com sua conta AirOps ### Como ligo o Claude Code? ```bash claude mcp add --transport http airops https://app.airops.com/mcp ``` Depois autentique-se: 1. Executar `/mcp` no Claude Code 2. Selecione o servidor AirOps 3. Escolha **Autenticar** 4. Conclua o OAuth no seu navegador ### Preciso de uma chave de API? Não. O conector usa OAuth — inicia sessão com a sua conta AirOps e o Claude trata do resto. Não há chaves de API nem tokens para gerir. ### Como sei se estou ligado? No Claude web/desktop: * Vá para **Configurações → Conectores** * O AirOps deve aparecer como "Ligado" Também pode testar perguntando ao Claude: ``` "A que Brand Kits tenho acesso no AirOps?" ``` Se o Claude devolver a sua lista de Brand Kits, está ligado. ### Como me desligo ou volto a ligar? **Para desligar:** 1. Vá para **Configurações → Conectores** 2. Encontre o AirOps 3. Clique em **Desconectar** **Para voltar a ligar:** Siga novamente os passos de ligação. Se estiver a ter problemas, desligue primeiro para limpar a autenticação em cache. ### Como é tratada a autenticação? 1. Clica **Conectar** no Claude 2. Claude redireciona-o para o AirOps 3. Inicia sessão com as suas credenciais AirOps 4. O AirOps emite um token OAuth para o Claude 5. O Claude usa este token para pedidos 6. Os tokens são atualizados automaticamente — não é necessário voltar a autenticar-se Não são armazenadas palavras-passe nem chaves de API no Claude. Pode revogar o acesso a qualquer momento ao desligar. *** ## Casos de utilização ### Como verifico a minha visibilidade em IA? ``` "Como está a minha marca a ter desempenho na pesquisa de IA?" "Qual é a minha taxa de menções nos últimos 30 dias?" "Mostre-me tendências de visibilidade em IA dos últimos 2 meses" ``` ### Como me comparo com os concorrentes? ``` "Como me comparo com os concorrentes?" "Qual é a minha quota de voz vs. a Clari?" "Que concorrentes estão a receber mais citações?" ``` ### Como acompanho por fornecedor de IA? ``` "Como me saio no ChatGPT vs. Perplexity vs. Gemini?" "Que fornecedor de IA menciona mais a minha marca?" ``` ### Como encontro oportunidades de otimização? ``` "Que páginas estão a perder citações de IA?" "Encontre páginas perto de entrar no ranking nas respostas de IA" "Mostre-me prompts de grande volume em que não sou mencionado" ``` ### Como crio relatórios? ``` "Crie um relatório a resumir o desempenho da visibilidade em IA" "Guarde um relatório que eu possa partilhar com a minha equipa" ``` Os relatórios são guardados no AirOps e o Claude devolve um link partilhável. ### Como crio grelhas de ação? ``` "Crie uma grelha de ação para páginas a perder visibilidade" "Crie uma grelha para otimizar estas páginas" ``` O Claude cria uma grelha no AirOps com as suas páginas, pronta para agentes avançados. Veja [Casos de utilização](/docs/pt/programadores/use-cases.md) para mais exemplos e melhores práticas. *** ## Boas práticas ### Quais são as melhores perguntas a fazer? **Seja específico quanto ao âmbito:** * Bom: "Mostre-me as páginas a perder citações nos últimos 30 dias" * Menos bom: "Mostre-me todos os meus dados" **Construa progressivamente:** 1. "Como estou a desempenhar-me no geral?" 2. "Em que tópicos sou mais forte?" 3. "Mostre-me as principais páginas nesse tópico" **Especifique intervalos de tempo:** * "Compare este mês com o mês passado" * "Mostre-me a tendência das últimas 8 semanas" **Use perguntas orientadas para resultados:** * "O que devo otimizar primeiro?" * "Onde estou a perder para os concorrentes?" * "Quais são as minhas maiores oportunidades?" ### Como seleciono um Brand Kit? Se tiver vários Brand Kits, especifique pelo nome: ``` "Como está a Gong a ter desempenho na pesquisa de IA?" "Use o brand kit da Acme Corp" ``` Ou pergunte: "A que Brand Kits tenho acesso?" O Claude lembra-se da sua seleção durante a conversa. ### Posso tomar medidas ou apenas ler dados? Ambos. Pode: * **Criar relatórios** — Guardados no AirOps com links partilháveis * **Criar grelhas de ação** — Páginas organizadas para otimização * **Obter links diretos** — Ir para páginas, relatórios e grelhas no AirOps *** ## Ferramentas ### Que ferramentas estão disponíveis? **Espaço de trabalho e Brand Kit:** | Ferramenta | Descrição | | ----------------------- | --------------------------------------------------------------------- | | `list_workspaces` | Listar os espaços de trabalho a que tem acesso | | `list_brand_kits` | Listar Brand Kits com AEO e sinalizadores de gestão de marca | | `get_brand_kit` | Obter identidade da marca, estilo de escrita e entidades relacionadas | | `get_insights_settings` | Obter configuração de AEO (concorrentes, personas, número de prompts) | | `update_brand_kit` | Atualizar nome da marca, URL, tom de escrita, persona | | `publish_brand_kit` | Publicar alterações em rascunho para as tornar ativas | | `get_legacy_brand_kit` | Obter o Brand Kit legado para fluxos de migração | **Gestão do Brand Kit:** | Ferramenta | Descrição | | ---------------------------------- | ------------------------------------------- | | `manage_brand_kit_product_line` | Criar ou atualizar linhas de produto | | `manage_brand_kit_competitor` | Criar ou atualizar concorrentes | | `manage_brand_kit_audience` | Criar ou atualizar públicos | | `manage_brand_kit_region` | Criar ou atualizar regiões | | `manage_brand_kit_content_type` | Criar ou atualizar tipos de conteúdo | | `manage_brand_kit_content_sample` | Criar ou atualizar exemplos de conteúdo | | `manage_brand_kit_writing_rule` | Criar ou atualizar regras de escrita | | `manage_brand_kit_custom_variable` | Criar ou atualizar variáveis personalizadas | As edições do Brand Kit usam `update_brand_kit` como no `manage_brand_kit_*` após confirmação do utilizador. Permanecem em rascunho até o utilizador confirmar explicitamente `publish_brand_kit`. Veja [Edite um rascunho do Brand Kit](/docs/pt/programadores/tools.md#edit-a-brand-kit-draft). **Análises de AEO:** | Ferramenta | Descrição | | -------------------------- | -------------------------------------------------------------------------------------- | | `list_aeo_prompts` | Prompts de IA rastreados para um Brand Kit | | `get_prompt_answers` | Respostas de IA para um prompt específico | | `get_answer` | Resposta completa de IA com citações e menções | | `list_aeo_citations` | URLs citados nas respostas de IA | | `get_aeo_citation` | Detalhes para uma URL citada específica | | `list_aeo_domains` | Domínios citados nas respostas de IA | | `list_pages` | Páginas com contagens de AEO, GSC, GA4 e Agent Analytics | | `list_aeo_agent_analytics` | Contagens diárias de rastreios e visitas de Agentes de IA por motor e tipo de rastreio | | `get_page_details` | Métricas detalhadas para uma página específica | | `get_page_prompts` | Prompts de IA que citam uma página específica | | `list_topics` | Tópicos configurados para um Brand Kit | | `list_personas` | Personas configuradas para um Brand Kit | | `query_analytics` | Consultas de métricas personalizadas com dimensões flexíveis | | `analytics_chart` | Visualização interativa de gráficos (apenas Claude Web e Desktop) | | `create_report` | Criar relatórios de análise guardados | | `list_reports` | Listar relatórios guardados | | `get_report` | Obter um relatório específico | **Bases de Conhecimento:** | Ferramenta | Descrição | | ----------------------- | ----------------------------------------------------------------- | | `list_knowledge_bases` | Listar Bases de Conhecimento disponíveis | | `search_knowledge_base` | Pesquisar numa Base de Conhecimento usando similaridade semântica | Veja [Referência de ferramentas](/docs/pt/programadores/tools.md) para documentação completa. *** ## Outros Assistentes de IA ### Posso usar o AirOps com Cursor, VS Code ou Windsurf? Sim. O AirOps funciona com qualquer cliente compatível com 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"] } } } } ``` Veja [Primeiros passos](/docs/pt/programadores/getting-started.md) para instruções detalhadas de configuração. *** ## Resolução de problemas ### O Claude diz "precisa de autenticação" **Claude web/desktop:** 1. Vá para **Configurações → Conectores** 2. Encontre o AirOps e clique em **Reconectar** 3. Concluir início de sessão OAuth **Claude Code:** 1. Executar `/mcp` 2. Selecione o servidor AirOps 3. Escolha **Autenticar** 4. Conclua o OAuth no navegador ### As ferramentas não aparecem 1. **Reinicie o Claude** — Feche e reabra a aplicação 2. **Verifique a conexão** — Definições → Conectores deve mostrar "Ligado" 3. **Reconectar** — Desligue e volte a ligar a integração ### Ligação recusada ou tempo limite excedido * Verifique se consegue aceder `https://app.airops.com` no seu navegador * As redes corporativas podem bloquear ligações MCP — contacte a TI * Tente desligar temporariamente a VPN ### OAuth não está a funcionar (WSL/corporativo) **Utilizadores de WSL:** O OAuth no navegador pode falhar a partir do WSL. Em vez disso, execute o Claude no Windows. **Redes corporativas:** A sua rede pode bloquear redirecionamentos OAuth. Tente uma rede pessoal ou peça à TI para permitir `app.airops.com`. ### Como limpo a autenticação em cache? 1. Desligar: **Definições → Conectores → Desligar** 2. Volte a ligar e conclua novamente o OAuth Para o Claude Code: ```bash claude mcp remove airops claude mcp add --transport http airops https://app.airops.com/mcp ``` *** ## Segurança ### Os meus dados estão seguros? Sim. O conector usa: * **OAuth 2.0 com PKCE** — Autenticação padrão da indústria * **HTTPS** — Todos os dados encriptados em trânsito * **Permissões ao nível do utilizador** — Acesso apenas aos seus Brand Kits * **Sem armazenamento de credenciais** — Tokens OAuth geridos de forma segura ### A que pode aceder o conector? **Acesso de leitura:** * Brand Kits para os quais tem permissão * Páginas e métricas * Dados analíticos * Prompts e citações * Bases de Conhecimento **Criar e atualizar:** * Relatórios (guardados na sua conta) * Grelhas de ação * Definições do Brand Kit (nome, URL, tom de escrita, persona) * Entidades do Brand Kit (linhas de produto, concorrentes, públicos, regiões, tipos de conteúdo, exemplos de conteúdo, regras de escrita) * Publicar rascunhos do Brand Kit para tornar as alterações ativas **Não pode:** * Eliminar quaisquer dados * Aceder aos espaços de trabalho de outros utilizadores *** ## Recursos **Documentação da AirOps** * [Conector Claude](/docs/pt/programadores/claude-connector.md) * [Primeiros passos](/docs/pt/programadores/getting-started.md) * [Casos de utilização](/docs/pt/programadores/use-cases.md) * [Referência de ferramentas](/docs/pt/programadores/tools.md) **Documentação do Claude** * [Configuração de integrações](https://support.anthropic.com/en/articles/10168395-setting-up-claude-integrations) * [Diretório de Conectores do Claude](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/pt/programadores/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.