MCP-server för arbetsytor i Control Hub

MCP-serverfunktioner för arbetsytor

Översikt

MCP-servern (Workspaces Model Context Protocol) gör arbetsyta- och enhetsinsikter från Control Hub tillgängliga för agentprogram som stöds. När servern har aktiverats i Control Hub kan godkända verktyg ge skrivskyddad åtkomst till arbetsytans hälsa, enhetsstatus, konfigurationsinformation, användningsdata och historisk diagnostik.

Servern hjälper IT-administratörer att felsöka problem med arbetsytan, övervaka enhetens hälsa, granska konfigurationstillstånd och förstå utrymmesutnyttjande utan att lämna sin föredragna agentapp.

Vem kan använda MCP-servern Workspaces

MCP-servern Workspaces är avsedd för administratörer som hanterar arbetsytor och enheter i Control Hub.

Åtkomst baseras på administratörens roll Control Hub:

Fullständiga administratörer kan komma åt arbetsyta- och enhetsinformation i hela organisationen.
Platsadministratörer kan komma åt de arbetsytor och enheter som tillåts av deras rollinställningar.

Förmågor

MCP-servern Workspaces kan tillhandahålla skrivskyddad information för följande användningsfall:

Användningsfall	Vad administratörer kan granska
Övervakning av arbetsytan	Arbetsyta och enhetshälsa i hela organisationen.
Enhetsdiagnostik	Enhetsproblem, händelsehistorik och felkodsinformation.
Konfigurationsinsikter	Aktuella enhetskonfigurationer, konfigurationshistorik, information om konfigurationsschema och jämförelser av konfigurationsmallar.
Användningsanalys	Beläggnings-, bokning-, miljö- och användningstrender som kan hjälpa till att identifiera utrymmen med lågt eller högt utnyttjande.
Historisk felsökning	Enhets- och arbetsytahistorik som kan hjälpa till att identifiera återkommande problem.
Inventering	Information om arbetsyta, plats och enhetslager för din organisation.

Exempel på uppmaningar

Administratörer kan ställa frågor till agentiska appar som stöds, till exempel:

Visa mig de bästa arbetsytorna som behöver uppmärksamhet.
Vilka rum har lägst utnyttjandegrad?
Visa alla enheter med anslutningsproblem.
Jämför enhetsinställningar i alla rum på våning 5.
Visa mig enheter som behöver firmwareuppdateringar.
Skapa en hälsorapport för alla mötesrum före kl. 09.00.

Begränsningar

MCP-servern Workspaces ger skrivskyddad åtkomst. Det ändrar inte enheter, arbetsytor eller konfigurationer.
Användare kan bara komma åt de arbetsytor och enheter som tillåts av deras Control Hub-roll.

Aktivera MCP-servern för arbetsytor i Control Hub

Aktivera MCP-servern (Workspaces Model Context Protocol) från Agentic Apps i Control Hub så att godkända agentprogram kan använda skrivskyddade arbetsytor och enhetsdata.

I området Agentic Apps i Control Hub kan administratörer tillhandahålla agentappar för sin organisation, konfigurera användaråtkomst och autentisering och definiera styrningskontroller för agentfunktioner som är tillgängliga för användarna.

Ciscos officiella servrar ingår automatiskt i listan över agentappar, men administratörer måste aktivera och granska autentisering, verktygsåtkomst, och schemaändringar innan servern är tillgänglig för användare.

Innan du börjar

Du kan logga in på Control Hub som administratör.
Din organisation har tillgång till Agentic Apps i Control Hub.
Du har granskat organisationens styrnings-, säkerhets- och ansvarskrav för MCP-applikationer.
Du förstår att din organisation ansvarar för att granska, följa och hantera ansvarsramverket för MCP-applikationer.

Logga in på Control Hub.

Gå till Appar > Agentic Apps.

Sidan Agentic-appar listar offentliga agentappar och privata appar som användare i din organisation har infört.

Control Hub Apps page with Agentic Apps selected and a list of Webex MCP servers, including Workspaces.

Öppna MCP-servern Workspaces från applistan.

