Geliştiriciler MCP

Bir yapay zekâ asistanı bağla

mssgs masaüstü uygulamasında yerleşik bir MCP sunucusu var. Claude, Cursor ya da Codex’i bağla; seçtiğin kanallarda doğrudan kendi bilgisayarından okuyabilir, özetleyebilir ve yanıt verebilirler.

Neler yapabilirsin

Oku ve özetleKanallar, DM’ler, bahsetmeler ve sabitlenmiş mesajlar; yalnızca erişime açtığın kanallarda.
İzin verdiğinde yazGöndermeyi açtığında mesaj gönder, yanıtla, tepki ver, düzenle ve sabitle.
Oyun oynaBir daveti kabul et, tahtayı oku ve gerçek hamleler yap.
Kontrol sendeVarsayılan olarak kapalı, önce salt okunur, yalnızca yerel, her yapay zekâ aracı için iptal edilebilir bir token.

Uygulamada

> #general’i üç maddede özetle ve #daily’ye gönder

● read_channel (channel: "general", limit: 50)

● send_message (channel: "daily")

#daily kanalına gönderildi.

daily

maya09:31

Bugünkü #general özeti:
• Lansman cumaya kaydı.
• Sürüm notları Dani’de.
• Stand-up artık 09.30’da.

Yapay zekâ aracında sorarsın; o da #general’i MCP sunucusu üzerinden okur ve göndermeye izin verdiğin için özeti senin adınla gönderir.

Genel bakış

mssgs masaüstü uygulaması yerleşik bir MCP sunucusuyla (Model Context Protocol) gelir; böylece Claude ya da Cursor gibi yapay zekâ asistanları çalışma alanını okuyabilir ve orada işlem yapabilir. Sunucu yerel olarak senin makinende çalışır ve oturum açtığın mssgs oturumuyla konuşur; ayrı bir bot hesabına ya da barındırmaya gerek yoktur.

Ne göreceğine sen karar verirsin

Sunucu yalnızca localhost üzerinde, mssgs açıkken ve oturum açmışken çalışır. Hangi kanalları erişime açacağını sen seçer, asistanın neler yapabileceğini grup grup açarsın. Şu anda 14 grupta toplam 127 araç var.

Bağlanma

MCP http://127.0.0.1:7444/mcp

Kimlik doğrulama, uygulamanın AI / MCP ayarlar sayfasından aldığın bir Bearer token ile yapılır: sunucuyu aç, erişime açılacak kanalları seç ve “Copy config” düğmesine bas; kopyalanan blokta portun ve token’ın zaten bulunur. Sunucu yalnızca localhost’u dinler (varsayılan port 7444) ve mssgs açıkken ve oturum açmışken çalışır.

Claude Code’u bağla

claude mcp add --transport http mssgs http://127.0.0.1:7444/mcp \
  --header "Authorization: Bearer <your-token>"

Claude Desktop ya da Cursor için: “Copy config” bloğunu yapay zekâ aracının MCP ayarlarına yapıştır. Yardım Merkezi’ndeki adım adım rehbere bak.

İzinler ve token’lar

Bir asistanın gördüğü araçlar, açtığın anahtarlara bağlıdır. Salt okunur araçlar her zaman açıktır; geri kalan her şey bir grup anahtarının arkasındadır. Sunucu yönetimi ve moderasyon ayrıca hesaptaki gerçek izinlerini de kontrol eder.

