# Use os documentos com IA {% columns %} {% column width="41.66666666666667%" %} Cada página na documentação da Navixy inclui atalhos integrados para trabalhar com assistentes de IA. Use-os para copiar conteúdo, abrir páginas diretamente no ChatGPT ou Claude, ou conectar a documentação diretamente às suas ferramentas de IA através do MCP. {% endcolumn %} {% column width="58.33333333333333%" %}
{% endcolumn %} {% endcolumns %} ## Atalhos de página integrados | Atalho | O que faz | Quando usar | | -------------------------------- | ----------------------------------------------------- | --------------------------------------------------------------------------------------------- | | **Copiar página** | Copia a página inteira como Markdown | Cole o contexto completo em qualquer assistente de IA | | **Ver como Markdown** | Abre a página como texto simples em uma nova aba | Inspecione a fonte bruta ou copie seções específicas manualmente | | **Copiar** (em blocos de código) | Copia um bloco de código diretamente | Usar para `curl` comandos, cargas JSON e trechos de configuração para evitar erros de seleção | | **Abrir no ChatGPT** | Abre a página no ChatGPT com o conteúdo pré-carregado | Faça perguntas ou resumir sem colar nada | | **Abrir no Claude** | Abre a página no Claude com o conteúdo pré-carregado | Faça perguntas ou resumir sem colar nada | | **Exportar como PDF** | Faz o download da página como PDF | Salve um instantâneo para uso offline ou compartilhe fora da documentação | ### Usando Abrir no ChatGPT e Abrir no Claude Ambos os atalhos enviam automaticamente a página atual como contexto. Você pode começar a pedir imediatamente sem copiar ou colar. Isso é útil quando você quer uma resposta rápida sobre uma página específica sem alternar ferramentas manualmente. {% columns %} {% column %} **Boas solicitações para começar:** * Resuma esta página antes que eu a leia por completo. * Transforme isto em uma checklist de pré-requisitos. * Gere casos de borda e ideias de teste a partir desta referência. * Explique o que \[parameter] faz e quando eu o alteraria. {% endcolumn %} {% column %} **Obtendo respostas melhores:** Adicione uma restrição para moldar a resposta. Peça por "apenas passos", "retornar JSON" ou "primeiro as suposições". Se a página for longa, especifique em qual seção você quer que o assistente foque. {% endcolumn %} {% endcolumns %} ## Conectando o servidor MCP às suas ferramentas de IA Os atalhos de página acima funcionam bem quando você já tem a página certa aberta. MCP (Model Context Protocol) vai além: permite que sua ferramenta de IA pesquise e recupere qualquer página da documentação da Navixy sob demanda, sem que você precise encontrar e abrir a página primeiro. Isso é especialmente útil durante o desenvolvimento ativo, quando você está navegando por múltiplas referências de API, configurações de dispositivos e guias de integração em uma única sessão. Uma vez conectado, sua ferramenta de IA recupera respostas diretamente da documentação publicada e pode vincular às seções específicas que utilizou. ### Endpoint MCP O servidor MCP é público e não requer autenticação: ``` https://www.navixy.com/docs/~gitbook/mcp ``` Você também pode copiar este URL diretamente do **Conectar com MCP** opção no menu de atalhos da página. ### Conectar servidor MCP Use a configuração Abaixo você pode encontrar etapas de configuração para as ferramentas mais comuns. MCP funciona com qualquer cliente que suporte `mcpServers` configuração. {% tabs %} {% tab title="Claude Desktop" %} 1. No Claude, vá para **Configurações** e selecione **Desenvolvedor**. 2. Selecione **Editar Config** para abrir `claude_desktop_config.json`, então adicione o seguinte: ```json { "mcpServers": { "navixy-docs": { "command": "npx", "args": [ "mcp-remote", "https://www.navixy.com/docs/~gitbook/mcp" ] } } } ``` 3. Saia do Claude completamente e inicie-o novamente. Recarregar a janela não é suficiente. {% endtab %} {% tab title="Cursor" %} 1\. Vá para **Configurações**, abra a **MCP** guia, e selecione **Adicionar novo servidor MCP global**. Isso abre `~/.cursor/mcp.json`. Para uma configuração por projeto, crie ou edite `.cursor/mcp.json` na raiz do seu projeto em vez disso. 2. Cole o seguinte no arquivo: ```json { "mcpServers": { "navixy-docs": { "command": "npx", "args": [ "mcp-remote", "https://www.navixy.com/docs/~gitbook/mcp" ] } } } ``` 3. Saia do Cursor completamente e inicie-o novamente. Recarregar a janela não é suficiente. {% endtab %} {% tab title="VS Code" %} Se você usa VS Code, este é o caminho de configuração mais rápido. Selecione **Conectar ao VSCode** no menu de atalhos da página. Isso abre um prompt para instalar o servidor MCP diretamente no seu ambiente VS Code sem configuração manual. 1. Abra o VS Code e vá para as configurações da extensão do seu assistente de IA. * Se a extensão suportar `mcpServers` configuração, cole: ```json { "mcpServers": { "navixy-docs": { "command": "npx", "args": [ "mcp-remote", "https://www.navixy.com/docs/~gitbook/mcp" ] } } } ``` * Se a extensão suportar endpoints MCP HTTP diretos, use o URL em vez disso: ``` https://www.navixy.com/docs/~gitbook/mcp ``` Use o método documentado pela sua extensão. 2. Saia do VS Code completamente e inicie-o novamente. {% endtab %} {% tab title="Outros IDEs" %} Se sua ferramenta suportar MCP com um comando local, cole a seguinte configuração: ```json { "mcpServers": { "navixy-docs": { "command": "npx", "args": [ "mcp-remote", "https://www.navixy.com/docs/~gitbook/mcp" ] } } } ``` Se suportar MCP via HTTP diretamente, use o URL do endpoint em vez disso: ``` https://www.navixy.com/docs/~gitbook/mcp ``` Em ambos os casos, reinicie a ferramenta completamente após adicionar o servidor. {% endtab %} {% endtabs %} ### Validar a conexão MCP Após a configuração, execute este prompt para confirmar se o servidor está respondendo: ``` Use o servidor MCP de docs navixy-docs. Quais páginas cobrem fluxos do IoT Logic? Liste as páginas que você encontrou e vincule cada uma. ``` Se a resposta incluir links para páginas específicas da documentação Navixy, a conexão está funcionando. Uma vez confirmada, você pode pedir ao assistente para recuperar qualquer página, encontrar endpoints ou traçar um fluxo completo através de múltiplas seções da documentação. ## Solução de problemas **Nada mudou depois de adicionar o servidor.** Reinicie a ferramenta completamente. Saia do aplicativo e abra-o novamente. Recarregar a janela não é suficiente. **O assistente responde mas não cita fontes.** Peça links explicitamente. Você também pode pedir que ele cite uma frase curta da seção referenciada para confirmar que recuperou o conteúdo correto. **O conteúdo colado parece quebrado.** Verifique se há linhas quebradas (wrap). Isso é mais comum com `curl` comandos e caminhos de API longos copiados da documentação.