Microsoft Teams MCP サーバーリファレンス

重要

Microsoft Agent 365 の早期アクセスを利用するには、フロンティアプレビュープログラムに参加する必要があります。フロンティアは、Microsoft の最新の AI イノベーションと直接接続します。 Frontier のプレビューは、お客様の契約書に記載されている既存のプレビュー利用規約に従います。これらの機能は現在開発中であるため、提供状況や機能は今後変更される可能性があります。

概要

サーバー ID	表示名称	スコープ	プロパティ
mcp_TeamsServer	Microsoft Teams MCP サーバー	McpServers.Teams.All	Microsoft Teams Graph MCP サーバーを使用して、チャット、チャネル、それらのユーザーまたはメッセージを管理します。この MCP サーバーは、チャットやチャットメッセージの作成、更新、取得、チームやチャネルの管理、およびこれらに関連する管理タスクの実行などの Teams の操作に使用します。

チャットツール

mcp_graph_chat_addChatMember

エンドポイント: POST /v1.0/chats/{chat-id}/members

user@odata.bind、@odata.type、省略可能なロール (メンバー、所有者) を使用して、チャットにメンバーを追加します。メンバーが既に存在する場合は 409、無効なユーザー参照の場合は 400、ポリシーで追加が制限されている場合は 403 を返します。

必須のパラメーター: chat-id、@odata.type、user@odata.bind、ロール

mcp_graph_chat_createChat

エンドポイント: POST /v1.0/chats

chatType (oneOnOne は正確に 2 人の参加者が必要、group は 2 人以上が必要) とメンバーで新しい Teams チャットを作成します。 oneOnOne のメンバー数が不正な場合、400 を返します。同じ参加者が既にチャットを持っている場合、409 を返します。呼び出し元に権限がない場合、403 を返します。

必須パラメーター: chatType、メンバー

mcp_graph_chat_deleteChat

エンドポイント: DELETE /v1.0/chats/{chat-id}

チャットを論理的に削除します。権限がない場合は 403 を返し、既に削除されている場合は 404 を返します。テナントの保持ポリシーの対象となります。

必須のパラメーター: chat-id

mcp_graph_chat_deleteChatMessage

エンドポイント: POST /v1.0/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/softDelete

チャットメッセージを論理的に削除します。 Chat.ReadWrite 権限がない場合は 403 を返し、無効な ID の場合は 404 を返します。コンプライアンスのため、メッセージを保持する場合があります。

必須のパラメーター: user-id, chat-id, chatMessage-id

mcp_graph_chat_getChat

エンドポイント: GET /v1.0/chats/{chat-id}

ID でチャットを取得し、型やトピックなどのメタデータを返します。チャットが存在しないか表示されない場合は 404 を返し、アクセス許可が拒否された場合は 403 を返します。

必須のパラメーター: chat-id

mcp_graph_chat_getChatMessage

エンドポイント: GET /v1.0/chats/{chat-id}/messages/{message-id}

ID でチャットメッセージを取得します。メッセージが存在しないか非表示の場合は 404 を返し、適切な権限がない場合は 403 を返します。

必須のパラメーター: chat-id、message-id

mcp_graph_chat_listChatMembers

エンドポイント: GET /v1.0/chats/{chat-id}/members

チャット参加者を一覧表示します。ロールを返します (member/owner/guest)。読み取りのアクセス許可がない場合は 403 を返し、チャットが見つからない場合は 404 を返します。

必須のパラメーター: chat-id

mcp_graph_chat_listChatMessages

エンドポイント: GET /v1.0/chats/{chat-id}/messages

チャット内のメッセージを一覧表示します。オプションで $top、$filter、$orderby を指定できます。ページ分割された結果を返します。コンプライアンスによりコンテンツが非表示になる場合があります。エラーには、不適切なクエリの場合は 400、調整の場合は 429 が含まれます。

必須のパラメーター: chat-id

オプションのパラメーター: $top、$filter、$orderby

mcp_graph_chat_listChats

エンドポイント: GET /v1.0/chats

発信者向けのチャット一覧を表示します。オプションで $top、$filter、$expand、$orderby を指定できます。表示されているチャットのみを返します。非表示またはシステムチャットは除外される場合があります。無効なソート式に対して 400 を返します。

オプションのパラメーター: $top、$filter、$expand、$filter

mcp_graph_chat_postMessage

