Conectando-se a um servidor MCP a partir de um cliente MCP

Conecte-se a um Model Context Protocol(MCP) de um cliente MCP criando uma integração de entrada OAuth e configurando o cliente com os detalhes do servidor.

Com o Servidor de início rápido ou depois de criar um servidor, você pode concluir as seguintes etapas para se conectar a um servidor a partir de um cliente:

1. Crie uma integração de entrada do OAuth para um cliente MCP
2. Configure um cliente MCP para se conectar a um servidor MCP

O processo para configurar um cliente para se conectar a um servidor depende do cliente usado. Para obter mais informações, consulte a documentação da sua aplicação de IA e do seu cliente.

Crie uma integração de entrada do OAuth para um cliente MCP

Acesso seguro a Model Context Protocol(MCP) em uma instância criando uma integração de entrada OAuth para cada cliente MCP.

Antes de Iniciar

Função necessária: oauth_admin, mi_admin, admin

Por Que e Quando Desempenhar Esta Tarefa

Para cada cliente que você deseja acessar servidores em uma instância, crie uma integração de entrada do OAuth no Console de identidade da máquina. Para criar a integração do OAuth, você precisa de um URL de redirecionamento do cliente. Para obter mais informações, consulte a documentação da sua aplicação de IA e do seu cliente.

Procedimento

1. Navegar até Tudo > Console do servidor MCP.
2. Na guia Configuração, selecione Servidores .
3. Na faixa de configuração necessária do OAuth, selecione Configure o OAuth .
   Como alternativa, você pode navegar até Tudo > Console de identidade da máquina e selecione Integrações de entrada .

   Nota:

   Na lista de integrações de entrada existentes, você pode ver integrações criadas com os mesmos nomes dos servidores (incluindo sublinhados). Essas são integrações para monitorar servidores de Torre de controle de IA e não deve ser usado para integrar com clientes.
4. Selecione Nova integração .
5. Selecione OAuth - Concessão de código de autorização .
6. No formulário, preencha os campos obrigatórios.
   Para obter mais informações sobre este formulário, consulte Configure an OAuth authorization code grant.

   Tabela 1. Formulário de integração de entrada

   Campo	Valor
   Seção de detalhes
   Nome	Insira um nome para a integração do OAuth.
   URLs de redirecionamento	Insira o URL de redirecionamento de um cliente. O código de autorização é enviado para este URL após a autenticação. Para obter o URL de redirecionamento, consulte a documentação da aplicação de IA e do cliente. Para se conectar ao ServiceNow Cliente MCP em outra instância, use o seguinte URL de redirecionamento: https://<client-instance>.service-now.com/oauth_redirect.do . Para obter mais informações, consulte Cliente do Model Context Protocol documentação.
   Seção Escopo de autenticação
   Permitir acesso somente a APIs no escopo selecionado	Desmarque a caixa de seleção para tornar a integração do OAuth com escopo amplo.
   Seção de opções avançadas
   Formato do token	Selecione JWT .

7. Selecione Save (Salvar).
   A integração de entrada do OAuth é criada com escopo amplo com um ID de cliente e segredo de cliente que você usa ao configurar o cliente para se conectar aos servidores na instância.

   

O que Fazer Depois

Configure o cliente para usar o ID do cliente e o segredo do cliente para autenticar com os servidores na instância.

Configure um cliente MCP para se conectar a um servidor MCP

Configure um Model Context Protocol(MCP) cliente para se conectar a um servidor MCP e solicitar que o servidor execute uma tarefa.

Antes de Iniciar

Função necessária: nenhuma

Por Que e Quando Desempenhar Esta Tarefa

O processo para configurar um cliente para se conectar a um servidor depende do cliente usado. O procedimento a seguir é uma visão geral de alto nível do fluxo de trabalho para configurar um cliente para chamar um servidor. Para obter mais informações, consulte a documentação da sua aplicação de IA e do seu cliente. Para obter um exemplo que demonstra como se conectar de um servidor em uma instância ao ServiceNow Cliente do Model Context Protocol em outra instância, veja o exemplo após este procedimento.

Procedimento

1. Configure um cliente com os detalhes do servidor necessários, conforme determinado pelo cliente.

   Tabela 2. Detalhes do servidor para a configuração do cliente MCP

   Detalhes do servidor	Valor
   URL do servidor	<server-name>://<server-instance>.service-now.com/sncapps/mcp-server/mcp/ Para se conectar ao Servidor de início rápido pré-configurado, use https://<server-instance>.service-now.com/sncapps/mcp-server/mcp/sn_mcp_server_default .
   Host	<server-instance>.service-now.com
   URL base	/sncapps/mcp-server
   Escopo	servidor_mcp
   Tipo de autenticação	OAuth 2.0
   Provedor de identidade	OAuth genérico 2
   URL de Autorização	https://<server-instance>.service-now.com/oauth_auth.do
   URL do token	https://<server-instance>.service-now.com/oauth_token.do
   URL de revogação do token	https://<server-instance>.service-now.com/oauth_revoke.do
   URL de atualização	https://<server-instance>.service-now.com/oauth_auth.do
   Redirecional URL	https://<server-instance>.service-now.com/oauth/callback
   ID de cliente	O ID do cliente da integração de entrada do OAuth na instância do servidor.
   Segredo do cliente	O segredo do cliente da integração de entrada do OAuth na instância do servidor.

   Depois de configurar esses detalhes, o cliente chama o servidor com <token> do portador cabeçalho. Se o token for validado pelo servidor, o cliente receberá a lista de ferramentas disponíveis para uso.

