Agentin yhdistäminen aiemmin luotuun MCP-palvelimeen

Jos olet jo määrittänyt MCP-palvelimen (Model Context Protocol), voit yhdistää MCP-palvelimen agenttiisi.

Voit yhdistää agentin MCP-palvelimeen Copilot Studio kahdella tavalla:

• Lisää MCP-palvelin Copilot Studio:ssä ohjatulla MCP-perehdyttämistoiminnolla (suositus)
• Mukautetun liittimen luominen palvelimeen Power Apps kautta

Jos sinulla ei vielä ole MCP-palvelinta määritettynä, katso artikkelista Uuden MCP-palvelimen luominen tietoja käytön aloittamisesta.

Tuetut kuljetukset

MCP:ssä kuljetukset ovat asiakas-palvelin-viestinnän perusta. Kuljetukset hoitavat viestien lähettämisen ja vastaanottamisen mekaniikan. Tällä hetkellä Copilot Studio tukee Streamable-siirtotyyppiä.

Vaihtoehto 1: Käytä MCP:n ohjattua perehdyttämistoimintoa (suositus)

Yksinkertaisin tapa muodostaa yhteys aiemmin luotuun MCP-palvelimeen on Copilot Studio sisällä ohjatun MCP-perehdyttämistoiminnon avulla.

Tässä menetelmässä on kaksi osaa:

• MCP-peruspalvelimen tietojen määrittäminen
• Todentamisen määrittäminen MCP-palvelimella

Peruspalvelimen tietojen määrittäminen

1. Siirry agenttisi Työkalut-sivulle .

2. Valitse Lisää työkalu.

3. Valitse Uusi työkalu.

4. Valitse Mallikontekstiprotokolla. MCP:n ohjattu asennustoiminto tulee näkyviin.

   

5. Täytä tarvittavat kentät Palvelimen nimi, Palvelimen kuvaus ja Palvelimen URL-osoite. Kirjoita lyhyt kuvaus MCP-palvelimen toiminnoista. Agentin järjestäjä käyttää näitä tietoja sen määrittämiseen, kutsutaanko palvelinta suorituksen aikana.

6. Valitse MCP-palvelimesi todennustyyppi tarvittaessa. Käytössä on kolme vaihtoehtoa:

   • Ei mitään
   • Ohjelmointirajapinta-avain: Ohjelmointirajapinta-avaimen todentamisen määrittäminen
   • OAuth 2.0: OAuth 2.0 -todennuksen määrittäminen

7. Jos valitsit Ei mitään, valitse Luo. Näyttöön avautuu Lisää työkalu -valintaikkuna. Siirry kohtaan Luo uusi yhteys ja lisää MCP-palvelin agentillesi.

Todentamisen määrittäminen MCP-palvelimella

Jos palvelin vaatii todentamisen, sinulla on kaksi vaihtoehtoa:

• Ohjelmointirajapinta-avain: Valitse tämä vaihtoehto, jos MCP-palvelimesi edellyttää ohjelmointirajapinnan avainta todentamiseen. Ohjelmointirajapinnan avain on yksinkertainen vaihtoehto todentamiseen palvelimella. Agentin käyttäjä antaa ohjelmointirajapinnan avaimen, ja agentti sisällyttää sen MCP-palvelimeen esittämiin pyyntöihin.
• OAuth 2.0: Valitse tämä vaihtoehto, jos MCP-palvelimesi käyttää OAuth 2.0:a todentamiseen. OAuth 2.0 antaa yksittäisten käyttäjien tehdä todennuksen palvelimen avulla ja myöntää käyttöoikeudet sovelluksellesi (agentille) jakamatta tunnistetietojaan.

Jos päätät käyttää todennusta, sinun on määritettävä todennuksen tiedot. Vaiheet riippuvat valitsemastasi todennustyypistä.

Ohjelmointirajapinta-avaimen todentamisen määrittäminen

1. Valitse todennustyypiksi ohjelmointirajapinnan avain . Näet lisää kenttiä, jotta voit määrittää ohjelmointirajapinnan avaimen.

2. Valitse käytettävän ohjelmointirajapinta-avaimen tyyppi . Sinulla on kaksi vaihtoehtoa:

   • Otsikko: Valitse tämä vaihtoehto, jos MCP-palvelimesi edellyttää API-avaimen lähettämisen pyynnön otsikossa.
   • Kysely: Valitse tämä vaihtoehto, jos MCP-palvelimesi edellyttää API-avaimen lähettämisen kyselyparametrina URL-osoitteessa.

3. Anna nimi otsikolle tai kyselyparametrille, johon tulee sisällyttää ohjelmointirajapinta-avain.

