MCP Reference: chatmcp.googleapis.com

Chat MCP API, Google Chat sohbet özellikleri için uzaktan MCP sağlar.

Model Context Protocol (MCP) sunucusu, Büyük Dil Modeli'ne (LLM) veya yapay zeka uygulamasına bağlam, veri ya da özellikler sağlayan harici bir hizmet ile bu hizmeti kullanan uygulama arasında proxy görevi görür. MCP sunucuları, yapay zeka uygulamalarını veritabanları ve web hizmetleri gibi harici sistemlere bağlar ve yanıtlarını yapay zeka uygulamasının anlayabileceği bir biçime çevirir.

Sunucu Kurulumu

Kullanmadan önce Chat MCP sunucusunu yapılandırmanız gerekir. Google ve Google Cloud uzaktan MCP sunucularını kullanma hakkında daha fazla bilgi için Google Cloud MCP sunucularına genel bakış başlıklı makaleyi inceleyin.

Sunucu uç noktaları

MCP hizmeti uç noktası, bir yapay zeka uygulamasının (MCP istemcisinin ana makinesi) güvenli ve standartlaştırılmış bir bağlantı oluşturmak için kullandığı MCP sunucusunun ağ adresi ve iletişim arayüzüdür (genellikle bir URL). LLM'nin bağlam istemek, bir aracı çağırmak veya bir kaynağa erişmek için kullandığı iletişim noktasıdır. Google MCP uç noktaları küresel veya bölgesel olabilir.

Chat API MCP sunucusunun aşağıdaki genel MCP uç noktası vardır:

  • https://chatmcp.googleapis.com/mcp/v1

MCP Araçları

MCP aracı, bir MCP sunucusunun gerçek dünyada işlem yapmak için bir LLM'ye veya yapay zeka uygulamasına sunduğu bir işlev ya da yürütülebilir özelliktir.

Araçlar

chatmcp.googleapis.com MCP sunucusunda aşağıdaki araçlar bulunur:

MCP Araçları
list_messages Belirli bir Google Chat görüşmesinden (alan, doğrudan mesaj (DM) veya grup DM'si) mesajları alır. İleti dizisine, zaman aralığına ve ileti sayısına göre filtreleme yapılmasına olanak tanır. Ayrıca, daha fazla bağlam bilgisi sağlamak için sonraki ileti sayfası da alınabilir. Özel mesajlar (yalnızca tek bir kullanıcıya görünür olan mesajlar) filtrelenir.
search_conversations

Google Chat görüşmelerini görünen ada göre arar.

Yalnızca katılımcılar sağlanırsa bu araç, belirtilen katılımcıları ve arayan kullanıcıyı içeren bire bir doğrudan mesajları (bir katılımcı sağlanırsa) veya grup sohbetlerini (birden fazla katılımcı sağlanırsa) bulur.

Yalnızca bir sorgu sağlanırsa bu araç, sorgunun ileti dizisinin görünen adının büyük/küçük harfe duyarsız bir alt dizesi olduğu ileti dizilerini arar.

Hem katılımcılar hem de sorgu sağlanırsa bu araç, katılımcılara göre görüşmeleri bulur ve ardından bunları görünen ada göre filtreler.

Ne katılımcılar ne de sorgu sağlanırsa bu araç, arayan kullanıcının üyesi olduğu tüm görüşmeleri listeler.

Bu araç yalnızca arayan kullanıcının üyesi olduğu görüşmeleri listeler.

ÖNEMLİ: Boş bir "konuşmalar" listesi, genel olarak başka sonuç olmadığı anlamına gelmez. "next_page_token" mevcutsa daha fazla sayfa getirilebilir. Boş bir liste alırsanız ancak "next_page_token" varsa kullanıcıya aramaya devam edip etmemeniz gerektiğini sorun.

MCP aracı özelliklerini alma

Bir MCP sunucusundaki tüm araçlar için MCP aracı özelliklerini almak üzere tools/list yöntemini kullanın. Aşağıdaki örnekte, MCP sunucusunda şu anda kullanılabilen tüm araçları ve özelliklerini listelemek için curl komutunun nasıl kullanılacağı gösterilmektedir.

Curl İsteği 
curl --location 'https://chatmcp.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'