På fliken Allmän t väljer du om du vill tillåta eller blockera servern för alla användare i organisationen.

Workspaces MCP server General tab showing access settings, automatic server data updates, server details, and transport type.

Valfritt: Auktorisera automatiska serverdatauppdateringar. När det är aktiverat behöver uppdateringar av servernamnet, beskrivningen, webbadressen inom samma domän, transporttyp eller andra metadata inte auktoriseras på nytt innan de träder i kraft. Control Hub visar fortfarande en indikation på att ändringar inträffade, och du kan auktorisera servern igen efter eget gottfinnande.

Klicka på Spara för att bekräfta ändringarna.

Granska autentiser ingsinställningarna på fliken Autentisering.

Workspaces MCP server Authentication tab showing OAuth 2.0 authorization code settings and custom header fields.

Ciscos officiella servrar konfigureras automatiskt. Ändra autentiseringsinställningarna endast när du behöver ändra standardautentiseringen.

De tillgängliga autentiseringsmetoderna beror på hur appen konfigureras i utvecklarportalen.

Metod	Vad du ska tillhandahålla
OAuth 2.0-klientuppgifter	Klient-ID, klienthemlighet, auktoriseringsserver-URL, autentiseringsmetod för tokenslutpunkt och omfattning.
OAuth 2.0 auktoriseringskod	Klient-ID, klienthemlighet, registreringsslutpunkt, auktoriseringsslutpunkt, auktoriseringsserver-URL, autentiseringsmetod för tokenslutpunkt och omfattning.
Användartoken	Ingen inmatning krävs.
API-nyckel	API-nyckeln.
Anpassade rubriker	Upp till fem nyckelvärdepar.

För OAuth 2.0-klientautentiseringsuppgifter kan autentiseringsmetoden för token Endpoint vara client_secret_basiceller. client_secret_post För OAuth 2.0-auktoriseringskod kan autentiseringsmetoden för tokenslutpunkt vara none, client_secret_basic, eller. client_secret_post

Du kan konfigurera anpassade rubriker för alla autentiseringstyper.

Granska serverfunktionerna.

För MCP-servrar visar Control Hub separata flikar för Verk tyg, Resur ser och Prompt.

Aktivera eller inaktivera de verktyg som användare i organisationen kan använda på fliken Verktyg.

Workspaces MCP server Tools tab showing the available tools, with controls to allow each tool, allow signature changes, and review details.

När ett verktyg är aktiverat kan användare upptäcka och använda det från klienter som stöds enligt den åtkomst som du konfigurerar. När ett verktyg är inaktiverat är det inte synligt eller tillgängligt för användare.

Om du aktiverar Tillåt signaturändring kan verktyget användas efter att schemaändringarna har ändrats. Control Hub visar fortfarande att verktygssignaturen har ändrats, och du kan granska och auktorisera verktyget för att godkänna det uppdaterade schemat. Vi rekommenderar att du aktiverar Tillåt signaturändring för att undvika störningar.

Om du låter Tillåt signaturändring vara inaktiverat kan verktyget inte användas efter en schemaändring förrän en administratör granskar och godkänner det igen.

Beroende på hur MCP-klienten hanterar versionshantering och schemacachning kan ytterligare steg krävas innan det uppdaterade schemat blir tillgängligt.

Granska enskilda verktygsdetaljer och schemaändringar.

Du kan granska varje verktygs inmatningsschema, utmatningsschema och anteckningar för att förstå vilka data verktyget accepterar, vilket svar det returnerar och vilka ytterligare metadata som är associerade med verktyget.

Granska och konfigurera flikarna Resur ser och Upp maningar.

På flikarna Resur ser och Uppmaningar kan du granska och hantera tillgängliga resurser och uppmaningar.

Slutför eventuella återstående auktoriseringsmeddelanden i Control Hub.

MCP-servern för arbetsytor är tillgänglig för användare beroende på åtkomst, autentisering och funktioner som du har konfigurerat i Control Hub.

Besök developer.webex.com för att läsa om hur du ansluter MCP-servern Workspaces till din MCP-klient.

Övriga resurser: