Riferimento al server MCP di Microsoft Teams

Importante

Devi far parte del programma di anteprima Frontier per ottenere l'accesso in anteprima a Microsoft Agent 365. Frontier ti mette in contatto diretto con le ultime innovazioni di Microsoft nell'IA. Le anteprime Frontier sono soggette alle condizioni di anteprima esistenti dei tuoi contratti del cliente. Poiché queste funzionalità sono ancora in fase di sviluppo, la disponibilità e le funzionalità possono cambiare nel tempo.

Panoramica

ID del server	Nome visualizzato	Ambito	Descrizione
mcp_TeamsServer	Server MCP di Microsoft Teams	McpServers.Teams.All	Server MCP di Microsoft Teams Graph per gestire chat, canali e utenti o messaggi all'interno di essi. Utilizza questo server MCP per le operazioni di Teams come la creazione, l'aggiornamento e il recupero di chat e messaggi di chat, la gestione di team e canali e l'esecuzione di attività amministrative correlate a queste attività.

Strumenti di chat

mcp_graph_chat_addChatMember

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

Aggiunge un membro a una chat usando user@odata.bind, @odata.type e ruoli facoltativi (membro, proprietario). Restituisce 409 se il membro è già presente, 400 per riferimenti utente non validi o 403 se i criteri limitano l'aggiunta.

Parametri obbligatori: chat-id, @odata.type, user@odata.bind, ruoli

mcp_graph_chat_createChat

Endpoint: POST /v1.0/chats

Crea una nuova chat di Teams con chatType (oneOnOne richiede esattamente due partecipanti, il gruppo ne richiede più di due) e i membri. Restituisce 400 se oneOnOne ha il numero di membri errato, 409 se gli stessi partecipanti hanno già una chat o 403 se il chiamante non dispone dei diritti.

Parametri obbligatori: chatType, membri

mcp_graph_chat_deleteChat

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

Elimina temporaneamente una chat. Restituisce 403 se l'autorizzazione è mancante, 404 se è già stata eliminata ed è soggetta ai criteri di conservazione dei tenant.

Parametri obbligatori: chat-id

mcp_graph_chat_deleteChatMessage

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

Elimina temporaneamente un messaggio di chat. Restituisce 403 senza Chat.ReadWrite, 404 per ID non validi e può comunque mantenere il messaggio per la conformità.

Parametri obbligatori: user-id, chat-id, chatMessage-id

mcp_graph_chat_getChat

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

Recupera una chat in base all'ID, restituendo metadati come tipo e argomento. Restituisce 404 se la chat non esiste o non è visibile oppure 403 se le autorizzazioni vengono negate.

Parametri obbligatori: chat-id

mcp_graph_chat_getChatMessage

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

Recupera un messaggio di chat in base all'ID. Restituisce 404 se il messaggio non esiste o è nascosto oppure 403 senza diritti appropriati.

Parametri obbligatori: chat-id, message-id

mcp_graph_chat_listChatMembers

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

Elenca i partecipanti alla chat. Restituisce ruoli (membro/proprietario/guest) Restituisce 403 senza autorizzazioni di lettura o 404 se la chat non viene trovata.

Parametri obbligatori: chat-id

mcp_graph_chat_listChatMessages

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

Elenca i messaggi in una chat con $top, $filter e $orderby facoltativi. Restituisce i risultati impaginati; la conformità può nascondere il contenuto. Gli errori includono 400 per le query non valida e 429 per la limitazione delle richieste.

Parametri obbligatori: chat-id

Parametri facoltativi: $top, $filter, $orderby

mcp_graph_chat_listChats

Endpoint: GET /v1.0/chats

Elenca le chat per il chiamante con $top, $filter, $expand e $orderby facoltativi. Restituisce solo chat visibili; le chat nascoste o di sistema potrebbero essere escluse. Restituisce 400 per espressioni di ordinamento non valide.

Parametri facoltativi: $top, $orderby, $expand, $filter

mcp_graph_chat_postMessage

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

Invia un nuovo messaggio di testo normale in una chat. Ha bisogno di chat-id e non-empty body.content; solo testo supportato. Può restituire 429 per la limitazione delle richieste, 403 se mancano le autorizzazioni o 404 se la chat non è valida. Non idempotente: evita tentativi ripetuti alla cieca.

Parametri obbligatori: chat-id, body

mcp_graph_chat_updateChat

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

Aggiorna le proprietà della chat, ad esempio l'argomento solo per le chat di gruppo. Ha esito negativo con 400 se usato in una chat uno a uno, 403 senza diritti o 404 se la chat non è stata trovata.

Parametri obbligatori: chat-id, topic

mcp_graph_chat_updateChatMessage

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

Aggiorna un messaggio di chat con nuovo contenuto di testo normale. La modifica potrebbe essere bloccata per alcuni messaggi di sistema o conformità. Restituisce 403 o 400 se la modifica non è consentita o 409 in caso di conflitti.

Parametri obbligatori: chat-id, message-id

Strumenti per team e canali

mcp_graph_teams_addChannelMember

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

