Conectores

Un conector es una cuenta externa que el agente puede usar en tu nombre. Se conecta una vez por persona y lo usan todos tus agentes.

Cómo funciona

• La cuenta conecta; cada agente recibe acceso. La llave se guarda cifrada bajo (tu usuario, proveedor). Como con las bases de datos, un agente sólo usa los conectores que le das en su ficha → Conectores (un agente nuevo nace sin ninguno). En canales de equipo lee y escribe; en canales de clientes sólo lee, salvo que lo permitas.
• Conectas una vez y sirve en todos lados. Tu conexión es de tu cuenta, no de un espacio: GitHub, Calendly, Deník, Sentry, Odoo o Drive conectados en un espacio de Teams (o en Studio) ya aparecen en tus demás espacios. Desconectar también es para todos. Lo que sí es por espacio es compartir una conexión con ese equipo.
• Actúa por quien invoca. En Teams, si @handle manda un correo desde un canal, lo manda con la cuenta de la persona que lo mencionó, no con una cuenta compartida. En un canal público (WhatsApp) los conectores personales no están disponibles.
• Desconectar revoca. Quitar un conector borra la llave y revoca el permiso en el proveedor.
• También desde la terminal: ghosty connectors ls, ghosty connectors connect shopify y ghosty connectors disconnect shopify (ver comandos del CLI).

Dónde se conectan

• Studio: el chip Conectores del chat (/c) o Conectores en la barra. Los de llave (Mercado Pago, Stripe, Notion…) se pegan en un modal ahí mismo: la llave se prueba contra el proveedor antes de guardarse y tus agentes personales (sin canales de clientes) reciben acceso solos. A los demás se lo das en su ficha → Conectores.
• Tu propio sistema (MCP): al final de la lista de Conectores en /c, Conéctalo con su URL agrega el servidor MCP de tu sistema al agente de ese chat (también pegando su URL en el buscador). Si pide OAuth, Ghosty se registra solo, te lleva a autorizar y guarda el token en la bóveda; el proxy de Ghosty lo pone y lo refresca (Bearer ${conn.token}), nunca entra a la caja. Si usa una llave fija, pégala en Token. Los conectores del catálogo que funcionan así (Mailmask) se conectan desde su tarjeta, como los demás.
• Teams: Ajustes → Integraciones del espacio, para lo que el agente usa dentro del espacio (GitHub, Calendly, Deník…). Google Drive también aparece ahí: se conecta una vez en Studio con la misma cuenta y el agente de Teams lo usa con la cuenta de quien le escribe.
• App móvil: Ajustes → Integraciones con la misma lista, vía la API de conectores.

Catálogo

Los que dicen «se conecta en Teams» se conectan en un espacio de Ghosty Teams (el chip Conectores te lleva) y sirven también en tu chat y en la app. Desde un canal de clientes (WhatsApp, Messenger) no están disponibles: son cuentas personales.

Google: sólo con agentes Claude u OpenAI

Google Drive, Calendar, Gmail y Contactos sólo funcionan con agentes Claude u OpenAI: en nuestras cuentas con esos proveedores el entrenamiento de modelos está apagado. Con DeepSeek o Gemini (incluido Ghosty Lite) aparecen bloqueados en la ficha del agente: los datos de tu cuenta de Google nunca llegan a esos modelos. Es requisito de Google (Uso Limitado de su Política de datos de usuario).

• Si cambias un agente de Claude a DeepSeek o Gemini, sus conectores de Google se pausan y regresan solos si vuelves a Claude.
• Una conversación donde el agente usó Google no se comparte con un agente DeepSeek o Gemini: ni su historial, ni la búsqueda entre conversaciones, ni las memorias que salieron de ella.

Google Drive

El agente sólo ve los archivos que tú eliges. Al conectar, Google te pide permiso para «los archivos que uses con esta app» (drive.file) y enseguida se abre el selector de Google para elegir tu lista de precios, inventario o catálogo. Nada más de tu Drive queda a su alcance.

