MCP Reference: people.googleapis.com

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.

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.

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

MCP Araçları
search_directory_people

Kuruluşunuzun Google Workspace Dizini'ndeki kullanıcıları arama Bu özellik yalnızca Google Workspace hesaplarında (işletmeler, okullar ve diğer kuruluşlar tarafından kullanılan) kullanılabilir ve kişisel Google Hesaplarında kullanılamaz.

UYULMASI GEREKEN ÖNEMLİ KURALLAR:

  • Bu araç birden fazla sonuç döndürürse sonuçları kullanıcıya göstermeli ve devam etmeden önce hangi sonucun kullanılacağı konusunda kullanıcıdan açıklama istemelisiniz.

  • Bu aracın çıktısını, kullanıcının açık onayı olmadan başka bir araca (ör. e-posta gönderme, taslak oluşturma, etkinlik oluşturma vb.) aktarmanız kesinlikle yasaktır.

  • Yalnızca bir kişi sonucu bulunsa bile, bulunan kişinin ayrıntılarını kullanıcıya sunmanız ve sonraki adımlara geçmeden önce kullanıcının bu kişinin amaçlanan kişi olduğunu doğrulamasını istemeniz gerekir.

  • Bu araç sonuç döndürmezse search_contacts aracını kullanın.
search_contacts

Kullanıcının kişilerini arama

UYULMASI GEREKEN ÖNEMLİ KURALLAR:

  • Bu araç birden fazla sonuç döndürürse sonuçları kullanıcıya göstermeli ve devam etmeden önce hangi sonucun kullanılacağı konusunda kullanıcıdan açıklama istemelisiniz.

  • Bu aracın çıktısını, kullanıcının açık onayı olmadan başka bir araca (ör. e-posta gönderme, taslak oluşturma, etkinlik oluşturma vb.) aktarmanız kesinlikle yasaktır.

  • Yalnızca bir kişi sonucu bulunsa bile, bulunan kişinin ayrıntılarını kullanıcıya sunmanız ve sonraki adımlara geçmeden önce kullanıcının bu kişinin amaçlanan kişi olduğunu doğrulamasını istemeniz gerekir.
get_user_profile Kendinizle ilgili profil bilgilerini (ad ve e-posta) alma

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://people.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
}'