Grup	Açtıkları
Okuma	Her zaman açık: erişime açık kanallarda mesajları, çevrimiçi durumu, bahsetmeleri ve sabitlemeleri okuma
Gönderme ve etkileşim	Gönderme, yanıtlama, tepki, düzenleme, silme, sabitleme, yazıyor göstergesi; ayrıca DM’de bulunma, sesli aramalar ve oyunlar
Birlikte izleme	Ortak izleme oturumlarını başlatma, onlara katılma ve yönetme
DM istekleri	Gelen DM isteklerini görüntüleme, kabul etme ve reddetme
Sosyal	Profiller, hikâyeler ve harita filtrelerin
Sesli kanallar	Sesli kanala katılma, katılımcıları inceleme ve mikrofonunu yönetme
Hesap ve gizlilik	Arkadaşlar, engellemeler, sessize almalar, okundu durumu, klipler ve konum paylaşımı
Ajan yönlendirme	Kanal ajanlarını, projeleri ve canlı görevleri yapılandırma
Sunucu yönetimi	Kanallar, kategoriler, izin grupları, üyeler, davetler, emojiler, webhook’lar ve tetikleyiciler (gerçek yönetim izinleri yine de uygulanır)
Topluluk moderasyonu	İnceleme kuyrukları ve oylar (yine de moderatör ya da mssgs ekibi hesabı gerekir)
Bilgisayarı uyanık tutma	Asistan çalışırken makinenin uykuya geçmesini önler
Bot hesabı araçları	Etkileşimli embed kartları ve olayları (yalnızca bot hesapları)

Token’lar

Token’ların adı vardır, her yapay zekâ aracı için ayrıdır ve tek tıkla iptal edilebilir; her token’ın yanındaki etkinlik grafiği her birinin tam olarak ne zaman kullanıldığını gösterir. İyi bir alışkanlık: her araç için açıkça adlandırılmış bir token. Dizüstün mü kayboldu? Token’ını iptal et, işe yaramaz hâle gelir.

SSE üzerinden gerçek zamanlı olaylar

MCP endpoint’ini bir akış olarak aç (Accept: text/event-stream ile GET /mcp), JSON-RPC bildirimleri olduğu anda gelsin:

Bildirim	Ne zaman gelir
`notifications/mssgs/message`	Görebildiğin kanallardaki yeni mesajlar
`notifications/mssgs/bot_event`	Asistanının send_bot_message ile gönderdiği mesajlardaki düğme basışları, tepkiler ve yanıtlar
`notifications/mssgs/presence`	Çevrimiçi durum değişiklikleri
`notifications/mssgs/typing`	Yazıyor göstergeleri
`notifications/mssgs/call`	Sesli arama olayları

Etkileşimli bot kartları

Asistanından etkileşimli bot kartları

Düğmeli bir embed kartını send_bot_message ile gönder, akıştaki bot_event olaylarını dinle (ya da get_bot_events ile yokla) ve kartı edit_message ile yerinde güncelle. Bot mesajları belgelerindekiyle aynı kart modeli.

Araç listesi (127)

Aşağıdaki her araç mssgs’te gerçek bir işlemdir. Adlar birebir MCP tanımlayıcılarıdır. Araçlar yalnızca grupları açıldığında görünür.

Okuma

Her zaman açık

Sunucu açıldığı anda kullanılabilen salt okunur araçlar. Yalnızca erişime açtığın kanalları görürler.

Araç	Ne yapar
`list_channels`	Yapay zekâ araçlarına erişime açtığın kanalları listeler.
`read_channel`	Erişime açık bir kanaldaki son mesajları okur.
`get_new_messages`	Erişime açık tüm kanallarda bir zaman damgasından daha yeni mesajları getirir.
`get_channel_stamp`	Bir kanalın okundu/okunmadı durumu, okunmamış mesaj ve bahsetme sayılarıyla.
`get_presence`	Bir kanalda kimlerin bulunduğu ve durumları.
`get_message`	Kimliğine göre tek bir mesajın tamamını, embed’ler ve bağlantı önizlemeleri dahil getirir.
`search_messages`	Bir sunucudaki erişime açık kanallarda mesaj metni arar.
`get_message_context`	Bir arama sonucunun hemen çevresindeki mesajları okur.
`get_account`	Oturum açmış hesabı ve kullanabildiği yetenekleri gösterir.
`get_typing`	Bir kanalda şu anda kimin yazdığı.
`list_mentions`	Senden @ ile bahseden son mesajlar.
`list_pinned_messages`	Bir kanaldaki sabitlenmiş mesajlar.
`subscribe_channel`	Gerçek zamanlı güncellemeler için bir kanala abone olur.
`unsubscribe_channel`	Bir kanalın gerçek zamanlı güncellemelerini durdurur.
`list_subscriptions`	Gerçek zamanlı güncellemeler için abone olduğun kanalları listeler.

Gönderme ve etkileşim

