Dokumentacja serwera MCP usługi Microsoft Teams

Omówienie

Narzędzia do czatów

mcp_graph_chat_addChatMember

Punkt końcowy: POST /v1.0/chats/{chat-id}/członkowie

Dodaje członka do czatu przy użyciu user@odata.bindról , @odata.typei opcjonalnych (członek, właściciel). Zwraca wartość 409, jeśli element członkowski jest już obecny, 400 dla nieprawidłowych odwołań użytkownika lub 403, jeśli zasady ograniczają dodawanie.

Wymagane parametry: chat-id, @odata.type, user@odata.bindroles

mcp_graph_chat_createChat

Punkt końcowy: POST /v1.0/chats

Tworzy nowy czat usługi Teams z funkcją chatType (oneOnOne wymaga dokładnie dwóch uczestników, grupa wymaga więcej niż dwóch) i członków. Zwraca wartość 400, jeśli wartość oneOnOne ma nieprawidłową liczbę członków, 409, jeśli ci sami uczestnicy mają już czat lub 403, jeśli obiekt wywołujący nie ma praw.

Wymagane parametry: chatType, członkowie

mcp_graph_chat_deleteChat

Punkt końcowy: DELETE /v1.0/chats/{chat-id}

Program usuwa czat. Zwraca wartość 403, jeśli brakuje uprawnień, 404, jeśli zostało już usunięte, i podlega zasadom przechowywania dzierżawy.

Wymagane parametry: chat-id

mcp_graph_chat_deleteChatMessage

Punkt końcowy: POST /v1.0/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/softDelete

Program usuwa wiadomość czatu. Zwraca wartość 403 bez elementu Chat.ReadWrite, 404 dla nieprawidłowych identyfikatorów i nadal może zachować komunikat pod kątem zgodności.

Wymagane parametry: user-id, chat-id, chatMessage-id

mcp_graph_chat_getChat

Punkt końcowy: GET /v1.0/chats/{chat-id}

Pobiera czat według identyfikatora, zwracając metadane, takie jak typ i temat. Zwraca wartość 404, jeśli czat nie istnieje lub nie jest widoczny, lub 403, jeśli uprawnienia zostaną odrzucone.

Wymagane parametry: chat-id

mcp_graph_chat_getChatMessage

Punkt końcowy: GET /v1.0/chats/{chat-id}/messages/{message-id}

Pobiera wiadomość czatu według identyfikatora. Zwraca wartość 404, jeśli komunikat nie istnieje lub jest ukryty lub 403 bez odpowiednich praw.

Wymagane parametry: chat-id, message-id

mcp_graph_chat_listChatMembers

Punkt końcowy: GET /v1.0/chats/{chat-id}/członkowie

Wyświetla listę uczestników czatu. Zwraca role (członek/właściciel/gość). Zwraca wartość 403 bez uprawnień do odczytu lub 404, jeśli czat nie zostanie znaleziony.

Wymagane parametry: chat-id

mcp_graph_chat_listChatMessages

Punkt końcowy: GET /v1.0/chats/{chat-id}/messages

Wyświetla listę wiadomości na czacie z opcjonalnymi $top, $filter i $orderby. Zwraca stronicowane wyniki; zgodność może ukrywać zawartość. Błędy obejmują 400 dla nieprawidłowych zapytań i 429 w przypadku ograniczania przepustowości.

Wymagane parametry: chat-id

Parametry opcjonalne: $top, $filter, $orderby

mcp_graph_chat_listChats

Punkt końcowy: GET /v1.0/chats

Wyświetla listę rozmówców z opcjonalnymi $top, $filter, $expand i $orderby. Zwraca tylko widoczne czaty; ukryte lub systemowe czaty mogą być wykluczone. Zwraca wartość 400 dla nieprawidłowych wyrażeń sortowania.

Parametry opcjonalne: $top, $orderby, $expand, $filter

mcp_graph_chat_postMessage

Punkt końcowy: POST /v1.0/chats/{chat-id}/messages

Publikuje nową wiadomość w postaci zwykłego tekstu w czacie. Wymaga identyfikatora czatu i niepustego treści.content; obsługiwany jest tylko tekst. Może zwrócić 429 dla ograniczania przepustowości, 403, jeśli brakuje uprawnień lub 404, jeśli czat jest nieprawidłowy. Nie idempotentny — unikaj ponawiania prób ślepych.

