---
title: "MCP: Claude’u ve diğer yapay zekâ asistanlarını mssgs’e bağla"
description: "Claude, Cursor ve diğer yapay zekâ araçlarını MCP üzerinden mssgs’e bağla. 127 araçlı, yerel ve izin denetimli sunucu: kanalları oku, mesaj gönder ve dahası."
canonical: https://docs.mss.gs/tr/mcp
language: tr
---

# 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 özetle** Kanallar, DM’ler, bahsetmeler ve sabitlenmiş mesajlar; yalnızca erişime açtığın kanallarda.

- **İzin verdiğinde yaz** Göndermeyi açtığında mesaj gönder, yanıtla, tepki ver, düzenle ve sabitle.

- **Oyun oyna** Bir daveti kabul et, tahtayı oku ve gerçek hamleler yap.

- **Kontrol sende** Varsayılan olarak kapalı, önce salt okunur, yalnızca yerel, her yapay zekâ aracı için iptal edilebilir bir token.

Uygulamada

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ış](#overview)

- [Bağlanma](#connect)

- [İzinler ve token’lar](#permissions)

- [Gerçek zamanlı olaylar](#events)

- [Araçlar](#tools)

## 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

Kimlik doğrulama, uygulamanın [AI / MCP ayarlar sayfasından](https://mss.gs/tr/help/bots-mcp/connect-your-ai) 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.

```bash
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](https://mss.gs/tr/help/bots-mcp/connect-your-ai) 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ı](https://docs.mss.gs/tr/bots) 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

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

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

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

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

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

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

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

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 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ı

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

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

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

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

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