שתף דרך


חומר עזר בנושא שרת MCP של Microsoft Teams

חשוב

עליך להיות חלק מתוכנית התצוגה המקדימה של Frontier כדי לקבל גישה מוקדמת ל - Microsoft Agent 365. Frontier מחברת אתכם ישירות עם החידושים האחרונים של Microsoft בתחום הבינה המלאכותית. קבל תכונות פורצות דרך מעשיות, שתף את התובנות שלך עם צוותי מוצרים ועזור לעצב את עתיד הבינה המלאכותית. תצוגות מקדימות של Frontier כפופות לתנאי התצוגה המקדימה הקיימים של הסכמי הלקוחות שלך. כאשר תכונות אלה עדיין בפיתוח, הזמינות והיכולות שלהן עשויות להשתנות עם הזמן.'

מבט כולל

מזהה שרת שם תצוגה היקף תיאור
mcp_TeamsServer Microsoft Teams MCP Server McpServers.Teams.All שרת MCP של Microsoft Teams Graph לניהול צ'אטים, ערוצים ומשתמשים או הודעות בתוכם. השתמש בשרת MCP זה עבור פעולות של Teams, כגון יצירה, עדכון ואחזור של צ'אטים והודעות צ'אט, ניהול צוותים וערוצים וביצוע משימות ניהוליות הקשורות לאותם צוותים.

כלי צ'אט

mcp_graph_chat_addChatMember

נקודת הקצה: POST /v1.0/chats/{chat-id}/members

הוספת חבר לצ'אט באמצעות user@odata.bind, @odata.typeותפקידים אופציונליים (חבר, בעלים). החזרת 409 אם החבר כבר קיים, 400 עבור הפניות משתמש לא חוקיות או 403 אם מדיניות מגבילה את ההוספה.

פרמטרים נדרשים: מזהה צ'אט, @odata.type, user@odata.bind, תפקידים

mcp_graph_chat_createChat

נקודת הקצה: POST /v1.0/chats

יצירת צ'אט חדש של Teams באמצעות chatType (oneOnOne דורש בדיוק שני משתתפים, קבוצה דורשת יותר משני משתתפים) וחברים. החזרת 400 אם ל- oneOnOne יש מספר חברים שגוי, 409 אם לאותם משתתפים כבר יש צ'אט, או 403 אם למשתתף אין זכויות.

פרמטרים נדרשים: chatType, חברים