4. Valitse Luo. Näyttöön avautuu Lisää työkalu -valintaikkuna. Siirry kohtaan Luo uusi yhteys ja lisää MCP-palvelin agentillesi.

OAuth 2.0 -todennuksen määrittäminen

1. Valitse todennustyypiksi OAuth 2.0 .

2. Valitse käytettävä OAuth 2.0 -todennuksen tyyppi . Käytössä on kolme vaihtoehtoa:

   • Dynaaminen etsintä: Valitse tämä vaihtoehto, jos MCP-palvelimesi tukee OAuth 2.0 :n dynaamista asiakasrekisteröintiä (DCR) etsintämekanismin avulla. Asiakas voi käyttää etsintäpäätepistettä tarvittavien päätepisteiden löytämiseen automaattisesti ja rekisteröityä tunnistetietopalveluun.
   • Dynaaminen: Valitse tämä vaihtoehto, jos MCP-palvelimesi tukee dynaamista OAuth 2.0 DCR:ää, mutta ei tue dynaamista etsintämekanismia. Asiakas voi yhä rekisteröityä tunnistetietopalveluun, mutta tarvittavat päätepisteet on annettava manuaalisesti.
   • Manuaalinen: Valitse tämä vaihtoehto, jos MCP-palvelimesi edellyttää OAuth 2.0 -asetusten manuaalista määritystä.

Dynaaminen etsintä

Jos MCP-palvelimesi tukee OAuth 2.0 Dynamic Client Registration (DCR) -mekanismia, voit käyttää dynaamista etsintätoimintoa. Jos sitä tuetaan, DCR:n etsiminen on yksinkertaisin tapa määrittää OAuth 2.0 -todennus MCP-palvelimella Copilot Studiossa.

1. Valitse Dynaaminen etsintä OAuth 2.0 -todennustyypiksi.

2. Lisää palvelin valitsemalla Luo . Asiakas etsii etsintäpäätepisteen avulla automaattisesti tarvittavat päätepisteet ja rekisteröityy tunnistetietopalveluun.

3. Jatka valitsemalla Seuraava. Näyttöön avautuu Lisää työkalu -valintaikkuna.

4. Jatka uuden yhteyden luomista ja lisää MCP-palvelin agentillesi.

Dynaaminen

1. Valitse OAuth 2.0 -todennustyypiksi Dynaaminen .

2. Täytä tarvittavat kentät:

   • Valtuutuksen URL-osoite: Se tunnistetietopalvelun palvelin, jonka asiakasrekisteröinti- ja valtuutuspäätepisteitä voi käyttää.
   • Tunnuksen URL-malli: Päätepiste, jossa agentti vaihtaa valtuutuskoodin (tai päivitystunnuksen) käyttöoikeustietuetta ja päivitystunnusta varten. Käyttöoikeustietue antaa agenttisi käyttää MCP-palvelinta käyttäjän puolesta. Päivitystunnusten avulla agenttisi voi saada uudet käyttöoikeudet ja päivitystunnukset päivityksen päätepisteestä, kun aiempi käyttöoikeustietue vanhenee.

3. Lisää palvelin valitsemalla Luo . Määrityksestä riippuen takaisinkutsun URL-osoite saattaa tulla näkyviin. Takaisinkutsun URL-osoitteessa tunnistetietopalvelu vastaa valtuutuskoodilla, kun käyttäjä kirjautuu sisään ja myöntää käyttöoikeudet agentillesi.

4. Jos näet takaisinkutsun URL-osoitteen, kopioi takaisinkutsun URL-osoite ja lisää se sovelluksen rekisteröintiin tunnistetietopalvelussasi.

5. Jatka valitsemalla Seuraava. Näyttöön avautuu Lisää työkalu -valintaikkuna.

6. Jatka uuden yhteyden luomista ja lisää MCP-palvelin agentillesi.

Manuaalinen

1. Valitse OAuth 2.0 -tyypiksi Manuaalinen . Lisää kenttiä tulee näkyviin OAuth 2.0 -asetusten määrittämiseksi.

