Microsoft Teams MCP-kiszolgáló referenciája

Fontos

A Microsoft Agent 365-höz való korai hozzáféréshez a Frontier előzetes verziójának részeként kell lennie. A Frontier közvetlenül összekapcsolja Önt a Microsoft legújabb AI-innovációival. Gyakorlati ismereteket szerezhet az úttörő funkciókról, megoszthatja észrevételeit a termékcsapatokkal, és segíthet a mesterséges intelligencia jövőjének alakításában. A Frontier előzetesekre az ügyfélszerződések meglévő előzetes feltételei vonatkoznak. Mivel ezek a funkciók még fejlesztés alatt állnak, rendelkezésre állásuk és képességeik idővel változhatnak."

Áttekintés

Kiszolgálóazonosító	Megjelenítendő név	Scope	Description
mcp_TeamsServer	Microsoft Teams MCP Server	McpServers.Teams.All	Microsoft Teams Graph MCP-kiszolgáló a csevegések, csatornák, valamint a bennük lévő felhasználók vagy üzenetek kezeléséhez. Ez az MCP-kiszolgáló olyan Teams-műveletekhez használható, mint a csevegések és csevegőüzenetek létrehozása, frissítése és beolvasása, a csapatok és csatornák kezelése, valamint az ezekhez kapcsolódó felügyeleti feladatok végrehajtása.

Csevegőeszközök

mcp_graph_chat_addChatMember

Végpont: POST /v1.0/chats/{chat-id}/members

Hozzáad egy tagot egy csevegéshez a user@odata.bind és @odata.type használatával, valamint a választható szerepkörökkel (tag, tulajdonos). 409-et ad vissza, ha a tag már jelen van, 400-at érvénytelen felhasználói hivatkozások esetén, vagy 403-at, ha a szabályzatok korlátozzák a hozzáadást.

Kötelező paraméterek: chat-id, @odata.type, user@odata.bind, szerepkörök

mcp_graph_chat_createChat

Végpont: POST /v1.0/csevegések

Új Teams-csevegést hoz létre a chatType használatával (a oneOnOne-nak pontosan két résztvevőre, a csoportnak kettőnél többre van szüksége) és tagoknak. 400-at ad vissza, ha a oneOnOne nem megfelelő tagszámú, 409-et, ha ugyanazok a résztvevők már csevegtek, vagy 403-at, ha a hívónak nincs jogosultsága.

Kötelező paraméterek: chatType, tagok

mcp_graph_chat_deleteChat

Végpont: DELETE /v1.0/chats/{chat-id}

Visszaállíthatóan töröl egy csevegést. A 403-at adja vissza, ha az engedély hiányzik, a 404-et, ha már törölték, és a bérlői adatmegőrzési szabályzatok vonatkoznak rá.

Kötelező paraméterek: csevegőazonosító

mcp_graph_chat_deleteChatMessage

Végpont: POST /v1.0/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/softDelete

A csevegőüzenet visszaállítható törlése. A 403-at adja vissza a Chat.ReadWrite nélkül, a 404-et érvénytelen azonosítók esetén, és továbbra is megtarthatja az üzenetet a megfelelőség érdekében.

Kötelező paraméterek: felhasználó-id, csevegés-id, csevegésÜzenet-id

mcp_graph_chat_getChat

Végpont: GET /v1.0/chats/{chat-id}

Lekéri a csevegést azonosító alapján, és metaadatokat ad vissza, például típust és témakört. A 404-et adja vissza, ha a csevegés nem létezik vagy nem látható, vagy ha az engedélyek megtagadva vannak, a 403 értéket adja vissza.

Kötelező paraméterek: csevegőazonosító

mcp_graph_chat_getChatMessage

Végpont: GET /v1.0/chats/{chat-id}/messages/{message-id}

Egy csevegőüzenetet kér le azonosító alapján. A 404 értéket adja vissza, ha az üzenet nem létezik vagy rejtett, vagy a 403 értéket adja vissza megfelelő jogosultságok nélkül.

Kötelező paraméterek: chat-id, message-id

mcp_graph_chat_listChatMembers

Végpont: GET /v1.0/chats/{chat-id}/members

A csevegés résztvevőinek listája. Visszaadja a szerepköröket (tag/tulajdonos/vendég). 403-as hibát ad vissza, ha nincsenek olvasási engedélyek, vagy 404-est, ha a csevegés nem található.

Kötelező paraméterek: csevegőazonosító

mcp_graph_chat_listChatMessages

Végpont: GET /v1.0/chats/{chat-id}/messages

Üzenetek listázása egy csevegésben, választható $top, $filter és $orderby paraméterekkel. Oldalszámozott eredményeket ad vissza; a megfelelőség elrejtheti a tartalmat. A hibák közé tartozik az érvénytelen lekérdezések esetén a 400-as kód, és a korlátozás esetén a 429-es kód.