エンドポイント: POST /v1.0/chats/{chat-id}/messages

チャットに新しいプレーンテキストメッセージを投稿します。チャット ID と空白ではない body.content が必要です。テキストのみがサポートされています。調整の場合 429 を、権限不足の場合 403 を、チャットが無効な場合は 404 が返される場合があります。べき等 (ブラインド再試行) を避けてください。

必須のパラメーター: chat-id、body

mcp_graph_chat_updateChat

エンドポイント: PATCH /v1.0/chats/{chat-id}

グループチャット専用のトピックなど、チャットのプロパティを更新します。 1 対 1 のチャットで使用した場合は 400、権限のない場合は 403、チャットが見つからない場合は 404 で失敗します。

必須のパラメーター: chat-id、topic

mcp_graph_chat_updateChatMessage

エンドポイント: PATCH /v1.0/chats/{chat-id}/messages/{message-id}

新しいプレーンテキストコンテンツでチャットメッセージを更新します。一部のシステムまたはコンプライアンスメッセージでは、編集がブロックされる場合があります。編集が許可されていない場合は 403 または 400 を返し、競合の場合は 409 を返します。

必須のパラメーター: chat-id、message-id

チャンネルとチームのツール

mcp_graph_teams_addChannelMember

エンドポイント: POST /v1.0/teams/{team-id}/channels/{channel-id}/members

user@odata.bind、@odata.type、省略可能なロール (所有者または空) を持つプライベートまたは共有チャネルにメンバーを追加します。標準チャネルで失敗し、メンバーが既に存在する場合は 409 を返し、アクセス許可がない場合は 403 を返します。

必須のパラメーター: team-id、channel-id、displayName、roles、user@odata.bind、@odata.type

mcp_graph_teams_createChannel

エンドポイント: POST /v1.0/teams/{team-id}/channels

チーム内に displayName、オプションの説明、membershipType (標準、プライベート、共有)、およびオプションのメンバーを持つチャネルを作成します。プライベートまたは共有チャンネルには明示的なメンバーが必要です。重複または無効なメンバーシップは 400 または 409 エラーを引き起こします。

必須のパラメーター: team-id、displayName

省略可能なパラメーター: description、membershipType、members

mcp_graph_teams_createPrivateChannel

エンドポイント: POST /v1.0/teams/{team-id}/channels

membershipType: private を使用してプライベートチャネルを作成します。作成時には、少なくとも 1 人の所有者を含む、メンバーが必要です。メンバーが見つからない場合は 400 を、名前が重複している場合は 409、権限がない場合は 403 を返します。

必須のパラメーター: team-id、displayName、members

mcp_graph_teams_getChannel

エンドポイント: GET /v1.0/teams/{team-id}/channels/{channel-id}

オプションの $select と $filter を持つチャネルを取得します。チャンネルが見つからない場合、または呼び出し元にアクセス権限がない場合は 404、権限が不十分な場合は 403、サポートされていないフィルターの場合は400を返します。

必須のパラメーター: team-id、channel-id

省略可能なパラメーター: $select、$filter

mcp_graph_teams_getTeam

エンドポイント: GET /v1.0/teams/{team-id}

オプションの $select と $expand を使用してチームのプロパティを取得します。チームにアクセスできない場合は、403 または 404 を返します。

必須のパラメーター: team-id

省略可能なパラメーター: $select、$expand

mcp_graph_teams_listChannelMembers

エンドポイント: GET /v1.0/teams/{team-id}/channels/{channel-id}/members

特定の Microsoft Teams チャネルのメンバーをすべて一覧表示し、各メンバーの識別情報、ロール、メンバーシップ状態などのメタデータを返します。チャンネル参加状況の監査、ロール更新前のメンバーシップの確認、またはコンプライアンス確保に使用できます。

必須のパラメーター: team-id、channel-id

省略可能なパラメーター: $top、$expand

mcp_graph_teams_listChannelMessages

エンドポイント: GET /v1.0/teams/{team-id}/channels/{channel-id}/messages

チャネル内のメッセージを、省略可能な $topと$expand (返信など) と共に一覧表示します。改ページ位置の変更は、@odata.nextLink によって処理されます。読み取りアクセス許可がない場合は 403 を返し、無効なクエリオプションの場合は 400 を返します。

必須のパラメーター: team-id、channel-id

省略可能なパラメーター: $top、$expand

mcp_graph_teams_listChannels

