Skip to main content
Glama

msteams-mcp: Teams sohbetleri için salt okunur MCP sunucusu (şartname deposu)

Bu depoda kod yoktur. Bunun yerine projenin tam şartnamesi vardır: SPEC.md.

Şartname, AI asistanının (VS Code Copilot Chat, Claude vb.) kullanıcının kendi Teams sohbetlerini okuyabilmesi, son günlerin mesajlarında arama yapabilmesi ve kendisinden bahsedilen mesajları bulabilmesi için kendi bilgisayarında çalışan, en az yetkiyle ve kullanıcının kendi Entra uygulaması üzerinden çalışan bir MCP sunucusunun ne olduğunu, neden bu şekilde tasarlandığını ve nasıl yazılacağını anlatır.

A specification for a small, self-hosted, read-only MCP server for Microsoft Teams chats (delegated permissions, own Entra app, local stdio or loopback HTTP). This repository contains the spec, not the code: have your coding agent write it, review it, and run it in your own tenant.

Neden kod yerine şartname?

Bu sunucu kuruluşunuzun Teams verisine dokunur. Hazır bir kodu olduğu gibi kurmak yerine:

  • kendi Entra uygulama kaydınızla, kendi güvenlik incelemenizle yazdırın,

  • her güvenlik kontrolünün testini görün (şartnamede 12 maddelik gereksinim listesi var),

  • kuruma özel değerler (tenant, client id) hiçbir yerde paylaşılmasın.

Related MCP server: M365 MCP

Nasıl kullanılır?

  1. SPEC.md dosyasını boş bir klasöre koyun.

  2. Bölüm 2'deki ön koşulları hazırlayın (Entra'da tek tenant uygulama kaydı, User.Read ve Chat.Read temsilci izinleri).

  3. Claude Code'a (tercihen Opus ile) bölüm 13'teki istemi verin. Ajan bölüm 12'deki yapım sırasını adım adım izler.

  4. Ortaya çıkan kodu kendiniz inceleyin, bölüm 14'teki adımlarla kurun, bölüm 15'teki doğrulama listesini çalıştırın ve gizli bilgi taraması yapın.

  5. Kurulum ve işletim belgelerini de ajan yazar (bölüm 11).

Ortaya çıkan sunucunun araçları

Araç

Ne yapar

İzin

auth_status

Hangi hesapla bağlı olunduğu, verilen izinler, token'ın bitiş zamanı

yok

get_current_user

Giriş yapan kişinin profili

User.Read

list_chats

Sohbetler (birebir, grup, toplantı), üyeler, son mesaj önizlemesi

Chat.Read

get_chat_messages

Bir sohbetin mesajları; tarih, gönderen ve sıra seçenekleri

Chat.Read

search_messages

Son 1 ile 30 gündeki sohbet mesajlarında metin arama

Chat.Read

get_my_mentions

Son 1 ile 30 günde kişiden @ ile bahsedilen mesajlar

Chat.Read

Hepsi salt okunurdur ve yalnızca /me/... üzerinden çalışır. Yönetici onayı gerektiren bir izin yoktur.

Önemli uyarılar

  • Veri, AI istemciniz üzerinden bilgisayarınızdan çıkar. Teams mesaj metinleri MCP istemcinizin kullandığı AI modeline (çoğunlukla bir bulut servisi) gönderilir. Kurum verisiyle kullanmadan önce hukuk, KVKK ve BT güvenlik onayı alın.

  • Sunucu yalnızca kişisel iş istasyonunda, tek kullanıcı için tasarlanmıştır. Paylaşımlı sunucuda çalıştırmayın.

  • Teams verisiyle çalışırken aynı oturumda e-posta, web, dosya yazma ve GitHub gibi dışarı yazabilen MCP sunucularını kapalı tutun (prompt injection ile veri sızdırma riski).

  • Bu şartname bir güvenlik garantisi değildir. Ortaya çıkan kod sizin sorumluluğunuzdadır.

Lisans

MIT © 2026 Anıl Yavuz. Microsoft ile bağlantılı değildir ve Microsoft tarafından onaylanmamıştır. Microsoft, Microsoft Teams, Microsoft Entra ve Microsoft Graph, Microsoft şirketler grubunun ticari markalarıdır.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that bridges Microsoft Teams with MCP-compatible clients (LLMs, agentic frameworks, CLI), enabling chat integration, message search, and event streaming without traditional REST API endpoints.
      -
    • A
      license
      A
      quality
      C
      maintenance
      A read-only, offline MCP server for Microsoft Teams that searches chats, reads conversations, and finds people directly from the local on-disk cache with no cloud API.
      6
      388 npm
      3
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server enabling AI assistants to interact with Microsoft Teams, users, chats, and organizational data via Microsoft Graph APIs.
      1,387 npm
      MIT