Referencia de herramientas MCP

atbridge mcp ejecuta un servidor Model Context Protocol sobre stdio, exponiendo sus correos de Thunderbird, calendarios, contactos, notas y tareas como herramientas que un cliente de IA puede invocar. El nombre del servidor en la configuración del cliente es atbridge.ai.

// En la configuración de su cliente MCP (consulte las páginas de configuración de conexión de IA)
{
  "mcpServers": {
    "atbridge.ai": { "command": "atbridge", "args": ["mcp"] }
  }
}

Herramientas por área

Cada página enumera las herramientas de lectura de esa área (siempre activas) y las de escritura (opt-in — véase más abajo).

mail Obtener, buscar, listar, ver, hilos, adjuntos — y enviar, responder, reenviar, mover, eliminar, marcar, carpetas.

calendar Eventos, comprobación de conflictos, búsqueda de huecos, ajustes — y crear, actualizar, eliminar, confirmar asistencia.

contacts Contactos y listas de distribución en todas las libretas de direcciones.

notes @bridge Notas — recupere un artefacto como contexto o guarde uno nuevo.

tasks Tareas pendientes (VTODO) en sus calendarios con soporte de tareas.

AI — Correo con marca Generar @bridge Correo con marca; listar y guardar plantillas.

sistema — cuentas, licencia, actualizaciones Seleccionar una identidad de remitente; suscripción, dispositivos, estado de actualización.

Lectura frente a escritura

Las herramientas de lectura siempre están registradas; no requieren activación. Los ids numéricos y los Message-IDs RFC son intercambiables donde se acepte un identifier.

Paginación y recuento — todas las herramientas de listado y búsqueda (mail_search/mail_list, contacts_list/contacts_search, calendar_events_search, tasks_list, notes_list) aceptan offset (omitir los primeros N; combínelo con limit para paginar — offset:20, limit:20 = resultados 21–40) y count: true (devuelve { total, approx } con los mismos filtros en lugar de los elementos). Los recuentos son exactos para contactos, calendario, tareas y notas; aproximados para correo (delimite con folder/since/ until para obtener una cifra exacta — indicado mediante approx).

Resultados ligeros y resumen — mail_search y mail_list devuelven filas ligeras por defecto: id, fecha, de/para, asunto, leído/marcado — lo suficiente para elegir un mensaje sin recuperar de más. Añada snippet: true para obtener un resumen en texto plano de ~200 caracteres por resultado (limpio de marcas de cita y de ruido de separadores, de modo que un resumen de una línea no necesita ningún mail_get posterior), o verbose: true para los metadatos de enrutamiento completos (headerMessageId, folderLabel, accountName, conversationId). Cualquier otra cosa está a un mail_get por id de distancia.

Las herramientas de escritura solo se registran cuando ATBRIDGE_ALLOW_WRITES=1 está definido en la entrada env del servidor MCP, de modo que un agente no puede enviar ni eliminar nada sin que usted lo active. Actívelo con atbridge mcp setup --client <id> --allow-writes, o con el interruptor Allow writes en los ajustes Connect your AI (MCP) de la extensión y, a continuación, reinicie el cliente.

Herramientas de administración — las herramientas de cuenta/sistema (facturación, dispositivos, versión, autoactualización) se registran solo cuando ATBRIDGE_ADMIN_TOOLS=1 está definido (desactivado por defecto). Casi nunca hacen falta para el trabajo diario de correo/calendario, así que dejarlas desactivadas mantiene ligera la superficie de herramientas por defecto; actívelas del mismo modo que habilita las escrituras cuando quiera que la IA compruebe su suscripción o inicie una actualización.

{
  "mcpServers": {
    "atbridge.ai": {
      "command": "atbridge",
      "args": ["mcp"],
      "env": { "ATBRIDGE_ALLOW_WRITES": "1" }
    }
  }
}

Véase también

Conectar su IA — configurar un cliente MCP (Claude Desktop, Cursor)
Referencia CLI — las mismas operaciones como comandos de terminal
Cuando la IA dice «sin herramientas»

Was this page helpful?