Gönderme anahtarı

Oturum açmış kullanıcı olarak gönder ve işlem yap. Buradaki her şey bir kanala yazar, bu yüzden hepsi tek bir anahtarın arkasındadır.

Araç	Ne yapar
`send_message`	Senin adınla bir kanala mesaj gönderir.
`reply_message`	Belirli bir mesaja, ona bağlı bir yanıtla karşılık verir.
`add_reaction`	Bir mesaja emoji tepkisi ekler.
`remove_reaction`	Emoji tepkilerinden birini kaldırır.
`edit_message`	Kendi mesajlarından birini düzenler.
`delete_message`	Kendi mesajlarından birini siler.
`pin_message`	Bir mesajı sabitler (sabitleme izni gerekir).
`unpin_message`	Sabitlenmiş bir mesajın sabitlemesini kaldırır.
`open_one_view_attachment`	Bir DM’de tek seferlik bir fotoğrafı/videoyu açar.
`set_typing`	Canlı bir “yazıyor…” göstergesi gösterir.
`stop_typing`	Yazıyor göstergesini kaldırır.

DM’de bulunma ve aramalar

Gönderme anahtarı

Bir DM’de bulun ve gerçek sesli aramalar yap: start_dm_call, tıpkı uygulamada arama düğmesine basmak gibi bu bilgisayarın mikrofonunu kullanır.

Araç	Ne yapar
`enter_dm_chat`	Bir DM’de bulunduğunu gösterir.
`leave_dm_chat`	Bir DM’de bulunduğunu göstermeyi bırakır.
`start_dm_call`	Bir DM’de sesli arama başlatır (bu bilgisayarın mikrofonunu kullanır).
`answer_dm_call`	Çalan bir DM aramasını yanıtlar.
`decline_dm_call`	Çalan bir DM aramasını reddeder.
`end_dm_call`	Bir DM aramasını kapatır ya da iptal eder.
`get_call_status`	Sesli aramanın mevcut durumu ve varsa gelen arama.

Oyunlar

Gönderme anahtarı

mssgs’in yerleşik mini oyunlarına katıl ve doğrudan asistanından oyna.

Araç	Ne yapar
`list_game_invites`	Sana gönderilmiş açık oyun davetleri.
`list_active_games`	Şu anda oynadığın oyun odaları.
`accept_game_invite`	Bir daveti room_id ya da katılım koduyla kabul eder.
`get_game_state`	İçinde olduğun bir oyunun canlı tahtası/durumu.
`game_move`	Bir oyunda hamle yapar.
`resign_game`	Bir oyundan pes eder ya da oyundan ayrılır.

Birlikte izleme

Birlikte izleme anahtarı

Ortak izleme oturumları başlat ve yönet, odaya katıl ve birlikte gerçek zamanlı tepki ver.

Araç	Ne yapar
`list_watch_parties`	Erişebildiğin etkin birlikte izleme oturumlarını listeler.
`get_watch_party`	Bir birlikte izleme oturumunun tam durumunu getirir.
`start_watch_party`	Bir kanalda birlikte izleme başlatır.
`join_watch_party`	Etkin bir birlikte izleme oturumuna katılır.
`leave_watch_party`	Bir birlikte izleme oturumundan ayrılır.
`control_watch_party`	Tüm oda için oynatır, duraklatır ya da ileri/geri sarar.
`end_watch_party`	Birlikte izleme oturumunu herkes için bitirir.
`send_watch_party_emote`	Birlikte izleme oturumuna gerçek zamanlı bir emote gönderir.

DM istekleri

DM istekleri anahtarı

Seninle kimlerin konuşma başlatabileceğine karar ver.

Araç	Ne yapar
`view_dm_requests`	Gelen, açık DM isteklerin.
`accept_dm_request`	Bir DM isteğini kabul eder.
`deny_dm_request`	Bir DM isteğini reddeder.

Sosyal: profiller, hikâyeler, harita

Sosyal anahtarı

Profillere bak, hikâyeleri izle ve gönderdiğin harita filtrelerini gör.

