Referencja do Teams (podgląd)

Note

Funkcje opisane w tym artykule są zasilane standardową wiązką, która wykorzystuje opcje rozliczeniowe opisane w sekcji Licencjonowanie dla agentów zasilanych standardową wiązką. Dowiedz się, jak korzystać ze standardowych funkcji w Access, agentów standardowych i przepływach agentów.

Ważna

Jest to funkcja w wersji zapoznawczej.

• Microsoft udostępnia funkcje w wersji zapoznawczej przed ich oficjalnym wydaniem, aby klienci mogli uzyskać wcześniejszy dostęp i przekazać opinie.
• Funkcje w wersji zapoznawczej mają ograniczone funkcje i nie są przeznaczone do użytku produkcyjnego.
• Microsoft może zmienić nazwy i parametry narzędzia MCP w wersji zapoznawczej. Unikaj zakodowanych na sztywno zależności. Microsoft obsługuje scenariusze.
• Funkcje w wersji zapoznawczej podlegają dodatkowym warunkom użytkowania firmy Microsoft.

Overview

Identyfikator serwera	Adres URL na poziomie dzierżawcy	Wyświetlana nazwa	Scope	Opis
mcp_TeamsServer	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_TeamsServer	Zespoły	McpServers.Teams.All	Microsoft Teams służy do zarządzania czatami, kanałami oraz użytkownikami lub wiadomościami w ich obrębie. Użyj tego serwera MCP dla operacji usługi Teams, takich jak tworzenie, aktualizowanie i pobieranie czatów i wiadomości czatów, zarządzanie zespołami i kanałami oraz wykonywanie zadań administracyjnych związanych z tymi zadaniami.

Narzędzia do czatów

mcp_graph_chat_addChatMember

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

Dodaje członka do czatu przy użyciu user@odata.bind, @odata.type oraz opcjonalnych ról (członek, właściciel). Zwraca kod błędu 409, jeśli członek już istnieje, kod błędu 400 w przypadku nieprawidłowych odwołań do użytkownika lub kod błędu 403, jeśli zasady uniemożliwiają dodawanie.

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

mcp_graph_chat_utwórzCzat

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

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

Wymagane parametry:chatType, składowe

mcp_graph_chat_usuńCzat

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

Program usuwa czat. Zwraca błąd 403, jeśli brakuje uprawnienia lub wartość 404, jeśli została już usunięta. Ta operacja 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 403 bez Chat.ReadWrite, 404 dla nieprawidłowych identyfikatorów i może nadal zachować komunikat ze względów 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. Zwraca 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_listaCzłonkówCzatu

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

Wyświetla listę uczestników czatu. Zwraca role (członek, właściciel lub 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 w czacie z opcjonalnymi elementami $top, $filter i $orderby. Zwraca stronicowane wyniki. Zgodność może ukrywać zawartość. Błędy obejmują m.in. kod 400 dla błędnych zapytań i kod 429 dla ograniczania szybkości.

Wymagane parametry: chat-id

Parametry opcjonalne:$top, $filter, $orderby

mcp_graph_czat_listaCzatów

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

Wyświetla listę czatów wywołującego 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 pola body.content; obsługiwany jest wyłącznie tekst. Może zwrócić wartość 429 dla ograniczania przepustowości, wartość 403, jeśli brakuje uprawnień lub wartość 404, jeśli czat jest nieprawidłowy. Nie idempotent—avoid ślepe ponawia próby.

Wymagane parametry: chat-id, treść

mcp_graph_czat_aktualizujCzat

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 w rozmowie prywatnej, 403 bez praw dostępu lub 404, jeśli czatu nie można znaleźć.

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. Niektóre komunikaty dotyczące systemu lub zgodności blokują edytowanie. Operacja 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 kanału prywatnego lub udostępnionego przy użyciu user@odata.bind, @odata.type oraz opcjonalnych ról (właściciel lub puste). Niepowodzenie w kanałach standardowych. Zwraca kod 409, jeśli członek jest już obecny, oraz kod 403, jeśli brak odpowiednich 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}/channels

Tworzy kanał w zespole z parametrami displayName, opcjonalnym opisem, membershipType (standardowy, prywatny, współdzielony) oraz opcjonalnymi członkami. Kanały prywatne lub współdzielone wymagają jawnie określonych członków. Duplikaty lub nieprawidłowe członkostwo powodują błąd 400 lub 409.

Wymagane parametry: team-id, displayName

Parametry opcjonalne: description, membershipType, members

Funkcja: mcp_graph_teams_createPrivateChannel - tworzenie prywatnego kanału w Teams

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

Tworzy kanał prywatny, ustawiając membershipType na private. Należy dołączyć członków podczas tworzenia kanału, a lista członków musi mieć co najmniej jednego właściciela. Zwraca kod 400, jeśli brakuje składników, kod 409 w przypadku zduplikowanych nazw albo kod 403, jeśli wywołujący nie ma 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 błąd 404, jeśli kanał nie zostanie znaleziony 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_zespoły_pobierzZespół

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}/members

Wyświetla listę wszystkich członków określonego kanału Microsoft Teams. Zwraca metadane dotyczące każdego członka, takie jak tożsamość, role i status członkostwa. Te informacje są przydatne w przypadku inspekcji udziału kanału, weryfikowania członkostwa przed aktualizacjami ról lub zapewnienia 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. Użyj opcjonalnych $top parametrów i $expand , aby dostosować wyniki. Na przykład użyj polecenia $expand , aby uwzględnić odpowiedzi. 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_listaKanałów

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

Wyświetla listę kanałów w zespole. Użyj opcjonalnych $select parametrów lub $filter , aby dostosować wyniki. Zwraca kanały prywatne i udostępnione tylko wtedy, gdy użytkownik wywołujący jest członkiem. Zwraca błąd 403, jeśli wywołujący nie ma uprawnień do odczytu, lub błąd 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łonkostwa tego użytkownika, a nie członkostwa we wszystkich zespołach dzierżawcy. 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. Zwraca wartość 403 bez komunikatu ChannelMessage.Send, wartość 404, jeśli nie znaleziono kanału lub wartość 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}/replies

Odpowiada na wiadomość w kanale przy użyciu body.content. Obsługiwany jest tylko zwykły tekst. Zwraca kod 404, jeśli nie znaleziono wiadomości nadrzędnej, 403 w przypadku braku uprawnień lub 400 w przypadku 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ł, dodając nowy displayName lub nowy opis. 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 (nazwa wyświetlana), description (opis)

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 blokują aktualizacje. Zwraca kod 400 w przypadku próby wykonania tej operacji na kanałach standardowych, 403 w przypadku braku autoryzacji lub 404, jeśli nie znaleziono członka.

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

Obsługiwane operacje

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

Kluczowe funkcje

• Pełne operacje tworzenia, odczytu, aktualizacji i usuwania (CRUD) czatów i kanałów.
• Obsługa kanałów prywatnych, udostępnionych i standardowych.
• Wątkowanie wiadomości i odpowiedzi.
• Zarządzanie rolami członków.
• Obsługa zapytań OData na potrzeby filtrowania i stronicowania.