MCP Tools Reference: chatmcp.googleapis.com

Araç: send_message

Markdown biçimlendirmesiyle bir görüşmeye Google Chat sohbet mesajı gönderir.

Bu araç, giriş olarak sohbet kimliği, isteğe bağlı ileti dizisi kimliği ve ileti metni kullanır.

Görüşme kimlikleri, search_conversations aracı kullanılarak bulunabilir.

Oluşturulan mesajı döndürür.

Aşağıdaki kod örneğinde, send_message MCP aracını çağırmak için curl simgesinin nasıl kullanılacağı gösterilmektedir.

Curl İsteği 
curl --location 'https://chatmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "send_message",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giriş Şeması

SendMessageRequest

JSON gösterimi 
{
  "conversationId": string,
  "threadId": string,
  "messageText": string
}
Alanlar
conversationId

string

Zorunlu. Mesajın gönderileceği görüşmenin kimliği (ör. "spaces/AAAA...").
threadId

string

İsteğe bağlı. İletinin gönderileceği ileti dizisinin kimliği (ör. "spaces/AAAA.../threads/BBBB..."). Ayarlanmazsa ileti yeni bir ileti dizisine gönderilir.
messageText

string

Zorunlu. İletinin ana içeriği. Biçimlendirme, standart Markdown kullanılarak eklenebilir (tabloların desteklenmediğini unutmayın). Aşağıdaki biçimlendirme desteklenir:

  • Kalın: **text**
  • İtalik: *text* veya _text_
  • Üstü çizili: ~~text~~
  • Tek aralıklı: text
  • Tek aralıklı yazı tipi bloğu:
```
line 1
line 2
```
  • Madde işaretli liste:
* item 1
* item 2
  • Sıralı liste:
1. item 1
2. item 2
  • Blok alıntı: > quoted text
  • Köprü: [label](url)
  • Kullanıcıdan bahsetme: data-email="user@example.com" veya data-user="users/USER_ID" özelliklerine sahip, kendi kendini kapatan bir HTML etiketi chat-user kullanın. Biliniyorsa data-user özelliğini USER_ID ile birlikte kullanın, aksi takdirde kullanıcı e-posta adresiyle birlikte data-email özelliğine geri dönün. data-user özelliğini kullanıyorsanız diğer araç döndürme değerlerinde görünen kullanıcılar/ önekini eklediğinizden emin olun. Not: İleti başına en fazla 10 bahsetmeye izin verilir. Tüm kullanıcılardan bahsetmek (ör. @all veya users/all içeren bir HTML etiketi kullanmak) kesinlikle yasaktır.
  • Özel emoji: data-custom-emoji="customEmojis/abc" veya data-emoji-name=":xyz:" özelliklerine sahip, kendi kendini kapatan bir HTML etiketi chat-emoji kullanın.

Çıkış şeması

Google Chat görüşmesine mesaj gönderme yanıtı.

SendMessageResponse

JSON gösterimi 
{
  "message": {
    object (ChatMessage)
  }
}
Alanlar
message

object (ChatMessage)

Gönderilen mesaj.

ChatMessage

JSON gösterimi 
{
  "messageId": string,
  "threadId": string,
  "plaintextBody": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "threadedReply": boolean,
  "attachments": [
    {
      object (ChatAttachmentMetadata)
    }
  ],
  "reactionSummaries": [
    {
      object (ReactionSummary)
    }
  ]
}
Alanlar
messageId

string

İletinin kaynak adı. Biçim: spaces/{space}/messages/{message}
threadId

string

Bu iletinin ait olduğu ileti dizisi. İleti işlenmemişse bu alan boş olur. Biçim: spaces/{space}/threads/{thread}
plaintextBody

string

Markdown biçimlendirmesi kullanılarak oluşturulan iletinin metin gövdesi.
sender

object (User)

Mesajın göndereni.
createTime

string

Yalnızca çıkış. İletinin oluşturulduğu zaman damgası.
threadedReply

boolean

İletinin ileti dizisi yanıtı olup olmadığı.
attachments[]

object (ChatAttachmentMetadata)

İletiye eklenen dosyalar.
reactionSummaries[]

object (ReactionSummary)

Mesaja eklenen emoji tepkilerinin özeti.

Kullanıcı

JSON gösterimi 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
Alanlar
userId

string

Chat kullanıcısının kaynak adı. Biçim: users/{user}.
displayName

string

Chat kullanıcısının görünen adı.
email

string

Kullanıcının e-posta adresi. Bu alan yalnızca kullanıcı türü HUMAN olduğunda doldurulur.
userType

enum (UserType)

Kullanıcının türü.

ChatAttachmentMetadata

JSON gösterimi 
{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}
Alanlar
attachmentId

string

Ekin kaynak adı. Biçim: spaces/{space}/messages/{message}/attachments/{attachment}.
filename

string

Ekin adı.
mimeType

string

İçerik türü (MIME türü).
source

enum (Source)

Ekin kaynağı.

ReactionSummary

JSON gösterimi 
{
  "emoji": string,
  "count": integer
}
Alanlar
emoji

string

Emoji Unicode dizesi veya özel emoji adı.
count

integer

İlişkili emoji kullanılarak verilen toplam tepki sayısı.

UserType

Google Chat kullanıcısının türü.

Sıralamalar
USER_TYPE_UNSPECIFIED Belirtilmedi.
HUMAN Gerçek bir kullanıcı.
APP Uygulama kullanıcısı.

Kaynak

Ekin kaynağı.

Sıralamalar
SOURCE_UNSPECIFIED Ayrılan
DRIVE_FILE Dosya, Google Drive dosyasıdır.
UPLOADED_CONTENT Dosya Chat'e yüklenir.

Araç Ek Açıklamaları

Araç açıklamaları, belirli bir aracın temel riskini açıklamak için MCP istemcilerine gönderilir. Çoğu istemci bu ipuçlarını güvenilmeyen olarak değerlendirir ancak onay isteminin kullanıcıya ne zaman gönderileceğine karar vermek için kullanılabilirler.

Başlık dizesinin yanı sıra aşağıdaki Boole ipuçları şu şekilde tanımlanır:

  • readOnlyHint: Doğruysa araç ortamını değiştirmez. Varsayılan: false.
  • destructiveHint: Doğruysa araç, yıkıcı işlemler gerçekleştirebilir. Yanlış ise araç yalnızca ekleme işlemleri gerçekleştirebilir. Varsayılan: true.
  • idempotentHint: Doğruysa aynı bağımsız değişkenlerle aracı tekrar tekrar çağırmanın ortamı üzerinde ek bir etkisi olmaz. Varsayılan: false.
  • openWorldHint: Doğruysa araç, harici öğelerden oluşan bir "açık dünya" ile etkileşim kurabilir. Yanlışsa araç yalnızca dahili öğelerle etkileşim kurabilir. Örneğin, bir web arama aracı açık dünya olurken bir bellek aracı açık dünya olmaz.

Yok Edici İpucu: ❌ | İdempotent İpucu: ❌ | Salt Okunur İpucu: ❌ | Açık Dünya İpucu: ✅

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.create