Araç	Ne yapar
`get_profile`	Bir kullanıcının user_guid ile herkese açık profili.
`list_story_users`	Görebileceğin, izlenmemiş hikâyesi olan kişiler.
`view_story`	Bir kullanıcının etkin hikâyelerini görüntüler.
`list_map_filters`	Bu hesabın gönderdiği harita filtreleri, moderasyon durumlarıyla.

Sesli kanallar

Ses anahtarı

Bu bilgisayarın canlı sesli kanal oturumunu incele ve yönet.

Araç	Ne yapar
`list_voice_channels`	Bir sunucudaki sesli kanalları listeler.
`get_voice_state`	Mevcut sesli oturumu ve katılımcılarını getirir.
`join_voice_channel`	Bu bilgisayarda bir sesli kanala katılır.
`leave_voice_channel`	Mevcut sesli kanaldan ayrılır.
`set_voice_muted`	Bu bilgisayarın mikrofonunu kapatır ya da açar.

Hesap ve gizlilik

Hesap anahtarı

Hesap sırlarını açığa çıkarmadan arkadaşları, engellemeleri, sessize almaları, okundu durumunu ve klipleri yönet.

Araç	Ne yapar
`list_friends`	Arkadaşlarını listeler.
`list_blocked`	Engellediğin hesapları listeler.
`block_user`	Bir hesabı engeller.
`unblock_user`	Bir hesabın engelini kaldırır.
`list_mutes`	Sessize alınmış kanalları ve sunucuları listeler.
`mute_channel`	Bir kanalı sessize alır.
`unmute_channel`	Bir kanalın sesini açar.
`mute_server`	Bir sunucuyu sessize alır.
`unmute_server`	Bir sunucunun sesini açar.
`mark_channel_read`	Bir kanalı okundu olarak işaretler.
`list_clips`	Oluşturduğun klipleri listeler.
`share_clip`	Kliplerinden birini paylaşılabilir yapar.
`unshare_clip`	Bir klibi paylaşmayı durdurur.
`rename_clip`	Kliplerinden birini yeniden adlandırır.
`list_stickers`	Kullanabildiğin çıkartmaları listeler.
`list_friend_locations`	Şu anda seninle konum paylaşan arkadaşları listeler.
`list_location_viewers`	Şu anda konumunu kimlerin görebildiğini listeler.

Bot hesabı araçları

Bot anahtarı · yalnızca bot hesapları

Etkileşimli embed kartları gönder ve bunlardaki etkileşimleri geri oku. Bir bot hesabıyla oturum açıldığında kullanılabilir.

Araç	Ne yapar
`send_bot_message`	İsteğe bağlı düğmelerle zengin bir embed kartı gönderir (yalnızca bot hesapları).
`get_bot_events`	Bot mesajlarındaki düğme basışlarını, tepkileri ve yanıtları yoklar.
`set_bot_status`	Özel bir çevrimiçi durumu ayarlar ya da kaldırır (yalnızca bot hesapları).

Ajan yönlendirme

Ajan yönlendirme anahtarı

Kanal ajanlarını yapılandır, projeler bağla, canlı görevleri incele ve işi sohbetten yönlendir. Yönetim işlemleri yine de kanal izinleri gerektirir.

Araç	Ne yapar
`list_agent_channels`	Erişime açık kanalları ve ajan kurulumlarını listeler.
`get_channel_agents`	Bir kanalın tam ajan yapılandırmasını getirir.
`set_channel_agents`	Ajanları etkinleştirir ve bir kanalın ajan kurallarını günceller.
`add_channel_agent`	Kullanılabilir bir ajanı bir kanala ekler.
`remove_channel_agent`	Bir ajanı bir kanaldan kaldırır.
`set_agent_project`	Bir kanal ajanına bir proje ve talimatlar bağlar.
`remove_agent_project`	Bir projeyi bir kanal ajanından ayırır.
`list_agent_tasks`	Mevcut ve son ajan görevlerini listeler.
`get_agent_task`	Bir ajan görevinin canlı durumunu ve çıktısını getirir.
`steer_agent_task`	Çalışan bir ajan görevine ek bir talimat gönderir.

Sunucu yönetimi

Sunucu yönetimi anahtarı · yönetim izinleri gerekir

