Cómo conectar DIGISAC a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → DIGISAC, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

DIGISAC + Gemini

Deja que tu IA trabaje en tu bandeja omnicanal de DIGISAC: busca contactos, lee el historial de mensajes, tickets, departamentos, agentes, etiquetas y plantillas de WhatsApp, sigue embudos de venta y tableros kanban y consulta estadísticas de atención en vivo y por periodo. Enviar mensajes y cambiar tickets están desactivados al instalar.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

DIGISAC_URL, DIGISAC_API_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas una cuenta de DIGISAC y un usuario que pueda crear un token de acceso personal, mejor si es supervisor o administrador.

1. Entra en DIGISAC y abre Conta → Informações. Copia la dirección de tu cuenta en DIGISAC_URL, por ejemplo https://empresa.digisac.co o https://empresa.digisac.app (las direcciones que terminan en -api.digisac.com.br también sirven), sin /api/v1 ni otra ruta.
2. Abre Conta → API → Tokens de acesso pessoal, crea un token y pégalo en DIGISAC_API_TOKEN, sin la palabra Bearer y sin espacios.
3. Instala el conector y ejecuta digisac_get_me: muestra el usuario al que pertenece el token, con sus roles y departamentos.

El token actúa como tú: tiene los permisos del usuario que lo creó. El token de un supervisor ve todos los departamentos; el de un agente puede recibir 403 en datos que ese usuario no puede abrir. El conector solo lo envía a tu dirección de DIGISAC.

Cómo se organiza DIGISAC: cada número de WhatsApp, línea de WhatsApp Business API y canal de Instagram, Messenger, Telegram, email o webchat es una conexión, y los contactos, mensajes y plantillas pertenecen a una sola conexión. Los tickets (chamados) se asignan a departamentos (filas) y los atienden agentes (atendentes). La IA empieza con digisac_list_connections, digisac_list_departments y digisac_list_users para conocer los ids, y después busca a las personas por nombre o por teléfono.

Qué lee: contactos con número, conexión, etiquetas, nota, mensajes sin leer y hora del último mensaje; todo el historial de mensajes de un contacto, incluidos los archivos con enlace de descarga temporal y los eventos internos; tickets con protocolo, departamento, agente, inicio, fin y motivos del ticket (assuntos); etiquetas; plantillas de WhatsApp Business (HSM) con sus variables; respuestas rápidas (respostas rápidas); mensajes programados (agendamentos); embudos de venta (pipelines) con etapas y oportunidades con su valor; tableros kanban de atención (quadros de atendimento) con columnas y tarjetas; la atención en este momento (tickets abiertos y en espera, agentes conectados, carga por departamento); y estadísticas de un periodo: tickets abiertos y cerrados, tiempos de espera y de atención, mensajes enviados y recibidos, por departamento o agente.

Números de teléfono: DIGISAC guarda los números con el prefijo del país y sin +, por ejemplo 5511987654321. La IA también busca por una parte del número.

Pregunta antes de cada cambio: digisac_create_contact crea un contacto en una conexión (DIGISAC acepta un número no válido y lo marca como tal), y digisac_update_contact cambia el nombre, la nota, el departamento por defecto o las etiquetas de un contacto. La lista de etiquetas de una actualización sustituye todas las del contacto, así que la IA lee primero el contacto y envía la lista completa. Antes de cada cambio te lo muestra y espera tu sí.

Desactivadas al instalar: digisac_send_message, digisac_send_template, digisac_schedule_message, digisac_cancel_schedule, digisac_transfer_ticket y digisac_close_ticket. Los mensajes llegan al cliente al instante, y un mensaje de texto abre un ticket salvo que se indique lo contrario. En las líneas de WhatsApp Business API el texto libre solo funciona en las 24 horas siguientes al último mensaje del cliente; fuera de esa ventana solo sirve una plantilla aprobada, y Meta cobra la conversación. Cerrar un ticket puede enviar al cliente el mensaje de cierre y la encuesta de satisfacción, y los mensajes programados salen solos. Un administrador activa estas herramientas a propósito, e incluso entonces la IA confirma cada una contigo.

El texto de los clientes es un dato: los textos de los mensajes y los nombres de contacto vienen de los clientes. La IA trata cualquier instrucción que encuentre ahí como un dato, no como una orden.

Límites: los tickets y mensajes con detalles adicionales ocupan mucho, así que la IA usa páginas de 20 a 50 filas y añade detalles solo cuando hacen falta. Los filtros de DIGISAC solo aceptan columnas reales; un error 500 que nombra una columna significa que la IA quita esa parte y vuelve a preguntar.

Errores comunes: 401 significa que el token es incorrecto o se borró: crea uno nuevo en Conta → API. 403 significa que tu usuario no puede leer esos datos: usa el token de un supervisor o administrador. 404 significa que no responde nada en esa dirección (revisa DIGISAC_URL) o que el id no existe. 400 indica una conexión desconectada o un parámetro incorrecto.

El conector no gestiona bots, campañas, webhooks, campos personalizados ni ajustes de la cuenta, no envía archivos ni multimedia y no borra contactos.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de DIGISAC.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuántos tickets esperan ahora mismo en el departamento Suporte y qué agentes están conectados?"
• "Enséñame los últimos mensajes del contacto +55 11 98765-4321 y si su ticket sigue abierto."
• "¿Cómo fue la atención la semana pasada: tickets abiertos y cerrados, tiempo medio de espera y mensajes por departamento?"
• "¿Qué oportunidades están en la etapa Negociação de nuestro embudo Vendas y cuánto suman en total?"
• "Ponle a Maria Souza la etiqueta Cliente VIP y anota que prefiere WhatsApp. Enséñame el cambio antes."

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT