Work IQ 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人の参加者が必要、グループは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 を返し、準拠のためにメッセージを保持する可能性があります。

必須のパラメータ：ユーザーID (user-id), チャットID (chat-id), チャットメッセージ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

チャット参加者を一覧表示します。 ロール (メンバー、所有者、またはゲスト) を返します。 読み取りアクセス許可のない 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_グラフ_チャット_リストチャット

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

省略可能な $top、 $filter、 $expand、および $orderbyを使用して、発信者のチャットを一覧表示します。 表示されているチャットのみを返します。非表示またはシステムチャットは除外される場合があります。 無効な並べ替え式の場合は 400 を返します。

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

mcp_graph_chat_postMessage

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

チャットに新しいプレーン テキスト メッセージを投稿します。 必要なのはchat-idと内容が空ではないボディのコンテンツです、テキストのみが対応しています。 調整用の 429、アクセス許可がない場合は 403、チャットが無効な場合は 404 が返される場合があります。 盲目的なリトライidempotent—avoidではありません。

必須のパラメーター: 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 を返します。

必要なパラメータ: チームID、チャネルID、 displayName、役割、 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を持つチャネルを取得します。 チャネルが見つからない場合、または呼び出し元にaccessがない場合は 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 チャネルのすべてのメンバーを一覧表示します。 ID、ロール、メンバーシップの状態など、各メンバーに関するメタデータを返します。 この情報は、チャネル参加の監査、ロールの更新前のメンバーシップの確認、またはコンプライアンスの確認に役立ちます。

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

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

mcp_graph_teams_listChannelMessages

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

チャネル内のメッセージを一覧表示します。 オプションの $top パラメーターと $expand パラメーターを使用して、結果をカスタマイズします。 たとえば、 $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 クエリによるフィルターとページングのサポート