NESTA PÁGINA
 

Query Routing Director usando MCP

Use este tópico para usar o MCP (Protocolo de Contexto de Modelo) para consultar o Routing Director.

Observação: O suporte ao MCP é um recurso beta desta versão.

Visão geral e implementação do MCP

O Juniper Routing Director utiliza o Protocolo de Contexto de Modelo (MCP) para permitir que agentes de IA — como Microsoft Copilot, ChatGPT e Claude — estabeleçam uma conexão segura. Por meio dessa integração:

  • Os operadores de rede podem usar agentes de IA para consultar o Routing Director.

  • Os agentes de IA podem acessar o Routing Director como uma fonte de dados e fornecer aos operadores de rede respostas precisas e sensíveis ao contexto às consultas.

O pacote MCP é armazenado no repositório GitHub como um código-fonte aberto em https://github.com/Juniper/routing-director-mcp-server e distribuído por meio do registro MCP.

Benefícios

O servidor MCP ajuda os operadores de rede a consultar dados de rede, criar painéis e acessar KPIs conversacionalmente, em vez de escrever código ou aprender sintaxe de API complexa.

Implantar um servidor MCP

Veja a seguir os pré-requisitos para implantar um servidor MCP em um host (por exemplo, seu laptop):

  • Python versões 3.10 ou 3.11.

  • Acesso ao Routing Director com credenciais válidas de autenticação de interface do usuário (nome de usuário e senha ou token de API)

  • Acessibilidade à API do Routing Director

  • Crie um ambiente virtual Python para instalar os pacotes necessários para executar o servidor MCP.

Veja a seguir as etapas para implantar um servidor MCP:

  1. Baixe o pacote MCP do repositório GitHub MCP e do registro oficial do MCP.

    O código-fonte é mantido no repositório GitHub em https://github.com/Juniper/routing-director-mcp-server.

  2. Em um ambiente virtual Python, instale todos os requisitos definidos no arquivo requirement.txt do pacote MCP usando pip3 install -r requirements.txto .

  3. Crie o arquivo de configuração do servidor MCP (config.json).

    O arquivo de configuração especifica como acessar o Routing Director, como autenticar e quais APIs de componente expor como ferramentas para consultar o Routing Director. Veja a seguir um exemplo do arquivo de configuração:

    Veja a seguir um exemplo de arquivo de configuração do servidor MCP:

    Onde,

    • http_url é a URL base do Routing Director.

    • org_id é o identificador exclusivo da organização no Routing Director que você deseja consultar.

    • auth define a autenticação. Defina o seguinte em auth:

      • type— método de autenticação para se conectar ao Routing Director. Pode levar os valores -basic ou token

        Se você inserir basic, insira valores para:

        • username— Nome de usuário para acessar o Routing Director.

        • password—Senha para o nome de usuário.

        Se você inserir token, insira um token de API gerado pelo Routing Director. Por exemplo:

        Para gerar tokens de API no Routing Director, consulte Gerenciar tokens de API.

    • components é a lista de componentes do Routing Director que podem ser consultados. Components pode assumir um dos seguintes valores:

      • ems— Use o ems componente para pesquisar, reconhecer ou cancelar a confirmação de alarmes relatados no Routing Director.

      • juniper-resiliency-interface— Use o juniper-resiliency-interface componente para buscar eventos de encaminhamento, roteamento e exceção de SO gerados pela Interface de Resiliência da Juniper (JRI) e coletados pelo Routing Director.

      • device-kpi— Use o componente device-kpi para recuperar mensagens de log do sistema do dispositivo coletadas pelo Routing Director.

      components é um parâmetro opcional. Se components não estiver definido, todos os componentes serão considerados.

  4. (Opcional) Habilite a autenticação entre o servidor MCP e o cliente MCP.

    Você pode usar a autenticação de token baseada em arquivo para comunicação entre um cliente MCP e um servidor MCP. Para gerar um token, execute o seguinte comando em seu sistema local:

    Onde, client-id é uma ID que você usa para gerar o token de autenticação.

    Veja a seguir um exemplo da saída gerada: Salve o token gerado em um arquivo .tokens . Por padrão, o token é salvo no diretório raiz do repositório MCP do GitHub.

  5. Inicie o servidor MCP.

  6. Configure um agente de IA para se comunicar com o servidor MCP. Consulte Configurar um agente de IA para se comunicar com o servidor MCP.

    Um agente de IA pode usar ambos stdio e streamable-http como um modo de transporte para se comunicar com o servidor MCP.