Yönettiğin bir sunucuyu biçimlendir: kanallar, kategoriler, izin grupları, webhook’lar ve tetikleyiciler. Her çağrı yine de o sunucudaki gerçek yönetim izinlerini kontrol eder.

Araç	Ne yapar
`list_manageable_servers`	Yönetebildiğin sunucular ve sahip olduğun izinler.
`get_server_structure`	Bir sunucunun tam kanal ve kategori düzeni.
`create_channel`	Bir kanal oluşturur.
`update_channel`	Bir kanalı yeniden adlandırır, türünü değiştirir ya da taşır.
`delete_channel`	Bir kanalı siler (geri alınamaz).
`create_category`	Bir kanal kategorisi oluşturur.
`update_category`	Bir kategoriyi yeniden adlandırır.
`delete_category`	Bir kategoriyi siler (kanalları kalır).
`list_server_groups`	Bir sunucunun izin grupları.
`create_server_group`	Bir izin grubu oluşturur.
`update_server_group`	Bir izin grubunu yeniden adlandırır, rengini ya da kapsamını değiştirir.
`delete_server_group`	Bir izin grubunu siler.
`list_members`	Sunucu üyelerini ve izin gruplarını listeler.
`add_member_to_group`	Bir sunucu üyesini bir izin grubuna ekler.
`remove_member_from_group`	Bir sunucu üyesini bir izin grubundan çıkarır.
`list_invites`	Etkin sunucu davetlerini listeler.
`create_invite`	Bir sunucu daveti oluşturur.
`delete_invite`	Bir sunucu davetini iptal eder.
`list_custom_emojis`	Bir sunucunun özel emojilerini listeler.
`list_webhooks`	Bir sunucunun gelen webhook’ları.
`create_webhook`	Gelen bir webhook oluşturur.
`get_webhook_url`	Bir webhook’un gönderi yapılabilen URL’sini getirir.
`update_webhook`	Bir webhook’un ayarlarını günceller.
`delete_webhook`	Bir webhook’u siler (URL’si çalışmayı bırakır).
`list_triggers`	Bir sunucunun giden tetikleyicileri.
`create_trigger`	Bir tetikleyici oluşturur (eşleşen mesajlar bir URL’ye POST edilir).
`update_trigger`	Bir tetikleyiciyi günceller.
`delete_trigger`	Bir tetikleyiciyi siler.

Topluluk moderasyonu

Moderasyon anahtarı · yalnızca moderatörler/mssgs ekibi

Uygulamada kalkan düğmesinin açtığı inceleme kuyruklarının aynısı. Oylar ve vetolar yine de gerçek bir moderatör (ya da mssgs ekibi) hesabı gerektirir.

Araç	Ne yapar
`get_moderation_stats`	Moderasyon durumun ve ne kadar işin beklediği.
`list_moderation_queue`	Moderatör oyu bekleyen harita filtreleri.
`approve_map_filter`	Gönderilen bir harita filtresini onaylamak için oy verir.
`deny_map_filter`	Gönderilen bir harita filtresini reddetmek için oy verir.
`list_report_queue`	Moderatör oyu bekleyen şikâyet edilmiş içerik.
`approve_report`	Şikâyet edilen içeriğin kuralları çiğnediği yönünde oy verir.
`deny_report`	Şikâyet edilen içeriğin sorunsuz olduğu yönünde oy verir.
`community_map_propose_filter`	İncelenmek üzere yeni bir harita filtresi gönderir.
`veto_map_filter`	Yalnızca mssgs ekibi: bir harita filtresini hemen kaldırır (geri alınamaz).

Yardımcı araçlar

Uyanık tutma anahtarı

Uzun süre çalışan asistanlar için küçük yardımcılar.

Araç	Ne yapar
`keep_computer_awake`	Sen çalışırken bu bilgisayarı uyanık tutar ya da serbest bırakır.

Geliştirmeye devam et

AjanlarBir yapay zekânın kanal içinde görev almasına izin ver. Webhook’larBir betikten kanala mesaj gönder. Yapay zekânı bağlaAdım adım kurulum, Yardım Merkezi’nde. Mesaj kartlarıBir bot mesajının neler gösterebildiği.