2. No cliente, você pode exibir a lista de ferramentas disponíveis para determinar como solicitar o servidor.
3. Insira um prompt para as informações necessárias ou para que a ferramenta execute uma ação na instância.

   Por exemplo, se a ferramenta Pesquisar registros de incidentes estiver disponível, você poderá inserir "Obter todos os incidentes em aberto". Com a ferramenta Resumo de casos, você pode inserir "Resumir todos os casos encerrados esta semana".

   O servidor executa as ferramentas relevantes e retorna o resultado para o cliente como dados JSON. O cliente apresenta a resposta como texto formatado.

Conectando-se a um servidor MCP de ServiceNow Cliente do Model Context Protocol

Este exemplo demonstra como se conectar a um servidor de um agente de IA em outra instância usando o. ServiceNow Cliente do Model Context Protocol. Primeiro, configure o cliente para chamar o servidor de início rápido pré-configurado. Em um agente de IA, você acessa a lista de ferramentas do Servidor de início rápido e adiciona ferramentas individuais ao agente. Por fim, você testa o agente em Estúdio de agentes de IA fornecendo um prompt e vendo a resposta do agente. Para obter mais informações, consulte Cliente do Model Context Protocol documentação.

Função necessária: sn_mcp_client.admin

1. Na instância do servidor, crie uma integração de entrada OAuth para o. ServiceNow Cliente do Model Context Protocol.

   Para obter mais informações, consulte Crie uma integração de entrada do OAuth para um cliente MCP.

2. Na instância do cliente, navegue até Tudo > Studio do agente de IA > Configurações.
3. Selecione Gerenciar servidores MCP .
4. Selecione Novo.
5. Adicione o Servidor de início rápido.

   Para obter mais informações sobre esta etapa, consulte Adicione um Servidor MCP com OAuth 2,1.

   1. No formulário Adicionar servidor MCP, preencha os campos.

      Tabela 3. Formulário de Adicionar servidor MCP

      Campo	Valor
      Nome	Servidor de início rápido
      Tipo de autenticação	OAuth 2.1
      URL do servidor do MCP	https://<server-instance>.service-now.com/sncapps/mcp-server/mcp/sn_mcp_server_default

   2. Selecione Avançar.
   3. No formulário, preencha os campos.

      Tabela 4. Formulário de Adicionar servidor MCP

      Campo	Valor
      Tipo de registro de cliente	Registro manual
      Tipo de concessão	Código de autorização
      Método de autenticação de token	Publicação secreta do cliente
      ID de cliente	O ID do cliente da integração de entrada do OAuth para Cliente do Model Context Protocol na instância do servidor.
      Segredo do cliente	O segredo do cliente da integração de entrada do OAuth para Cliente do Model Context Protocol na instância do servidor.
      URL de Autorização	https://<server-instance>.service-now.com/oauth_auth.do
      URL do token	https://<server-instance>.service-now.com/oauth_token.do
      URL de revogação do token	https://<server-instance>.service-now.com/oauth_revoke.do

   4. Selecione Save (Salvar).
6. Verifique a configuração do OAuth.
   1. Selecione Autenticar .
   2. Selecione Permitir para permitir que o cliente se conecte ao servidor.
7. Adicione ferramentas do Servidor de início rápido a um agente de IA.

   Para obter mais informações sobre esta etapa, consulte Adicione um MCP Ferramenta do servidor para um agente de IA.

   1. Em Estúdio de agentes de IA, selecione Criar e gerenciar .
   2. Na guia Agentes de IA, selecione um agente existente ou crie um.

      Para obter informações sobre como criar um agente, consulte Crie um agente de IA.

   3. Selecione Adicione ferramentas e informações .
   4. Selecionar Adicionar ferramenta > Ferramenta do servidor do MCP.
   5. No formulário, preencha os campos.

      Tabela 5. Adicione um Model Context Protocol Formulário da ferramenta

      Campo	Valor
      Selecione Model Context Protocol servidor	Servidor de início rápido
      Selecionar ferramenta	Selecione as ferramentas do Servidor de início rápido que você deseja usar com este agente de IA.

      

   6. Selecione Adicionar.
   7. Selecione Salvar e continuar.
8. Teste o agente de IA.

   Para obter mais informações sobre esta etapa, consulte Teste um agente de IA.

   1. Em Estúdio de agentes de IA, selecione Teste .
   2. Selecione Inicie o teste manual .
   3. No campo Escolha um tipo de teste, selecione Fluxo de trabalho ou agente de IA .
   4. Selecione o agente de IA que você configurou e sua versão.
   5. No campo Tarefa, insira um prompt para obter informações ou executar uma ação na instância.

      O prompt deve ser baseado em quais ferramentas estão disponíveis. Por exemplo, se você adicionou as ferramentas Pesquisar registros de caso e Resumo de caso, poderá inserir "Resumir todos os casos encerrados esta semana".

      

   6. Selecione Continuar para Testar resposta do bate-papo .

   O agente de IA chama o servidor e o servidor executa as ferramentas solicitadas com base no prompt. O servidor retorna as informações para o agente como dados JSON e o agente as apresenta como texto formatado. Neste exemplo, o agente retorna resumos dos casos encerrados por Abel Tuter na semana passada.