2. Täytä tarvittavat kentät:

   • Asiakastunnus: Asiakastunnus tunnistaa tunnistetietopalvelun ongelmat, kun rekisteröit sovelluksesi. Asiakastunnuksen avulla tunnistetietopalvelu tietää, mikä sovellus tekee pyynnön.
   • Asiakassalasana: Asiakassalasana, jonka tunnistepalvelun tarjoaja myöntää kun rekisteröit sovelluksesi. Agenttisi lähettää asiakassalaisuuden ja asiakastunnuksen todistaakseen, että agenttisi on valtuutettu pyytämään käyttöoikeustietueita MCP-palvelimelle.
   • Valtuutuksen URL: Tunnistetietopalvelun päätepiste, jossa agenttisi ohjaa käyttäjän kirjautumaan sisään ja myöntämään käyttöoikeudet agentillesi (suostumuskortti, joka esitetään agenttikeskustelussa). Käyttäjä todentaa tässä, ja sitten tunnistetietopalvelu vastaa agentille valtuutuskoodilla.
   • Tunnuksen URL-malli: Päätepiste, jossa agentti vaihtaa valtuutuskoodin (tai päivitystunnuksen) käyttöoikeustietuetta ja päivitystunnusta varten. Käyttöoikeustietue antaa agenttisi käyttää MCP-palvelinta käyttäjän puolesta. Päivitystunnusten avulla agenttisi voi saada uudet käyttöoikeudet ja päivitystunnukset päivityksen päätepisteestä, kun aiempi käyttöoikeustietue vanhenee.
   • Päivitä URL-osoite: Päätepiste, jolla pyydetään uutta käyttöoikeustietuetta päivitystunnuksen avulla (jotta käyttäjän ei tarvitse kirjautua sisään uudelleen tunnuksen vanhentuessa).
   • Alueet (Valinnainen): Käyttöoikeudet, joita sovelluksesi pyytää, välilyöntikohtaisena luettelona.

3. Lisää palvelin valitsemalla Luo . Näyttöön tulee takaisinkutsun URL-osoite . Takaisinkutsun URL-osoitteessa tunnistetietopalvelu vastaa valtuutuskoodilla, kun käyttäjä kirjautuu sisään ja myöntää käyttöoikeudet agentillesi.

4. Kopioi takaisinkutsun URL-osoite ja lisää se sovelluksesi rekisteröintiin tunnistetietopalvelussasi.

5. Jatka valitsemalla Seuraava. Näyttöön avautuu Lisää työkalu -valintaikkuna.

6. Jatka uuden yhteyden luomista ja lisää MCP-palvelin agentillesi.

Luo uusi yhteys ja lisää MCP-palvelin agentillesi.

1. Valitse Lisää työkalu -kohdassa Luo uusi yhteys MCP-palvelimelle tai käytä aiemmin luotua yhteyttä.

2. Viimeistele MCP-palvelimen lisääminen agentillesi valitsemalla Lisää agenttiin .

Vaihtoehto 2: Luo mukautettu MCP-liitin Power Appsissa

Voit luoda mukautetun liittimen Power Appsissa manuaalisesti, jos haluat määrittää yhteyden palvelimeen.

Jotta voit suorittaa tämän toiminnon, tarvitset rakennetiedoston MCP-palvelimellesi. Rakennetiedosto on OpenAPI-määrityksen YAML-tiedosto, joka kuvaa MCP-palvelimen ohjelmointirajapinnan.

Saat lisätietoja määritystiedoston ulkoasusta tutustumalla annettuun MCP-palvelimen rakenneesimerkkiin.

1. Siirry agenttisi Työkalut-sivulle .

2. Valitse Lisää työkalu.

3. Valitse Uusi työkalu.

4. Valitse Mukautettu liitin. Sinut ohjataan Power Appsiin luomaan uusi mukautettu liitin.

5. Valitse Uusi mukautettu yhdistin.

6. Valitse Tuo OpenAPI-tiedosto.

7. Siirry rakennetiedostoon ja tuo tiedosto valitsemalla Tuo .

8. Viimeistele määritykset Power Appsissa valitsemalla Jatka . Lisätietoja määritysprosessista on Power Apps dokumentaatiossa osoitteessa Tuo OpenAPI-määritys.

Esimerkki MCP-palvelimen rakenteesta

Tässä on OpenAPI-mallirakennetiedosto MCP-palvelimelle kuvitteellisia tietoja käyttäen YAML-muodossa. Sinun on täytettävä oman MCP-palvelimesi tiedot. Tässä mallissa käytetään Streamable-siirtotyyppiä.

swagger: '2.0'
info:
  title: Contoso
  description: MCP Test Specification, YAML for streamable MCP support in Copilot Studio
  version: 1.0.0
host: contoso.com
basePath: /
schemes:
  - https
paths:
  /mcp:
    post:
      summary: Contoso Lead Management Server
      x-ms-agentic-protocol: mcp-streamable-1.0
      operationId: InvokeMCP
      responses:
        '200':
          description: Success

MCP-yhteyden muokkaaminen

McP-liittimen muokkaaminen tai mukautettujen parametrien lisääminen:

1. Siirry Power Apps- tai Power Automate-portaaliin ja valitse Mukautettavat liittimet.
2. Etsi liitintiedosto liittimien luettelosta ja tee tarvittavat päivitykset käyttämällä jotakin käytettävissä olevista menetelmistä.