Wymagane parametry: chat-id, treść

mcp_graph_chat_updateChat

Punkt końcowy: PATCH /v1.0/chats/{chat-id}

Aktualizuje właściwości czatu, takie jak temat tylko dla czatów grupowych. Kończy się niepowodzeniem z błędem 400, jeśli jest używany na jednym czacie, 403 bez praw lub 404, jeśli czat nie zostanie znaleziony.

Wymagane parametry: chat-id, temat

mcp_graph_chat_updateChatMessage

Punkt końcowy: PATCH /v1.0/chats/{chat-id}/messages/{message-id}

Aktualizuje wiadomość czatu z nową zawartością w postaci zwykłego tekstu. Edytowanie może być zablokowane dla niektórych komunikatów dotyczących systemu lub zgodności. Zwraca wartość 403 lub 400, jeśli edytowanie jest niedozwolone lub 409 w przypadku konfliktów.

Wymagane parametry: chat-id, message-id

Narzędzia kanału i zespołu

mcp_graph_teams_addChannelMember

Punkt końcowy: POST /v1.0/teams/{team-id}/channels/{channel-id}/members

Dodaje członka do prywatnego lub udostępnionego kanału z rolami user@odata.bind, @odata.typei opcjonalnymi (właściciel lub pusty). Niepowodzenie w kanałach standardowych, zwraca wartość 409, jeśli element członkowski jest już obecny i 403, jeśli brakuje uprawnień.

Wymagane parametry: team-id, channel-id, displayName, roles, user@odata.bind, @odata.type

mcp_graph_teams_createChannel

Punkt końcowy: POST /v1.0/teams/{team-id}/kanały

Tworzy kanał w zespole z parametrem displayName, opcjonalnym opisem, elementem membershipType (standardowym, prywatnym, udostępnionym) i opcjonalnymi członkami. Kanały prywatne lub udostępnione wymagają jawnych członków; duplikaty lub nieprawidłowe członkostwo powodują 400 lub 409.

Wymagane parametry: team-id, displayName

Parametry opcjonalne: description, membershipType, members

mcp_graph_teams_createPrivateChannel

Punkt końcowy: POST /v1.0/teams/{team-id}/kanały

Tworzy kanał prywatny z elementem membershipType: private. Wymaga członków podczas tworzenia, w tym co najmniej jednego właściciela. Zwraca wartość 400, jeśli brakuje elementów członkowskich, 409 dla zduplikowanych nazw lub 403 bez uprawnień.

Wymagane parametry: team-id, displayName, members

mcp_graph_teams_getChannel

Punkt końcowy: GET /v1.0/teams/{team-id}/channels/{channel-id}

Pobiera kanał z opcjonalnymi $select i $filter. Zwraca wartość 404, jeśli nie znaleziono kanału lub obiekt wywołujący nie ma dostępu, 403, jeśli uprawnienia są niewystarczające lub 400 dla nieobsługiwanych filtrów.

Wymagane parametry: identyfikator zespołu, identyfikator kanału

Parametry opcjonalne: $select, $filter

mcp_graph_teams_getTeam

Punkt końcowy: GET /v1.0/teams/{team-id}

Pobiera właściwości zespołu z opcjonalnymi $select i $expand. Zwraca wartość 403 lub 404, jeśli zespół jest niedostępny.

Wymagane parametry: identyfikator zespołu

Parametry opcjonalne: $select, $expand

mcp_graph_teams_listChannelMembers

Punkt końcowy: GET /v1.0/teams/{team-id}/channels/{channel-id}/członkowie

Wyświetla listę wszystkich członków określonego kanału usługi Microsoft Teams, zwracając metadane dotyczące każdego członka, takie jak tożsamość, role i stan członkostwa. Przydatne do przeprowadzania inspekcji udziału kanału, weryfikowania członkostwa przed aktualizacjami ról lub zapewniania zgodności.

Wymagane parametry: identyfikator zespołu, identyfikator kanału

Parametry opcjonalne: $top, $expand

mcp_graph_teams_listChannelMessages

Punkt końcowy: GET /v1.0/teams/{team-id}/channels/{channel-id}/messages