• Qué lee: hojas de cálculo de Google (todas las pestañas), documentos de Google y archivos CSV o de texto. PDF y .xlsx todavía no.
• Tools: drive_archivos (lo que elegiste), drive_leer, hoja_agregar_fila, hoja_actualizar, documento_agregar (texto al final de un documento) y documento_reemplazar (cambia un texto exacto en todo el documento; sirve para llenar plantillas con {{marcadores}}). Las de escritura, desde un canal de clientes, sólo si tú lo permites.
• Escribir en una hoja vale desde canales de equipo (tu chat, Teams, programados). Para que un cliente (Messenger, WhatsApp) pueda anotar, por ejemplo, su pedido, marca «Puede escribir desde canales de clientes» en la ficha del agente → Conectores.
• Agregar o quitar archivos: Conectores → Google Drive → Archivos. Qué archivos ve cada agente se elige en su ficha → Conectores.
• Desde la app del teléfono (uso personal): al elegir archivos, tus agentes personales reciben acceso solos. Se quedan fuera los que atienden clientes (con WhatsApp o Messenger conectado, o con un canal de rol cliente) y los de un espacio de equipo; a esos se lo das tú en su ficha → Conectores o con ghosty agents set <id> --connect google-drive.
• Desconectar revoca el permiso en tu cuenta de Google.

Conectores por llave

Stripe, Notion, HubSpot, Slack, WooCommerce, Facturama, Facturapi, Conekta, Clip, Envia.com y Kommo (además de Mercado Pago, Skydropx y ElevenLabs) se conectan pegando la llave que te da cada servicio. El modal dice dónde sacarla.

• Tools: stripe_payment_link, stripe_payments, stripe_customers · notion_search, notion_read, notion_append · hubspot_contacts, hubspot_contact_upsert, hubspot_deals, hubspot_deal_create, hubspot_note · slack_channels, slack_post · woo_products, woo_orders, woo_stock_set · facturama_search, facturama_issue, facturama_send · kommo_leads, kommo_lead_move, kommo_note · facturapi_customers, facturapi_invoice, facturapi_invoices, facturapi_send · conekta_payment_link, conekta_orders · clip_payment_link, clip_payments · envia_quote, envia_label, envia_track.
• Desde un canal de clientes (WhatsApp, Messenger) no corre nada que liste datos de otros clientes (contactos, pedidos, cobros, bandeja). Lo que escribe (un link de pago, una nota en el CRM) sí; apágalo por canal en la ficha del agente si no lo quieres ahí.
• Conversaciones de prueba: lo que escribe se simula; no toca tu cuenta real.
• Guías bajo demanda: connector_guide le da al agente el paso a paso de un conector (hoy Facturama y Stripe: qué datos pedir, qué confirmar, errores comunes del SAT). Sólo de los conectores que tiene; no ocupa contexto hasta que la pide.

Odoo y otros conectores por credenciales

Los que no son OAuth se dan de alta con sus credenciales (URL de la instancia, usuario, llave). La URL pasa por un guard de red: sólo hosts públicos, sin IPs privadas ni localhost, para que un conector no sirva para alcanzar tu red interna desde la máquina del agente.

API

Para clientes propios (la app móvil los usa):

Requieren bearer OAuth2; ver Autenticación.

# catálogo con el estado de cada conectorcurl https://www.ghosty.studio/api/v2/me/connectors -H "Authorization: Bearer $TOKEN"
# arrancar la autorización de uno (abre la url que devuelve en el navegador)curl -X POST https://www.ghosty.studio/api/v2/me/connectors/easybits/start -H "Authorization: Bearer $TOKEN"
# desconectar (revoca en el proveedor)curl -X DELETE https://www.ghosty.studio/api/v2/me/connectors/easybits -H "Authorization: Bearer $TOKEN"