Microsoft Teams-MCP-Server-Referenz

Wichtig

Sie müssen Teil des Frontier-Vorschauversionsprogramms sein, um Vorabzugriff auf Microsoft Agent 365 zu erhalten. Frontier verbindet Sie direkt mit den neuesten KI-Innovationen von Microsoft. Frontier-Vorschauversionen unterliegen den bestehenden Vorschauversionsbedingungen Ihrer Kundenvereinbarungen. Da sich diese Funktionen noch in der Entwicklung befinden, können sich ihre Verfügbarkeit und Merkmale im Laufe der Zeit ändern.

Übersicht

Server-ID	Anzeigename	Geltungsbereich	Beschreibung des Dataflows
mcp_TeamsServer	Microsoft Teams-MCP-Server	McpServers.Teams.All	Microsoft Teams Graph-MCP-Server zum Verwalten von Chats, Kanälen und Benutzern oder Nachrichten darin. Verwenden Sie diesen MCP-Server für Teams-Vorgänge wie das Erstellen, Aktualisieren und Abrufen von Chats und Chatnachrichten, das Verwalten von Teams und Kanälen sowie das Ausführen von Verwaltungsaufgaben im Zusammenhang mit diesen Elementen.

Chat-Tools

mcp_graph_chat_addChatMember

Endpunkt: POST /v1.0/chats/{chat-id}/members

Fügt einem Chat ein Mitglied unter Verwendung von user@odata.bind, @odata.type und optionalen Rollen (Mitglied, Besitzer) hinzu. Gibt 409 zurück, wenn das Element bereits vorhanden ist, 400 bei ungültigen Benutzerverweisen oder 403, wenn Richtlinien das Hinzufügen einschränken.

Erforderliche Parameter: chat-id, @odata.type, user@odata.bind, roles

mcp_graph_chat_createChat

Endpunkt: POST /v1.0/chats

Erstellt einen neuen Teams-Chat mit chatType (oneOnOne erfordert genau zwei Teilnehmende, Gruppe erfordert mehr als zwei) und Mitglieder. Gibt 400 zurück, wenn oneOnOne die falsche Mitgliederanzahl hat, 409, wenn die gleichen Teilnehmenden bereits über einen Chat verfügen, oder 403, wenn der Aufrufende keine Rechte hat.

Erforderliche Parameter: chatType, members

mcp_graph_chat_deleteChat

Endpunkt: DELETE /v1.0/chats/{chat-id}

Löscht einen Chat vorläufig. Gibt 403 zurück, wenn die Berechtigung fehlt, 404, wenn sie bereits gelöscht wurde und den Aufbewahrungsrichtlinien des Mandanten unterliegt.

Erforderliche Parameter: chat-id

mcp_graph_chat_deleteChatMessage

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

Löscht eine Chatnachricht vorläufig. Gibt 403 ohne Chat.ReadWrite, 404 bei ungültigen IDs zurück und behält die Nachricht ggf. weiterhin für Compliance bei.

Erforderliche Parameter: user-id, chat-id, chatMessage-id

mcp_graph_chat_getChat

Endpunkt: GET /v1.0/chats/{chat-id}

Ruft einen Chat nach ID ab und gibt Metadaten wie Typ und Thema zurück. Gibt 404 zurück, wenn der Chat nicht vorhanden oder nicht sichtbar ist, oder 403, wenn Berechtigungen verweigert werden.

Erforderliche Parameter: chat-id

mcp_graph_chat_getChatMessage

Endpunkt: GET /v1.0/chats/{chat-id}/messages/{message-id}

Ruft eine Chatnachricht nach ID ab. Gibt 404 zurück, wenn die Nachricht nicht vorhanden ist oder ausgeblendet ist, oder 403 bei nicht ordnungsgemäßen Rechten.

Erforderliche Parameter: chat-id, message-id

mcp_graph_chat_listChatMembers

Endpunkt: GET /v1.0/chats/{chat-id}/members

Listet die Chat-Teilnehmenden auf. Gibt Rollen zurück (Mitglied/Besitzer/Gast). Gibt 403 ohne Leseberechtigungen oder 404 zurück, wenn der Chat nicht gefunden wurde.

Erforderliche Parameter: chat-id

mcp_graph_chat_listChatMessages

Endpunkt: GET /v1.0/chats/{chat-id}/messages

Listet Nachrichten in einem Chat mit optionalem $top, $filter und $orderby auf. Gibt Ergebnisseiten zurück; Compliance kann Inhalte ausblenden. Fehler umfassen 400 bei fehlerhaften Abfragen und 429 bei Drosselung.

Erforderliche Parameter: chat-id