Kötelező paraméterek: csevegőazonosító

Választható paraméterek: $top, $filter, $orderby

mcp_graph_chat_listChats (beszélgetéslista)

Végpont: GET /v1.0/chats

A hívó csevegéseinek listázása opciókkal: $top, $filter, $expand és $orderby. Csak látható csevegéseket ad vissza; rejtett vagy rendszercsevegések kizárhatók. Érvénytelen rendezési kifejezések esetén 400 értéket ad vissza.

Választható paraméterek: $top, $orderby, $expand, $filter

mcp_graph_chat_postMessage

Végpont: POST /v1.0/chats/{chat-id}/messages

Új egyszerű szöveges üzenetet jelenít meg egy csevegésben. Csevegőazonosítóra és nem üres body.content-ra van szükség; csak a támogatott szöveg. 429-es állapotkódot adhat meg a korlátozás esetén, 403-at, ha hiányoznak az engedélyek, vagy 404-et, ha a csevegés érvénytelen. Nem idempotens – kerülje a vak újrapróbálkozásokat.

Kötelező paraméterek: csevegőazonosító, törzs

mcp_graph_chat_updateChat

Végpont: PATCH /v1.0/chats/{chat-id}

Frissíti a csevegés tulajdonságait, például a csoportos csevegések témakörét. A rendszer 400 hibát ad, ha egy személyes chatben használják, 403-as hibát jogosultság hiányában, vagy 404-es hibát, ha a csevegés nem található.

Kötelező paraméterek: csevegőazonosító, témakör

mcp_graph_chat_updateChatMessage

Végpont: PATCH /v1.0/chats/{chat-id}/messages/{message-id}

Új egyszerű szöveges tartalommal frissíti a csevegőüzeneteket. Előfordulhat, hogy bizonyos rendszer- vagy megfelelőségi üzeneteknél a szerkesztés le van tiltva. A 403-at vagy a 400-at adja vissza, ha a szerkesztés nem engedélyezett, vagy 409-et az ütközések esetén.

Kötelező paraméterek: chat-id, message-id

Csatorna- és csapatfunkciók

mcp_graph_teams_addChannelMember

Végpont: POST /v1.0/teams/{team-id}/channels/{channel-id}/members

Tagot ad hozzá egy privát vagy megosztott csatornához, user@odata.bind és választható szerepkörökkel @odata.type (tulajdonos vagy üres). A normál csatornákon sikertelen, a 409-et adja vissza, ha a tag már jelen van, és 403-at, ha nincs engedélye.

Kötelező paraméterek: team-id, channel-id, displayName, roles, user@odata.bind, @odata.type

mcp_graph_teams_createChannel

Végpont: POST /v1.0/teams/{team-id}/channels

Létrehoz egy csatornát egy csapatban a megjelenítési névvel, opcionális leírással, tagsági típussal (standard, privát, megosztott) és opcionálisan választható tagokkal. A privát vagy megosztott csatornákhoz explicit tagok szükségesek; duplikált vagy érvénytelen tagság miatt 400 vagy 409 hiba lép fel.

Kötelező paraméterek: csapatazonosító, displayName

Választható paraméterek: leírás, membershipType, tagok

mcp_graph_teams_createPrivateChannel

Végpont: POST /v1.0/teams/{team-id}/channels

Privát csatornát hoz létre tagságtípussal: privát. A létrehozáshoz tagokra van szükség, beleértve legalább egy tulajdonost. Hiányzó tagok esetén 400, ismétlődő nevek esetén 409, engedély nélküli 403 értéket ad vissza.

Kötelező paraméterek: csapatazonosító, displayName, tagok

mcp_graph_teams_getChannel

Végpont: GET /v1.0/teams/{team-id}/channels/{channel-id}

Lekéri az opcionális $select és $filter rendelkező csatornát. A 404-es értéket adja vissza, ha a csatorna nem található, vagy ha a hívó nem rendelkezik hozzáféréssel, akkor a 403-at, ha az engedélyek nem megfelelőek, vagy 400-at a nem támogatott szűrők esetében.

Kötelező paraméterek: team-id, channel-id

Választható paraméterek: $select, $filter

mcp_graph_teams_getTeam

Végpont: GET /v1.0/teams/{team-id}

Lekéri a csapattulajdonságokat választható $select és $expand opciókkal. A 403-at vagy a 404-et adja vissza, ha a csapat nem érhető el.

Kötelező paraméterek: csapatazonosító

Választható paraméterek: $select, $expand

mcp_graph_teams_listChannelMembers