Aggiunge un membro a un canale privato o condiviso con user@odata.bind, @odata.type e ruoli facoltativi (proprietario o vuoto). Errore nei canali standard, restituisce 409 se il membro è già presente e 403 in caso di mancanza di autorizzazioni.

Parametri obbligatori: team-id, channel-id, displayName, roles, user@odata.bind, @odata.type

mcp_graph_teams_createChannel

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

Crea un canale in un team con displayName, descrizione facoltativa, membershipType (standard, privato, condiviso) e membri facoltativi. I canali privati o condivisi richiedono membri espliciti; duplicati o appartenenza non valida causa 400 o 409.

Parametri obbligatori: team-id, displayName

Parametri facoltativi: description, membershipType, members

mcp_graph_teams_createPrivateChannel

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

Crea un canale privato con membershipType: privato. Richiede membri alla creazione, incluso almeno un proprietario. Restituisce 400 se mancano membri, 409 per i nomi duplicati o 403 senza autorizzazioni.

Parametri obbligatori: team-id, displayName, members

mcp_graph_teams_getChannel

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

Recupera un canale con $select e $filter facoltativi. Restituisce 404 se il canale non è stato trovato o il chiamante non ha accesso, 403 se le autorizzazioni non sono sufficienti o 400 per i filtri non supportati.

Parametri obbligatori: team-id, channel-id

Parametri facoltativi: $select, $filter

mcp_graph_teams_getTeam

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

Recupera le proprietà del team con $select e $expand facoltativi. Restituisce 403 o 404 se il team non è accessibile.

Parametri obbligatori: team-id

Parametri facoltativi: $select, $expand

mcp_graph_teams_listChannelMembers

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

Elenca tutti i membri di un canale specifico di Microsoft Teams, restituendo metadati su ogni membro, ad esempio identità, ruoli e stato di appartenenza. Utile per controllare la partecipazione al canale, verificare l'appartenenza prima degli aggiornamenti dei ruoli o garantire la conformità.

Parametri obbligatori: team-id, channel-id

Parametri facoltativi: $top, $expand

mcp_graph_teams_listChannelMessages

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

Elenca i messaggi in un canale con $top e $expand facoltativi (ad esempio, risposte). L'impaginazione viene gestita tramite @odata.nextLink. Restituisce 403 senza autorizzazione di lettura o 400 per le opzioni di query non valide.

Parametri obbligatori: team-id, channel-id

Parametri facoltativi: $top, $expand

mcp_graph_teams_listChannels

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

Elenca i canali in un team con $select o $filter facoltativi. Restituisce canali privati e condivisi solo se il chiamante è un membro. Ha esito negativo con 403 se il chiamante non dispone di diritti di lettura o 400 su query OData non valide.

Parametri obbligatori: team-id

Parametri facoltativi: $select, $filter

mcp_graph_teams_listTeams

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

Elenca i team aggiunti a un utente specifico. Restituisce solo le appartenenze dell'utente, non tutti i team tenant. Restituisce 403 se il chiamante non può eseguire query sull'utente o 404 se l'ID non è valido.

Parametri obbligatori: user-id

mcp_graph_teams_postChannelMessage

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

Invia un messaggio di testo normale a un canale. Richiede team-id, channel-id e body.content. Restituisce 403 senza ChannelMessage.Send, 404 se il canale non è stato trovato o 400 se manca il contenuto.

Parametri obbligatori: team-id, channel-id, body

mcp_graph_teams_replyToChannelMessage

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

Risponde a un messaggio in un canale con body.content. È supportato solo il testo normale. Restituisce 404 se il messaggio padre non viene trovato, 403 senza diritti o 400 per contenuto non valido.

Parametri obbligatori: team-id, channel-id, message-id, body

mcp_graph_teams_updateChannel

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

Aggiorna un canale con un nuovo displayName o una nuova descrizione. Le restrizioni possono essere applicate a canali speciali come Generale. Restituisce 403 senza diritti, 409 per i nomi duplicati o 400 per l'input non valido.

Parametri obbligatori: team-id, channel-id

Parametri facoltativi: displayName, description

mcp_graph_teams_updateChannelMember

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

Aggiorna il ruolo di un membro in un canale privato o condiviso modificando i ruoli. I canali standard ereditano i ruoli dal team e in genere rifiutano gli aggiornamenti. Restituisce 400 se si tenta di eseguire un tentativo su canali standard, 403 se non è stato autorizzato o 404 se il membro non è stato trovato.

Parametri obbligatori: team-id, channel-id, membership-id, roles

Operazioni supportate

1. Gestione delle chat (creazione, lettura, aggiornamento, eliminazione)
2. Operazioni di messaggio (invio, recupero, modifica, eliminazione)
3. Gestione dei canali (creazione, configurazione, elenco)
4. Gestione dei membri (aggiunta, aggiornamento, elenco)
5. Operazioni del team (recupero, elenco)

Funzionalità chiave

1. Operazioni CRUD complete per chat e canali
2. Supporto per canali privati, condivisi e standard
3. Threading e risposte dei messaggi
4. Gestione ruoli dei membri
5. Supporto delle query OData per il filtro e l'impaginazione