Agora você pode consultar dados do Routing Director usando um agente de IA, como o Microsoft Copilot ou o ChatGPT.

Configurar um agente de IA para se comunicar com o servidor MCP

Depois que o servidor MCP estiver configurado, você deverá configurar um agente de IA para se comunicar com o servidor MCP. Você pode configurar a conexão do servidor MCP na configuração do agente de IA. Esta seção fornece as etapas para configurar a conexão com o servidor MCP por meio do Claude e do Copilot.

Configurar Claude

Para configurar Claude:

  1. Abra o arquivo de configuração Claude em um editor de texto.

    • Em uma máquina macOS, execute o seguinte comando no Terminal:

    • Em um computador Windows, abra o prompt de comando e digite:

  2. Adicione a configuração do servidor MCP conforme mostrado abaixo:

  3. Salve o arquivo.

  4. Reinicie Claude.

  5. Verifique a conexão de Claude com o servidor MCP.

    Claude estará conectado ao servidor MCP se as ferramentas do servidor MCP (Chamadas de API) estiverem listadas em + > Conectores.

    Como alternativa, você pode exibir as ferramentas do servidor MCP (chamadas de API) listadas em Extensões de código VS.

    Para garantir que o servidor MCP foi iniciado corretamente, exiba os logs do servidor MCP. Os logs são gerados com base no tipo de comunicação com o agente de IA:

    • Starting MCP server 'Juniper Routing Directory' with transport 'stdio' if stdio é usado.

    • INFO Starting MCP server 'Juniper Routing Directory' with transport 'http' on http://127.0.0.1:30030/mcp if streamable-http é usado.

Configurar o Copilot

Para configurar o Copilot:

  1. Abra o código do Virtual Studio (VS).

    Como alternativa, você pode usar qualquer outro Ambiente de Desenvolvimento Integrado (IDE) que suporte o Copilot e o servidor MCP,

  2. Abra o arquivo de configurações do MCP usando um dos seguintes métodos:

    • Em um macOS, execute o seguinte comando no Terminal:

      Onde, user é o seu nome de usuário na máquina macOS.

    • Em um computador Windows, abra o prompt de comando e digite:

      Onde, user é o seu nome de usuário na máquina Windows.

  3. Adicione a configuração do servidor MCP ao arquivo de configurações, conforme mostrado abaixo:

    Onde,

  4. Salve o arquivo.

  5. Feche e reabra o código VS para que as alterações de configuração do MCP entrem em vigor.

  6. Verifique se o Copilot está conectado ao servidor MCP.

    O Copilot estará conectado ao servidor MCP se você encontrar mensagens indicando conexão bem-sucedida com o servidor MCP no painel Saída do código VS.

    Como alternativa, você pode exibir as ferramentas do servidor MCP (chamadas de API) listadas em Extensões de código VS.

    Para garantir que o servidor MCP foi iniciado corretamente, exiba os logs do servidor MCP. Os logs são gerados com base no tipo de comunicação com o agente de IA:

    • Starting MCP server 'Juniper Routing Directory' with transport 'stdio' if stdio é usado.

    • INFO Starting MCP server 'Juniper Routing Directory' with transport 'http' on http://127.0.0.1:30030/mcp if streamable-http é usado.