Végpont: GET /v1.0/teams/{team-id}/channels/{channel-id}/members

Egy adott Microsoft Teams-csatorna összes tagját felsorolja, és metaadatokat ad vissza az egyes tagokról, például identitásról, szerepkörökről és tagsági állapotról. Hasznos a csatornák részvételének naplózásához, a tagság szerepkör-frissítések előtti ellenőrzéséhez vagy a megfelelőség biztosításához.

Kötelező paraméterek: team-id, channel-id

Választható paraméterek: $top, $expand

mcp_graph_teams_listChannelMessages

Végpont: GET /v1.0/teams/{team-id}/channels/{channel-id}/messages

Az opcionális $top és $expand (például válaszok) rendelkező csatornák üzeneteit sorolja fel. A lapozást a @odata.nextLink kezeli. 403-at ad vissza olvasási engedély nélkül, vagy érvénytelen lekérdezési beállítások esetén a 400-at.

Kötelező paraméterek: team-id, channel-id

Választható paraméterek: $top, $expand

mcp_graph_teams_listChannels

Végpont: GET /v1.0/teams/{team-id}/allChannels

Az opcionális $select vagy $filter rendelkező csapatok csatornáinak listája. Privát és megosztott csatornákat csak akkor ad vissza, ha a hívó tag. 403-zal meghiúsul, ha a hívó nem rendelkezik olvasási jogosultsággal, vagy 400-zal érvénytelen OData-lekérdezés esetén.

Kötelező paraméterek: csapatazonosító

Választható paraméterek: $select, $filter

mcp_graph_teams_listTeams

Végpont: GET /v1.0/users/{user-id}/joinedTeams

Egy adott felhasználó által csatlakozott csapatok felsorolása. Csak a felhasználó tagságát adja vissza, nem az összes bérlői csapatot. A 403 értéket adja vissza, ha a hívó nem tudja lekérdezni a felhasználót, vagy a 404-et, ha az azonosító érvénytelen.

Kötelező paraméterek: felhasználó-azonosító

mcp_graph_teams_postChannelMessage

Végpont: POST /v1.0/teams/{team-id}/channels/{channel-id}/messages

Egyszerű szöveges üzenetet jelenít meg egy csatornán. Csapatazonosítót, csatornaazonosítót és body.content-t igényel. A 403-at adja vissza ChannelMessage.Send nélkül, ha a csatorna nem található, a 404-et, ha a tartalom hiányzik.

Kötelező paraméterek: csapatazonosító, csatorna-azonosító, törzs

mcp_graph_teams_replyToChannelMessage (csatornára válaszoló üzenet)

Végpont: POST /v1.0/teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies

Válaszok egy üzenetre a body.content nevű csatornán. Csak egyszerű szöveg támogatott. 404-et ad vissza, ha a szülőüzenet nem található, 403 jogosultság nélkül, érvénytelen tartalom esetén pedig 400-at.

Kötelező paraméterek: team-id, channel-id, message-id, body

mcp_graph_teams_updateChannel

Végpont: PATCH /teams/{team-id}/channels/{channel-id}

Új kijelzőnévvel vagy új leírással frissíti a csatornát. A korlátozások olyan speciális csatornákra vonatkozhatnak, mint az Általános. 403-at ad vissza jogosultságok nélkül, 409-et duplikált neveken, vagy 400-at érvénytelen bemenet esetén.

Kötelező paraméterek: team-id, channel-id

Választható paraméterek: displayName, leírás

mcp_graph_teams_updateChannelMember

Végpont: PATCH /teams/{team-id}/channels/{channel-id}/members/{membership-id}

A szerepkörök módosításával frissíti egy tag szerepkörét egy privát vagy megosztott csatornán. A standard csatornák öröklik a szerepköröket a csapattól, és általában elutasítják a frissítéseket. 400-at ad vissza, ha normál csatornákon próbálják meg, 403-at, ha engedély nélküli, vagy 404-et, ha a tag nem található.

Kötelező paraméterek: team-id, channel-id, membership-id, szerepek

Támogatott műveletek

1. Csevegés kezelése (létrehozás, olvasás, frissítés, törlés)
2. Üzenetműveletek (küldés, lekérés, szerkesztés, törlés)
3. Csatornakezelés (létrehozás, konfigurálás, lista)
4. Tagkezelés (hozzáadás, frissítés, lista)
5. Csapatműveletek (lekérdezés, listázás)

Legfontosabb funkciók

1. Teljes CRUD-műveletek csevegésekhez és csatornákhoz
2. Privát, megosztott és standard csatornák támogatása
3. Üzenetszálak és válaszok
4. Tagi szerepkörök kezelése
5. OData-lekérdezések támogatása szűréshez és lapozáshoz