Skip to main content
About docs.netapp.com
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Comece com o servidor MCP do docs.netapp.com

Colaboradores netapp-aoife

Conecte seu ambiente de desenvolvimento de IA ao servidor Model Context Protocol (MCP) do docs.netapp.com. Depois de configurar o servidor MCP, você pode usá-lo para retornar respostas derivadas da documentação técnica do produto publicada em docs.netapp.com.

Pré-requisitos

Antes de configurar o servidor MCP docs.netapp.com, verifique o seguinte:

  • Você analisou os requisitos e limitações em "Saiba mais sobre o servidor MCP do docs.netapp.com".

  • Você tem acesso a um cliente compatível com MCP, como o Visual Studio Code com GitHub Copilot, Claude Desktop, Cursor ou frameworks de agentes baseados em Python.

  • Você precisa ter uma chave de assinatura válida. Se você não fornecer uma chave, as solicitações MCP falharão e retornarão um erro de acesso. Para solicitar uma chave de assinatura, entre em contato com ng-docs-mcp@netapp.com com uma breve descrição do seu caso de uso.

  • Você tem acesso à rede ao endpoint MCP do docs.netapp.com: https://docs.netapp.com/mcp.

Configure seu ambiente de desenvolvimento

Escolha a opção de configuração para o seu ambiente.

Configuração do Visual Studio Code

Você pode se conectar ao servidor MCP a partir do Visual Studio Code usando o GitHub Copilot, configurando um mcp.json arquivo.

Antes de começar
  • Esta tarefa requer o Visual Studio Code com a extensão GitHub Copilot ativada.

Passos
  1. Na sua área de trabalho do projeto no Visual Studio Code, execute as seguintes etapas:

    1. Crie uma pasta chamada .vscode

    2. Crie um arquivo dentro da pasta chamado mcp.json

  2. Configure o arquivo mcp.json.

    {
      "servers": {
        "netapp-docs-mcp": {
          "type": "http",
          "url": "https://docs.netapp.com/mcp",
          "headers": {
            "Ocp-Apim-Subscription-Key": "${input:Ocp-Apim-Subscription-Key}"
          }
        }
      },
      "inputs": [
        {
          "type": "promptString",
          "id": "Ocp-Apim-Subscription-Key",
          "description": "Enter your access key",
          "password": true
        }
      ]
    }
  3. Salve o arquivo.

  4. Opcionalmente, configure o acesso global.

    Para configurar o servidor MCP docs.netapp.com em todos os projetos e espaços de trabalho do Visual Studio Code, adicione a configuração ao diretório de configurações globais do usuário.

    • Windows: C:\Users\<your_username>\AppData\Roaming\Code\User\mcp.json

    • macOS: ~/Library/Application Support/Code/User/mcp.json

      Adicione a definição do servidor:

    {
      "servers": {
        "netapp-docs-mcp": {
          "type": "http",
          "url": "https://docs.netapp.com/mcp",
          "headers": {
            "Ocp-Apim-Subscription-Key": "${input:Ocp-Apim-Subscription-Key}"
          }
        }
      },
      "inputs": [
        {
          "type": "promptString",
          "id": "Ocp-Apim-Subscription-Key",
          "description": "Enter your access key",
          "password": true
        }
      ]
    }

    +

    Observação Após modificar o arquivo global mcp.json, reinicie o Visual Studio Code para aplicar a configuração.
  5. Verifique a configuração.

    1. Abra o Visual Studio Code em seu espaço de trabalho.

    2. Confirme se o .vscode/mcp.json arquivo está presente.

    3. Faça uma pergunta usando o Copilot.

      Exemplo

      Quais são as diferenças entre o ONTAP e o Cloud Volumes ONTAP?

Configuração do Claude Desktop

Para registrar o servidor MCP docs.netapp.com com o Claude Desktop, atualize o arquivo de configuração:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "netapp-docs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://docs.netapp.com/mcp",
        "--header",
        "Ocp-Apim-Subscription-Key:${NETAPP_MCP_KEY}"
      ],
      "env": {
        "NETAPP_MCP_KEY": "paste-your-subscription-key-here"
      }
    }
  }
}

Configuração do cursor

Para registrar o servidor MCP docs.netapp.com com o Cursor, atualize o arquivo de configuração.

Para aplicar a configuração globalmente, utilize os seguintes caminhos:

  • Mac OS: ~/.cursor/mcp.json

  • Windows: %USERPROFILE%\.cursor\mcp.json

Para aplicar a configuração em um único projeto, utilize .cursor/mcp.json no diretório raiz do projeto.

Observação Se o arquivo já tiver outros servidores MCP configurados, adicione netapp-docs-mcp dentro do objeto mcpServers existente (certifique-se de adicionar uma vírgula após a entrada anterior). Se não houver a chave mcpServers, adicione a chave no nível superior, ao lado de quaisquer outras configurações.
{
  "mcpServers": {
    "netapp-docs-mcp": {
      "url": "https://docs.netapp.com/mcp",
      "headers": {
        "Ocp-Apim-Subscription-Key": "paste-your-subscription-key-here"
      }
    }
  }
}

Integração de agente de IA em Python

Use esta opção se você estiver criando aplicativos ou agentes de IA que chamam diretamente o servidor MCP.

Seu cliente se conecta ao endpoint do MCP e invoca as ferramentas.

client = MCPClient("https://docs.netapp.com/mcp",
  headers={
          "Ocp-Apim-Subscription-Key": "<YOUR_API_KEY>"
      }
  )
response = client.call_tool("netapp_docs_ask", {
    "question": "What are ONTAP upgrade steps?"
})

Use o servidor MCP do docs.netapp.com

Após configurar o servidor MCP, você pode interagir com a documentação técnica da NetApp diretamente na interface do cliente de sua preferência.

Sobre esta tarefa
  • O cliente de IA escolhe a ferramenta apropriada para fornecer resultados com base na sua consulta.

  • Use perguntas claras e completas em vez de consultas curtas ou vagas.

  • As respostas são sempre derivadas da documentação oficial da NetApp.

Passos
  1. Abra o chat no seu cliente compatível com MCP.

  2. Invoque o servidor MCP configurado e faça uma pergunta clara sobre os produtos ou procedimentos da NetApp.

  3. Revise a resposta.

Informações relacionadas