エンドポイント: GET /v1.0/teams/{team-id}/allChannels

オプションの $select または $filter を指定してチーム内のチャンネルを一覧表示します。呼び出し元がメンバーである場合にのみ、プライベートチャネルと共有チャネルを返します。呼び出し元が読み取り権限を持たない場合、403 エラーが発生します。無効な OData クエリの場合、400 エラーが発生します。

必須のパラメーター: team-id

省略可能なパラメーター: $select、$filter

mcp_graph_teams_listTeams

エンドポイント: GET /v1.0/users/{user-id}/joinedTeams

特定のユーザーの参加済みチームを一覧表示します。すべてのテナントチームではなく、そのユーザーのメンバーシップのみを返します。呼び出し元がユーザーをクエリできない場合は 403 を、ID が無効な場合は 404 を返します。

必須のパラメーター: user-id

mcp_graph_teams_postChannelMessage

エンドポイント: POST /v1.0/teams/{team-id}/channels/{channel-id}/messages

プレーンテキストメッセージをチャネルに投稿します。 team-id、channel-id、body.content が必要です。 ChannelMessage.Send がない場合に 403、チャネルが見つからない場合は 404、コンテンツが欠落している場合は 400 を返します。

必須のパラメーター: team-id、channel-id、body

mcp_graph_teams_replyToChannelMessage

エンドポイント: POST /v1.0/teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies

body.content を使用してチャネル内のメッセージに応答します。プレーンテキストのみをサポートしています。親メッセージが見つからない場合は 404、権限がない場合は 403、無効なコンテンツの場合は 400 を返します。

必須のパラメーター: team-id、channel-id、message-id、body

mcp_graph_teams_updateChannel

エンドポイント: PATCH /teams/{team-id}/channels/{channel-id}

チャネルを新しい displayName または説明で更新します。制限は、General などの特別なチャネルに適用される場合があります。権限のない場合に 403、重複する名前の場合は 409、無効な入力の場合は 400 を返します。

必須のパラメーター: team-id、channel-id

オプションのパラメーター: displayName、description

mcp_graph_teams_updateChannelMember

エンドポイント: PATCH /teams/{team-id}/channels/{channel-id}/members/{membership-id}

ロールを変更して、プライベートチャネルまたは共有チャネルのメンバーのロールを更新します。標準チャネルはチームからロールを継承し、通常は更新プログラムを拒否します。標準チャネルで試行した場合は 400、承認されていない場合は 403、メンバーが見つからない場合は 404 を返します。

必須のパラメーター: team-id、channel-id、membership-id、roles

サポートされている操作

チャット管理 (作成、読み取り、更新、削除)
メッセージ操作 (送信、取得、編集、削除)
チャネル管理 (作成、構成、一覧表示)
メンバーの管理 (追加、更新、一覧表示)
チームの操作 (取得、一覧表示)

主な機能

チャットとチャネルの完全な CRUD 操作
プライベート、共有、標準のチャネルのサポート
メッセージのスレッド処理と応答
メンバーのロール管理
OData クエリによるフィルターと改ページ位置のサポート

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-12-08

次の方法で共有

Microsoft Teams MCP サーバー リファレンス

概要

チャット ツール

mcp_graph_chat_addChatMember

mcp_graph_chat_createChat

mcp_graph_chat_deleteChat

mcp_graph_chat_deleteChatMessage

mcp_graph_chat_getChat

mcp_graph_chat_getChatMessage

mcp_graph_chat_listChatMembers

mcp_graph_chat_listChatMessages

mcp_graph_chat_listChats

mcp_graph_chat_postMessage

mcp_graph_chat_updateChat

mcp_graph_chat_updateChatMessage

チャンネルとチームのツール

mcp_graph_teams_addChannelMember

mcp_graph_teams_createChannel

mcp_graph_teams_createPrivateChannel

mcp_graph_teams_getChannel

mcp_graph_teams_getTeam

mcp_graph_teams_listChannelMembers

mcp_graph_teams_listChannelMessages

mcp_graph_teams_listChannels

mcp_graph_teams_listTeams

mcp_graph_teams_postChannelMessage

mcp_graph_teams_replyToChannelMessage

mcp_graph_teams_updateChannel

mcp_graph_teams_updateChannelMember

サポートされている操作

主な機能

フィードバック

その他のリソース

Microsoft Teams MCP サーバーリファレンス

チャットツール