Wyświetla listę komunikatów w kanale z opcjonalnymi $top i $expand (na przykład odpowiedziami). Stronicowanie jest obsługiwane za pośrednictwem .@odata.nextLink Zwraca wartość 403 bez uprawnień do odczytu lub 400 dla nieprawidłowych opcji zapytania.

Wymagane parametry: identyfikator zespołu, identyfikator kanału

Parametry opcjonalne: $top, $expand

mcp_graph_teams_listChannels

Punkt końcowy: GET /v1.0/teams/{team-id}/allChannels

Wyświetla listę kanałów w zespole z opcjonalnymi $select lub $filter. Zwraca kanały prywatne i udostępnione tylko wtedy, gdy obiekt wywołujący jest członkiem. Kończy się niepowodzeniem z błędem 403, jeśli obiekt wywołujący nie ma praw do odczytu lub 400 w przypadku nieprawidłowych zapytań OData.

Wymagane parametry: identyfikator zespołu

Parametry opcjonalne: $select, $filter

mcp_graph_teams_listTeams

Punkt końcowy: GET /v1.0/users/{user-id}/joinedTeams

Wyświetla listę dołączonych zespołów określonego użytkownika. Zwraca tylko członkostwo tego użytkownika, a nie wszystkich zespołów dzierżaw. Zwraca wartość 403, jeśli obiekt wywołujący nie może wysłać zapytania do użytkownika lub 404, jeśli identyfikator jest nieprawidłowy.

Wymagane parametry: user-id

mcp_graph_teams_postChannelMessage

Punkt końcowy: POST /v1.0/teams/{team-id}/channels/{channel-id}/messages

Publikuje wiadomość w postaci zwykłego tekstu w kanale. Wymaga identyfikatora zespołu, identyfikatora kanału i treści.content. Zwraca wartość 403 bez komunikatu ChannelMessage.Send, 404, jeśli nie znaleziono kanału lub 400, jeśli brakuje zawartości.

Wymagane parametry: identyfikator zespołu, identyfikator kanału, treść

mcp_graph_teams_replyToChannelMessage

Punkt końcowy: POST /v1.0/teams/{team-id}/channels/{channel-id}/messages/{message-id}/odpowiedzi

Odpowiada na wiadomość w kanale z treścią body.content. Obsługiwany jest tylko zwykły tekst. Zwraca wartość 404, jeśli nie znaleziono komunikatu nadrzędnego, 403 bez praw lub 400 dla nieprawidłowej zawartości.

Wymagane parametry: team-id, channel-id, message-id, body

mcp_graph_teams_updateChannel

Punkt końcowy: PATCH /teams/{team-id}/channels/{channel-id}

Aktualizuje kanał za pomocą nowej nazwy displayName lub opisu. Ograniczenia mogą dotyczyć specjalnych kanałów, takich jak Ogólne. Zwraca wartość 403 bez praw, 409 w przypadku zduplikowanych nazw lub 400 dla nieprawidłowych danych wejściowych.

Wymagane parametry: identyfikator zespołu, identyfikator kanału

Parametry opcjonalne: displayName, description

mcp_graph_teams_updateChannelMember

Punkt końcowy: PATCH /teams/{team-id}/channels/{channel-id}/members/{membership-id}

Aktualizuje rolę członka w kanale prywatnym lub udostępnionym, zmieniając role. Kanały standardowe dziedziczą role od zespołu i zwykle odrzucają aktualizacje. Zwraca wartość 400, jeśli podjęto próbę w kanałach standardowych, 403, jeśli nieautoryzowano lub 404, jeśli nie znaleziono elementu członkowskiego.

Wymagane parametry: team-id, channel-id, membership-id, roles

Obsługiwane operacje

1. Zarządzanie czatami (tworzenie, odczytywanie, aktualizowanie, usuwanie)
2. Operacje komunikatów (wysyłanie, pobieranie, edytowanie, usuwanie)
3. Zarządzanie kanałami (tworzenie, konfigurowanie, wyświetlanie listy)
4. Zarządzanie członkami (dodawanie, aktualizowanie, lista)
5. Operacje zespołowe (pobieranie, lista)

Kluczowe cechy i funkcje

1. Pełne operacje CRUD dla czatów i kanałów
2. Obsługa kanałów prywatnych, udostępnionych i standardowych
3. Wątkowe i odpowiedzi wiadomości
4. Zarządzanie rolami użytkownika
5. Obsługa zapytań OData na potrzeby filtrowania i stronicowania