Este es un servidor de MCP que proporciona la API de Gmail. El servidor proporciona herramientas para que los desarrolladores creen aplicaciones de LLM sobre Gmail.
Un servidor de Protocolo de contexto del modelo (MCP) actúa como proxy entre un servicio externo que proporciona contexto, datos o capacidades a un modelo de lenguaje grande (LLM) o una aplicación de IA. Los servidores de MCP conectan aplicaciones de IA a sistemas externos, como bases de datos y servicios web, y traducen sus respuestas a un formato que la aplicación de IA puede comprender.
Configuración del servidor
Debes configurar el servidor de MCP de Gmail antes de usarlo. Para obtener más información sobre el uso de servidores de MCP remotos de Google y Google Cloud, consulta Descripción general de los servidores de MCP de Google Cloud.
Extremos del servidor
Un extremo de servicio de MCP es la dirección de red y la interfaz de comunicación (por lo general, una URL) del servidor de MCP que usa una aplicación de IA (el host para el cliente de MCP) para establecer una conexión segura y estandarizada. Es el punto de contacto para que el LLM solicite contexto, llame a una herramienta o acceda a un recurso. Los extremos de MCP de Google pueden ser globales o regionales.
El servidor de MCP de la API de Gmail tiene el siguiente extremo de MCP global:
- https://gmailmcp.googleapis.com/mcp/v1
Herramientas de MCP
Una herramienta de MCP es una función o capacidad ejecutable que un servidor de MCP expone a un LLM o una aplicación de IA para realizar una acción en el mundo real.
Herramientas
El servidor de MCP de gmailmcp.googleapis.com tiene las siguientes herramientas:
| Herramientas de MCP | |
|---|---|
| create_draft |
Crea un nuevo borrador de correo electrónico en la cuenta de Gmail del usuario autenticado. Esta herramienta toma como entradas las direcciones de los destinatarios, un asunto y el contenido del cuerpo. Devuelve el ID del borrador de Gmail creado. |
| list_drafts |
Muestra los correos electrónicos borrador de la cuenta de Gmail del usuario autenticado. Esta herramienta puede filtrar borradores según una cadena de consulta y admite la paginación. Devuelve una lista de borradores, incluidos sus IDs y asuntos. |
| get_thread | Recupera una conversación de correo electrónico específica de la cuenta de Gmail del usuario autenticado, incluida una lista de sus mensajes. |
| search_threads |
Muestra las conversaciones de correo electrónico de la cuenta de Gmail del usuario autenticado. Esta herramienta puede filtrar conversaciones según una cadena de consulta y admite la paginación. Devuelve una lista de conversaciones, incluidos sus IDs y mensajes relacionados. Cada mensaje relacionado contiene detalles como un fragmento del cuerpo del mensaje, el asunto, el remitente, los destinatarios, etcétera. Ten en cuenta que esta herramienta no devuelve los cuerpos completos de los mensajes. Si es necesario, usa la herramienta "get_thread" con un ID de conversación para recuperar el cuerpo completo del mensaje. |
| label_thread |
Agrega etiquetas a una conversación completa en la cuenta de Gmail del usuario autenticado. Esta operación afecta a todos los mensajes que se encuentran actualmente en la conversación y a los mensajes futuros que se agreguen a ella. Si no estás seguro del ID de la conversación, usa primero la herramienta Si no estás seguro del ID de una etiqueta de usuario, usa primero la herramienta |
| unlabel_thread |
Quita las etiquetas de una conversación completa en la cuenta de Gmail del usuario autenticado. Si no estás seguro del ID de la conversación, usa primero la herramienta search_threads. Si no estás seguro del ID de una etiqueta de usuario, usa primero la herramienta list_labels.
|
| list_labels |
Muestra todas las etiquetas definidas por el usuario disponibles en la cuenta de Gmail del usuario autenticado. Usa esta herramienta para descubrir el id de una etiqueta de usuario antes de llamar a label_thread, unlabel_thread, label_message o unlabel_message. Esta herramienta no devuelve las etiquetas del sistema, pero se pueden usar con sus IDs conocidos: "INBOX", "TRASH", "SPAM", "STARRED", "UNREAD", "IMPORTANT", "CHAT", "DRAFT" y "SENT".
|
| label_message |
Agrega una o más etiquetas a un mensaje específico en la cuenta de Gmail del usuario autenticado. Para encontrar el ID del mensaje, usa herramientas como |
| unlabel_message |
Quita una o más etiquetas de un mensaje específico en la cuenta de Gmail del usuario autenticado. Para encontrar el ID del mensaje, usa herramientas como search_threads o get_thread. Si no estás seguro del ID de una etiqueta de usuario, usa primero la herramienta list_labels para descubrir las etiquetas disponibles y sus IDs.
|
| create_label | Crea una etiqueta nueva en la cuenta de Gmail del usuario autenticado. |
Obtén especificaciones de la herramienta de MCP
Para obtener las especificaciones de la herramienta de MCP para todas las herramientas de un servidor de MCP, usa el método tools/list. En el siguiente ejemplo, se muestra cómo usar curl para enumerar todas las herramientas y sus especificaciones disponibles actualmente en el servidor de MCP.
| Solicitud 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 }' |