Optionale Parameter: $top, $filter, $orderby

mcp_graph_chat_listChats

Endpunkt: GET /v1.0/chats

Listet Chats für den Aufrufenden mit optionalem $top, $filter, $expand und $orderby auf. Gibt nur sichtbare Chats zurück; ausgeblendete Chats oder Systemchats können ausgeschlossen werden. Gibt 400 bei ungültigen Sortierausdrücken zurück.

Optionale Parameter: $top, $orderby, $expand, $filter

mcp_graph_chat_postMessage

Endpunkt: POST /v1.0/chats/{chat-id}/messages

Veröffentlicht eine neue Nur-Text-Nachricht in einem Chat. Benötigt Chat-ID und nicht leeren body.content; nur Text wird unterstützt. Kann 429 bei Drosselung zurückgeben, 403 bei fehlenden Berechtigungen oder 404, wenn der Chat ungültig ist. Nicht idempotent – vermeiden Sie blinde Wiederholungen.

Erforderliche Parameter: chat-id, body

mcp_graph_chat_updateChat

Endpunkt: PATCH /v1.0/chats/{chat-id}

Aktualisiert Chateigenschaften, z. B. das Thema nur für Gruppenchats. Schlägt mit 400 bei Verwendung in einem 1:1-Chat fehl, 403 ohne Rechte oder 404, wenn Chat nicht gefunden wurde.

Erforderliche Parameter: chat-id, topic

mcp_graph_chat_updateChatMessage

Endpunkt: PATCH /v1.0/chats/{chat-id}/messages/{message-id}

Aktualisiert eine Chatnachricht mit neuen Nur-Text-Inhalten. Die Bearbeitung kann für einige System- oder Compliancemeldungen blockiert werden. Gibt 403 oder 400 zurück, wenn die Bearbeitung nicht zulässig ist, oder 409 bei Konflikten.

Erforderliche Parameter: chat-id, message-id

Kanal- und Teamtools

mcp_graph_teams_addChannelMember

Endpunkt: POST /v1.0/teams/{team-id}/channels/{channel-id}/members

Fügt einem privaten oder freigegebenen Kanal ein Mitglied mit user@odata.bind@odata.type und optionalen Rollen (Besitzer oder leer) hinzu. Schlägt bei Standardkanälen fehl, gibt 409 zurück, wenn das Mitglied bereits vorhanden ist, und 403 bei fehlenden Berechtigungen.

Erforderliche Parameter: team-id, channel-id, displayName, roles, user@odata.bind, @odata.type

mcp_graph_teams_createChannel

Endpunkt: POST /v1.0/teams/{team-id}/channels

Erstellt einen Kanal in einem Team mit displayName, optionaler Beschreibung, MembershipType (Standard, privat, freigegeben) und optionalen Mitgliedern. Private oder freigegebene Kanäle erfordern explizite Mitglieder; Duplikate oder ungültige Mitgliedschaft verursachen 400- oder 409-Fehler.

Erforderliche Parameter: team-id, displayName

Optionale Parameter: description, membershipType, members

mcp_graph_teams_createPrivateChannel

Endpunkt: POST /v1.0/teams/{team-id}/channels

Erstellt einen privaten Kanal mit membershipType: privat. Erfordert Mitglieder bei der Erstellung, einschließlich mindestens eines Besitzers. Gibt 400 bei fehlenden Mitgliedern zurück, 409 bei doppelten Namen oder 403 bei fehlenden Berechtigungen.

Erforderliche Parameter: team-id, displayName, members

mcp_graph_teams_getChannel

Endpunkt: GET /v1.0/teams/{team-id}/channels/{channel-id}

Ruft einen Kanal mit optionalem $select und $filter ab. Gibt 404 zurück, wenn der Kanal nicht gefunden wurde oder der Aufrufende keinen Zugriff hat, 403 bei unzureichenden Berechtigungen oder 400 bei nicht unterstützten Filtern.

Erforderliche Parameter: team-id, channel-id

Optionale Parameter: $select, $filter

mcp_graph_teams_getTeam

Endpunkt: GET /v1.0/teams/{team-id}

Ruft Teameigenschaften mit optionalem $select und $expand ab. Gibt 403 oder 404 zurück, wenn auf das Team nicht zugegriffen werden kann.

Erforderliche Parameter: team-id

Optionale Parameter: $select, $expand

mcp_graph_teams_listChannelMembers

Endpunkt: GET /v1.0/teams/{team-id}/channels/{channel-id}/members