mcp_graph_chat_deleteChat (פונקציה למחיקת צ'אט)

נקודת הקצה: מחק /v1.0/chats/{chat-id}

מחיקה זמנית של צ'אט. החזרת 403 אם חסרה הרשאה, 404 אם היא כבר נמחקה, והיא כפופה למדיניות שמירת דיירים.

פרמטרים נדרשים: מזהה צ'אט

mcp_graph_chat_deleteChatMessage

נקודת הקצה: POST /v1.0/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/softDelete

מחיקה זמנית של הודעת צ'אט. מחזיר 403 בהיעדר Chat.ReadWrite, 404 עבור מזהים לא חוקיים, ועדיין עשוי לשמור על ההודעה למטרות תאימות.

פרמטרים נדרשים: מזהה משתמש, מזהה צ'אט, צ'אטMessage-id

mcp_graph_chat_getChat

נקודת הקצה: קבל /v1.0/chats/{chat-id}

מאחזר צ'אט לפי מזהה ומחזיר מטה-נתונים כגון סוג ונושא. החזרת 404 אם הצ'אט אינו קיים או אינו גלוי, או 403 אם ההרשאות נדחו.

פרמטרים נדרשים: מזהה צ'אט

mcp_graph_chat_getChatMessage

נקודת הקצה: קבל /v1.0/chats/{chat-id}/messages/{message-id}

אחזור הודעת צ'אט לפי מזהה. החזרת 404 אם ההודעה אינה קיימת או מוסתרת, או 403 ללא זכויות מתאימות.

פרמטרים נדרשים: מזהה צ'אט, מזהה הודעה

mcp_graph_chat_listChatMembers

נקודת הקצה: קבל /v1.0/chats/{chat-id}/members

פירוט משתתפי הצ'אט. מחזירה תפקידים (חבר/בעלים/אורח). החזרת 403 ללא הרשאות קריאה או 404 אם הצ'אט לא נמצא.

פרמטרים נדרשים: מזהה צ'אט

mcp_graph_chat_listChatMessages

נקודת הקצה: קבל /v1.0/chats/{chat-id}/messages

רשימת הודעות בצ'אט עם $top, $filter, ו-$orderby אופציונליים. החזרת תוצאות בעמודים; תאימות עשויה להסתיר תוכן. שגיאות כוללות 400 עבור שאילתות שגויות ו- 429 לצורך ויסות.

פרמטרים נדרשים: מזהה צ'אט

פרמטרים אופציונליים: $top, $filter, $orderby

רשימת הצ'אטים של ה-mcp_graph_chat

נקודת הקצה: קבל /v1.0/צ'אטים

פירוט צ'אטים עבור מתקשר עם אפשרויות $top, $filter, $expand ו- $orderby. החזרת צ'אטים גלויים בלבד; ייתכן שהודעות צ'אט מוסתרות או צ'אטים במערכת לא ייכללו. החזרת 400 עבור ביטויי מיון לא חוקיים.

פרמטרים אופציונליים: $top, $orderby, $expand, $filter

mcp_graph_chat_postMessage

נקודת הקצה: POST /v1.0/chats/{chat-id}/messages

הצבת הודעה חדשה בטקסט רגיל בצ'אט. נדרש מזהה צ'אט וגוף שאינו ריק.תוכן; רק טקסט נתמך. עשויה להחזיר 429 לצורך ויסות, 403 אם חסרות הרשאות, או 404 אם הצ'אט אינו חוקי. פעולתו אינה ניתנת לשחזור באותו אופן – הימנע מניסיונות חוזרים ללא בחינה.

פרמטרים נדרשים: מזהה צ'אט, גוף

mcp_graph_chat_updateChat

נקודת הקצה: תיקון /v1.0/chats/{chat-id}

עדכון מאפייני צ'אט, כגון הנושא עבור צ'אטים קבוצתיים בלבד. נכשל עם 400 אם נעשה שימוש בצ'אט אחד על אחד, 403 ללא זכויות או 404 אם הצ'אט לא נמצא.

פרמטרים נדרשים: מזהה צ'אט, נושא

mcp_graph_chat_updateChatMessage

נקודת הקצה: תיקון /v1.0/chats/{chat-id}/messages/{message-id}

עדכון הודעת צ'אט בתוכן טקסט רגיל חדש. ייתכן שהעריכה נחסמה עבור הודעות מערכת או תאימות מסוימות. החזרת 403 או 400 אם עריכה אסורה, או 409 בעת התנגשויות.

פרמטרים נדרשים: מזהה צ'אט, מזהה הודעה

כלי ערוצים וצוותים

mcp_graph_teams_addChannelMember

נקודת הקצה: POST /v1.0/teams/{team-id}/channels/{channel-id}/members

הוספת חבר לערוץ פרטי או משותף עם user@odata.bind, @odata.typeותפקידים אופציונליים (בעלים או ריקים). נכשל בערוצים רגילים, מחזיר 409 אם החבר כבר קיים ו- 403 אם חסרות לו הרשאות.

פרמטרים נדרשים: מזהה צוות, מזהה ערוץ, displayName, תפקידים, user@odata.bind, @odata.type

mcp_graph_teams_createChannel

נקודת הקצה: POST /v1.0/teams/{team-id}/channels

יצירת ערוץ בצוות עם displayName, תיאור אופציונלי, membershipType (רגיל, פרטי, משותף) וחברים אופציונליים. ערוצים פרטיים או משותפים דורשים חברים שהוגדרו במפורש; כפילויות או חברויות לא חוקיות יגרמו לשגיאות 400 או 409.

פרמטרים נדרשים: מזהה צוות, displayName

פרמטרים אופציונליים: תיאור, membershipType, חברים

mcp_graph_teams_createPrivateChannel

נקודת הקצה: POST /v1.0/teams/{team-id}/channels

יצירת ערוץ פרטי עם membershipType: פרטי. נדרשים משתמשים בזמן ההקמה, כולל לפחות בעלים אחד. החזרת 400 אם חברים חסרים, 409 עבור שמות כפולים או 403 ללא הרשאות.

פרמטרים נדרשים: מזהה צוות, displayName, חברים

mcp_graph_teams_getChannel

נקודת הקצה: קבל /v1.0/teams/{team-id}/channels/{channel-id}

מאחזר ערוץ תוך שימוש אופציונלי ב-$select ו-$filter. החזרת 404 אם הערוץ לא נמצא או שחסרה למתקשר גישה, 403 אם הרשאות אינן מספיקות או 400 עבור מסננים שאינם נתמכים.

פרמטרים נדרשים: מזהה צוות, מזהה ערוץ

פרמטרים אופציונליים: $select, $filter

mcp_graph_teams_getTeam

נקודת הקצה: קבל /v1.0/teams/{team-id}

מאחזר מאפייני צוות עם $select ו-$expand אופציונליים. החזרת 403 או 404 אם הצוות אינו נגיש.

פרמטרים נדרשים: מזהה צוות

פרמטרים אופציונליים: $select, $expand

mcp_graph_teams_listChannelMembers

נקודת הקצה: קבל /v1.0/teams/{team-id}/channels/{channel-id}/members

פירוט כל החברים בערוץ Microsoft Teams ספציפי, החזרת מטה-נתונים אודות כל חבר, כגון זהות, תפקידים ומצב חברות. שימושי לביקורת על השתתפות בערוץ, אימות חברות לפני עדכוני תפקידים או כדי להבטיח תאימות.

פרמטרים נדרשים: מזהה צוות, מזהה ערוץ

פרמטרים אופציונליים: $top, $expand

mcp_graph_teams_listChannelMessages

נקודת הקצה: קבל /v1.0/teams/{team-id}/channels/{channel-id}/messages

פירוט הודעות בערוץ עם אפשרויות $top והודעות $expand (לדוגמה, תשובות). חלוקה לעמודים מטופלת באמצעות @odata.nextLink. החזרת 403 ללא הרשאת קריאה או 400 עבור אפשרויות שאילתה לא חוקיות.

פרמטרים נדרשים: מזהה צוות, מזהה ערוץ

פרמטרים אופציונליים: $top, $expand

mcp_graph_teams_listChannels

נקודת הקצה: GET /v1.0/teams/{team-id}/allChannels

פירוט ערוצים בצוות עם אפשרות ל-$select או $filter. מחזירה ערוצים פרטיים ומשותפים רק אם מתקשר הוא חבר. נכשל עם 403 אם לחייג חסרות זכויות קריאה או 400 בשאילתות OData לא חוקיות.

פרמטרים נדרשים: מזהה צוות

פרמטרים אופציונליים: $select, $filter

mcp_graph_teams_listTeams

נקודת הקצה: GET /v1.0/users/{user-id}/joinedTeams

פירוט הצוותים המצורפים של משתמש ספציפי. החזרת חברויות של משתמש זה בלבד, לא של כל צוותי הדיירים. החזרת 403 אם למשתמש החייג לא היתה אפשרות לבצע שאילתה על המשתמש או על 404 אם המזהה אינו חוקי.

פרמטרים נדרשים: מזהה משתמש

mcp_graph_teams_postChannelMessage (פונקציה בגרף MCP לשליחת הודעה לערוץ ב-Teams)

נקודת הקצה: POST /v1.0/teams/{team-id}/channels/{channel-id}/messages

הצבת הודעה בטקסט רגיל בערוץ. נדרש מזהה צוות, מזהה ערוץ וגוף.תוכן. החזרת 403 ללא ChannelMessage.Send, 404 אם הערוץ לא נמצא, או 400 אם התוכן חסר.

פרמטרים נדרשים: מזהה צוות, מזהה ערוץ, גוף

mcp_graph_teams_replyToChannelMessage

נקודת הקצה: POST /v1.0/teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies

מענה להודעה בערוץ עם body.content. קיימת תמיכה בטקסט רגיל בלבד. החזרת 404 אם הודעת האב לא נמצאה, 403 ללא זכויות או 400 עבור תוכן לא חוקי.

פרמטרים נדרשים: מזהה צוות, מזהה ערוץ, מזהה הודעה, גוף

mcp_graph_teams_updateChannel

נקודת הקצה: תיקון /teams/{team-id}/channels/{channel-id}

עדכון ערוץ עם displayName או תיאור חדש. עשויות לחול הגבלות על ערוצים מיוחדים, כגון כללי. החזרת 403 ללא זכויות, 409 על שמות כפולים או 400 עבור קלט לא חוקי.

פרמטרים נדרשים: מזהה צוות, מזהה ערוץ

פרמטרים אופציונליים: displayName, תיאור

mcp_graph_teams_updateChannelMember

נקודת הקצה: תיקון /teams/{team-id}/channels/{channel-id}/members/{membership-id}

עדכון תפקיד של חבר בערוץ פרטי או משותף על-ידי שינוי תפקידים. ערוצים רגילים מקבלים בירושה תפקידים מהצוות וברוב רוב דוחים עדכונים. החזרת 400 אם נעשה ניסיון בערוצים רגילים, 403 אם לא מורשה או 404 אם החבר לא נמצא.

פרמטרים נדרשים: מזהה צוות, מזהה ערוץ, מזהה חברות, תפקידים

פעולות נתמכות

  1. ניהול צ'אט (יצירה, קריאה, עדכון, מחיקה)
  2. פעולות הודעה (שליחה, אחזור, עריכה, מחיקה)
  3. ניהול ערוצים (יצירה, קביעת תצורה, רשימה)
  4. ניהול חברים (הוספה, עדכון, רשימה)
  5. פעולות צוות (אחזור, רשימה)

תכונות מרכזיות

  1. פעולות CRUD מלאות עבור צ'אטים וערוצים
  2. תמיכה בערוצים פרטיים, משותפים ותקניים
  3. שרשור הודעות ותשובות
  4. ניהול תפקידים של חברים
  5. תמיכה בשאילתות OData עבור סינון וחלוקה לעמודים