Een externe MCP-server registreren in Agentforce Registry
Maak een verbinding met een MCP-server en maak een goedgekeurde lijst van de servertools die u met uw agenten wilt gebruiken.
Vereiste editions
| Beschikbaar in: Lightning Experience |
| Beschikbaar in: Enterprise, Performance, Unlimited en Developer Edition. Vereiste uitbreidingslicenties variëren per type agent. |
| Vereiste gebruikersmachtigingen | |
|---|---|
| Een MCP-server registreren: | AI-agenten beheren EN de vereiste machtigingen voor uw agenttype |
- Geef vanuit Set-up Agentforce op in het vak Snel zoeken en selecteer vervolgens Agentforce Registry.
- Klik op Nieuw. U kunt een volledig nieuwe server registreren of vooraf in een pakket opgenomen servers bekijken en installeren vanuit AgentExchange.
- Geef een servernaam, beschrijving en URL op.
-
Selecteer een authenticatiemethode. We ondersteunen geen authenticatie en OAuth 2.0-clientinloggegevens. We ondersteunen bepaalde geavanceerde authenticatiepatronen met aanvullende configuratie, waaronder OAuth 2.1-clientinloggegevens.
Als u OAuth 2.0 selecteert, geeft u de volgende velden op. U kunt deze informatie doorgaans vinden in de instellingen of documentatie van uw identiteitsleverancier, of in de documentatie voor de MCP-server die u registreert.
- URL van identiteitsleverancier: De URL van uw autorisatieserver, die het servereindpunt aangeeft voor gebruikersauthenticatie en autorisatieaanvragen. Als u een server registreert vanuit AppExchange die OAuth 2.0 gebruikt, wordt dit veld automatisch ingevuld en kan het niet worden bewerkt.
- Bereik (optioneel): Een lijst machtigingen die de MCP-server nodig heeft voor de client voor toegang tot servertools en API's, opgemaakt als een met komma's gescheiden lijst. Als u een server registreert vanuit AppExchange die OAuth 2.0 gebruikt, wordt dit veld automatisch ingevuld en kan het niet worden bewerkt.
- Client-ID: De unieke ID van de MCP-server, die wordt gebruikt om toegang aan te vragen via de autorisatieserver.
- Klantgeheim: Een wachtwoord dat alleen bekend is bij de MCP-server en de autorisatieserver, dat wordt gebruikt om de MCP-server te authenticeren bij het aanvragen van toegangstokens. Moet veilig worden bewaard.
Voorbeeld: OAuth 2.0 De MCP-server van PayPal gebruikt OAuth 2.0 om een veilige verbinding tot stand te brengen tussen een MCP-client en de MCP-server van PayPal. In het OAuth 2.0-protocol wisselt de client diens client-ID en clientgeheim uit voor een toegangstoken.
- De URL voor de PayPal MCP-server is https://mcp.paypal.com/http.
- De URL van de identiteitsleverancier is https://api-m.sandbox.paypal.com/v1/oauth2/token.
- De ontwikkelaarsdocumentatie van PayPal biedt een lijst van veelvoorkomende bereiken voor toegang tot PayPal-API's.
De bereiken van PayPal worden geschreven in URL-indeling, maar bereiken kunnen worden geschreven in elke tekenreeksindeling (bijvoorbeeld "lezen" of "services-betaling-terugbetaling"). Raadpleeg de documentatie voor uw MCP-server voor details.
- De MCP-serverdocumentatie van PayPal bevat stappen voor het gebruik van een client-ID en klantgeheim van een PayPal-account.
-
Klik op Maken and doorgaan.
Salesforce maakt een verbinding met de server en verzendt een ping om de verbinding te valideren.Wanneer u de verbinding maakt, maakt Salesforce een benoemd inloggegeven, extern inloggegeven en machtigingenset voor u, zodat Salesforce kan verifiëren met uw server. De machtigingenset ("ServerName-machtigingenset") wordt automatisch aan u toegewezen en laat u de server beheren. U hoeft de machtigingenset niet toe te wijzen aan gebruikers of de gebruikersrecord van de agent om uw agent uw servertools te laten gebruiken. Meer informatie over benoemde inloggegevens, externe inloggegevens en machtigingensets.
Opmerking Als u de machtigingenset verwijdert die is gekoppeld aan een geregistreerde server of de machtigingenset verwijdert uit uw gebruikersrecord, kunt u uw server niet bewerken of beheren (bijvoorbeeld goedgekeurde lijst of servertools verwijderen). -
Nadat uw verbinding is gemaakt, selecteert u de servertools die agenten moeten kunnen gebruiken. Klik vervolgens op Volgende.
Sta alleen tools toe die u Trust. Voordat u de goedgekeurde lijst opneemt, controleert u zorgvuldig de namen en beschrijvingen van tools om ervoor te zorgen dat u de functie en het bereik ervan begrijpt. Als u een waarschuwing ziet dat een of meer toolbeschrijvingen bidirectionele of decoratieve Unicode-lettertekens, onzichtbare lettertekens of meerdere talen of scripts bevatten, worden deze tools als hoog risico beschouwd. Kopieer en plak de toolbeschrijvingen in een teksteditor en beoordeel ze handmatig voordat u ze op de goedgekeurde lijst zet.
- Als u beleidsvormen voor MCP-servers in Agentforce Gateway hebt gemaakt die handmatig kunnen worden toegevoegd, kunt u deze desgewenst toepassen op uw server. Als uw server voldoet aan de voorwaarden voor op regels gebaseerde MCP-serverbeleidsvormen die u hebt gemaakt, worden de beleidsvormen automatisch toegepast.
- Sla uw wijzigingen op.
Nadat u hebt opgeslagen, worden de MCP-servertools die u hebt geselecteerd, toegevoegd aan de activumbibliotheek als agentacties en zijn ze beschikbaar voor toevoeging aan een agent.
Als u de MCP-toolacties wilt bekijken die beschikbaar zijn om toe te voegen aan een agent, geeft u vanuit Set-up Agentforce Assets op in het vak Snel zoeken en selecteert u vervolgens Agentforce Assets. Selecteer het tabblad Acties. Toolacties volgen het naampatroon "Tool Name ServerName" en worden aangegeven door het pictogram 
. Als u geen agentactie ziet die is gekoppeld aan uw MCP-tool, vernieuwt u de pagina.
- Geavanceerd authenticatiepatroon: OAuth 2.1-stroom voor clientinloggegevens
Gebruik de onderliggende authenticatiestack om een MCP-server te registreren die OAuth 2.1-clientinloggegevens gebruikt. - MCP Server-registraties beheren in Agentforce Registry
Bewerk de details, tools en beleidsvormen van uw MCP-server of verwijder uw MCP-serverregistratie volledig.
Heeft dit artikel uw probleem opgelost?
Laat ons weten wat we kunnen doen om te verbeteren!