Listet alle Mitglieder eines bestimmten Microsoft Teams-Kanals auf und gibt Metadaten zu jedem Mitglied zurück, z. B. Identität, Rollen und Mitgliedschaftsstatus. Nützlich für die Überwachung der Kanalteilnahme, für die Überprüfung der Mitgliedschaft vor Rollenaktualisierungen oder zum Sicherstellen von Compliance.

Erforderliche Parameter: team-id, channel-id

Optionale Parameter: $top, $expand

mcp_graph_teams_listChannelMessages

Endpunkt: GET /v1.0/teams/{team-id}/channels/{channel-id}/messages

Listet Nachrichten in einem Kanal mit optionalem $top und $expand auf (z. B. Antworten). Die Paginierung erfolgt über @odata.nextLink. Gibt 403 bei fehlender Leseberechtigung oder 400 bei ungültigen Abfrageoptionen zurück.

Erforderliche Parameter: team-id, channel-id

Optionale Parameter: $top, $expand

mcp_graph_teams_listChannels

Endpunkt: GET /v1.0/teams/{team-id}/allChannels

Listet Kanäle in einem Team mit optionalem $select oder $filter auf. Gibt private und freigegebene Kanäle nur zurück, wenn der Aufrufende Mitglied ist. Schlägt mit 403 fehl, wenn der Aufrufende keine Leserechte hat, oder mit 400 bei ungültigen OData-Abfragen.

Erforderliche Parameter: team-id

Optionale Parameter: $select, $filter

mcp_graph_teams_listTeams

Endpunkt: GET /v1.0/users/{user-id}/joinedTeams

Listet die verbundenen Teams eines bestimmten Benutzers auf. Gibt nur Mitgliedschaften dieses Benutzers zurück, nicht alle Mandantenteams. Gibt 403 zurück, wenn der Aufrufende den Benutzer nicht abfragen kann, oder 404, wenn die ID ungültig ist.

Erforderliche Parameter: user-id

mcp_graph_teams_postChannelMessage

Endpunkt: POST /v1.0/teams/{team-id}/channels/{channel-id}/messages

Sendet eine Nur-Text-Nachricht an einen Kanal. Erfordert team-id, channel-id und body.content. Gibt 403 ohne ChannelMessage.Send zurück, 404, wenn der Kanal nicht gefunden wurde, oder 400, wenn Inhalt fehlt.

Erforderliche Parameter: team-id, channel-id, body

mcp_graph_teams_replyToChannelMessage

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

Antwortet auf eine Nachricht in einem Kanal mit body.content. Es wird nur Nur-Text unterstützt. Gibt 404 zurück, wenn die übergeordnete Nachricht nicht gefunden wurde, 403 bei fehlenden Rechten oder 400 bei ungültigem Inhalt.

Erforderliche Parameter: team-id, channel-id, message-id, body

mcp_graph_teams_updateChannel

Endpunkt: PATCH /teams/{team-id}/channels/{channel-id}

Aktualisiert einen Kanal mit neuem displayName oder einer neuen Beschreibung. Möglicherweise gelten Einschränkungen für spezielle Kanäle wie „Allgemein“. Gibt 403 bei fehlenden Rechten, 409 bei doppelten Namen oder 400 bei ungültigen Eingaben zurück.

Erforderliche Parameter: team-id, channel-id

Optionale Parameter: displayName, description

mcp_graph_teams_updateChannelMember

Endpunkt: PATCH /teams/{team-id}/channels/{channel-id}/members/{membership-id}

Aktualisiert die Rolle eines Mitglieds in einem privaten oder freigegebenen Kanal durch Ändern von Rollen. Standardkanäle erben Rollen vom Team und lehnen Aktualisierungen in der Regel ab. Gibt 400 zurück, wenn Versuche auf Standardkanälen erfolgen, 403 bei Nichtautorisierung oder 404, wenn das Mitglied nicht gefunden wurde.

Erforderliche Parameter: team-id, channel-id, membership-id, roles

Unterstützte Vorgänge

1. Chatverwaltung (Erstellen, Lesen, Aktualisieren, Löschen)
2. Nachrichtenvorgänge (Senden, Abrufen, Bearbeiten, Löschen)
3. Kanalverwaltung (Erstellen, Konfigurieren, Auflisten)
4. Mitgliederverwaltung (Hinzufügen, Aktualisieren, Auflisten)
5. Teamvorgänge (Abrufen, Auflisten)

Schlüsselfunktionen

1. Vollständige CRUD-Vorgänge für Chats und Kanäle
2. Unterstützung für private, freigegebene und Standardkanäle
3. Nachrichtenthreading und -antworten
4. Mitgliederrollenverwaltung
5. OData-Abfrageunterstützung für Filterung und Paginierung