MCP Reference: gmailmcp.googleapis.com

Это MCP-сервер, предоставляемый API Gmail. Сервер предоставляет разработчикам инструменты для создания LLM-приложений на базе Gmail.

Сервер протокола контекста модели (MCP) выступает в качестве прокси-сервера между внешним сервисом, предоставляющим контекст, данные или возможности для приложения, использующего большие языковые модели (LLM) или ИИ. Серверы MCP соединяют приложения ИИ с внешними системами, такими как базы данных и веб-сервисы, преобразуя их ответы в формат, понятный приложению ИИ.

Настройка сервера

Перед использованием необходимо настроить сервер Gmail MCP . Дополнительную информацию об использовании удаленных серверов MCP Google и Google Cloud см. в разделе «Обзор серверов MCP Google Cloud» .

Серверные конечные точки

Конечная точка сервиса MCP — это сетевой адрес и интерфейс связи (обычно URL) сервера MCP, который приложение ИИ (хост для клиента MCP) использует для установления безопасного стандартизированного соединения. Это точка контакта для LLM, позволяющая запросить контекст, вызвать инструмент или получить доступ к ресурсу. Конечные точки Google MCP могут быть глобальными или региональными.

Сервер Gmail API MCP имеет следующую глобальную конечную точку MCP:

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

Инструменты MCP

Инструмент MCP — это функция или исполняемый файл, который сервер MCP предоставляет приложению LLM или AI для выполнения действий в реальном мире.

Инструменты

Сервер MCP gmailmcp.googleapis.com располагает следующими инструментами:

Инструменты MCP
создать_черновик

Создает новый черновик электронного письма в учетной записи Gmail авторизованного пользователя.

Этот инструмент принимает в качестве входных данных адреса получателей, тему и текст сообщения. Он возвращает идентификатор созданного черновика Gmail.

список_черновиков

Отображает список черновиков писем из учетной записи Gmail авторизованного пользователя.

Этот инструмент позволяет фильтровать черновики на основе строки запроса и поддерживает пагинацию. Он возвращает список черновиков, включая их идентификаторы и темы.

get_thread Извлекает конкретную цепочку электронных писем из учетной записи Gmail авторизованного пользователя, включая список ее сообщений.
поиск_потоков

Отображает переписку по электронной почте из учетной записи Gmail авторизованного пользователя.

Этот инструмент позволяет фильтровать ветки обсуждений на основе строки запроса и поддерживает пагинацию. Он возвращает список веток, включая их идентификаторы и связанные сообщения. Каждое связанное сообщение содержит подробную информацию, такую ​​как фрагмент текста сообщения, тема, отправитель, получатели и т. д. Обратите внимание, что этот инструмент не возвращает полные тексты сообщений; при необходимости используйте инструмент 'get_thread' с идентификатором ветки, чтобы получить полный текст сообщения.

label_thread

Добавляет метки ко всей ветке обсуждений в учетной записи Gmail авторизованного пользователя. Эта операция затрагивает все сообщения, находящиеся в данный момент в ветке, а также любые будущие сообщения, добавленные к ней.

Если вы не уверены в идентификаторе темы, сначала воспользуйтесь инструментом search_threads .

Если вы не уверены в идентификаторе пользовательской метки, сначала воспользуйтесь инструментом list_labels , чтобы узнать доступные метки и их идентификаторы.

unlabel_thread Удаляет метки из всей ветки обсуждений в учетной записи Gmail авторизованного пользователя. Если идентификатор ветки неизвестен, сначала воспользуйтесь инструментом search_threads . Если идентификатор метки пользователя неизвестен, сначала воспользуйтесь инструментом list_labels .
list_labels Этот инструмент отображает все пользовательские метки, доступные в учетной записи Gmail авторизованного пользователя. Используйте его, чтобы узнать id пользовательской метки перед вызовом label_thread , unlabel_thread , label_message или unlabel_message . Системные метки не возвращаются этим инструментом, но могут использоваться с их общеизвестными идентификаторами: 'INBOX', 'TRASH', 'SPAM', 'STARRED', 'UNREAD', 'IMPORTANT', 'CHAT', 'DRAFT', 'SENT'.
label_message

Добавляет одну или несколько меток к конкретному сообщению в учетной записи Gmail авторизованного пользователя.

Чтобы найти идентификатор сообщения, используйте такие инструменты, как search_threads или get_thread . Если вы не уверены в идентификаторе метки пользователя, сначала воспользуйтесь инструментом list_labels , чтобы найти доступные метки и их идентификаторы.

unlabel_message Удаляет одну или несколько меток из конкретного сообщения в учетной записи Gmail авторизованного пользователя. Чтобы найти идентификатор сообщения, используйте такие инструменты, как search_threads или get_thread . Если вы не уверены в идентификаторе метки пользователя, сначала воспользуйтесь инструментом list_labels , чтобы найти доступные метки и их идентификаторы.
создать_метку Создает новую метку в учетной записи Gmail авторизованного пользователя.

Получить технические характеристики инструмента MCP

Чтобы получить спецификации всех инструментов MCP на сервере MCP, используйте метод tools/list . В следующем примере показано, как использовать curl для вывода списка всех инструментов и их спецификаций, доступных в данный момент на сервере MCP.

Запрос Curl 
curl --location 'https://gmailmcp.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
}'