concierge-mcp

Servidor MCP local para Concierge, la plataforma de atención al cliente nativa de Discord.

Conecta tu agente de IA (Claude Desktop, Cursor, Cline o cualquier cliente compatible con MCP) a tu servidor de soporte de Concierge y opera toda la infraestructura de soporte mediante lenguaje natural. Más de 200 herramientas cubren el ciclo de vida de los tickets, configuración de IA, base de conocimientos, paneles, automatizaciones, análisis, facturación, comunicación en Discord y más.

Qué puedes hacer

"Configura Concierge para mi SaaS: despliega el panel en #support, otorga acceso de agente a @Mod y @Admin, y configura el SLA a 30 minutos para tickets de alta prioridad."

"Muéstrame un informe de CSAT de los últimos 30 días y luego sugiere una respuesta para el ticket #142."

"Cierra masivamente todos los tickets de más de 7 días que no tengan respuesta del agente y envía una transcripción al cliente por mensaje directo."

"Posón el ticket #88 hasta mañana a las 9 a.m. ET y marca al cliente como VIP."

Instalación

Claude Desktop

Añádelo a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "concierge": {
      "command": "npx",
      "args": ["-y", "concierge-mcp"],
      "env": {
        "CONCIERGE_GUILD_ID": "YOUR_DISCORD_GUILD_ID",
        "CONCIERGE_MCP_KEY": "YOUR_MCP_API_KEY"
      }
    }
  }
}

Reinicia Claude Desktop. Deberías ver "concierge" en la lista de servidores MCP, con las más de 200 herramientas disponibles.

Cursor

Añádelo a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "concierge": {
      "command": "npx",
      "args": ["-y", "concierge-mcp"],
      "env": {
        "CONCIERGE_GUILD_ID": "YOUR_DISCORD_GUILD_ID",
        "CONCIERGE_MCP_KEY": "YOUR_MCP_API_KEY"
      }
    }
  }
}

Cline / otros clientes MCP

Utiliza la misma estructura de command/args/env: todos los clientes MCP admiten servidores stdio.

Obtención de tus credenciales

1. Abre tu panel de control de Concierge en conciergetickets.net/dashboard

2. Abre cualquier panel → Advanced → MCP Settings

3. Activa MCP Enabled: esto generará una clave API

4. Copia la clave API (configúrala como CONCIERGE_MCP_KEY)

5. Tu Guild ID es el ID del servidor de Discord, que se encuentra en la URL o haciendo clic derecho → Copiar ID del servidor (se requiere el modo desarrollador)

Cómo funciona

Este paquete es un proxy stdio ligero. Cuando tu cliente MCP lo inicia, hace lo siguiente:

1. Se conecta al servidor MCP de Concierge en https://api.conciergetickets.net/api/v1/guilds/{GUILD_ID}/mcp

2. Se autentica con tu clave API

3. Obtiene el catálogo de herramientas en vivo (para que las nuevas herramientas lanzadas por Concierge aparezcan automáticamente sin necesidad de reinstalar)

4. Reenvía cada llamada de herramienta al servidor remoto

El binario local es pequeño y no tiene estado. Los datos de tu servidor (guild) permanecen en la infraestructura de Concierge.

Categorías de herramientas

• Tickets: ciclo de vida completo (reclamar, posponer, reabrir, completar, transferir, bloquear, fusionar, dividir, etc.) además de operaciones masivas.

• IA: resumir tickets, analizar sentimientos, sugerir respuestas, regenerar respuestas, traducir.

• Base de conocimientos: CRUD completo + búsqueda + importación desde GitBook.

• Clientes: perfiles, notas, interruptor VIP, lista negra con caducidad opcional.

• Paneles: crear/desplegar/replegar con personalización completa de embeds.

• Configuración: cada ajuste en TicketPanel y Guild mediante update_panel_config / update_guild_config.

• Discord: enviar mensajes, mensajes directos, reaccionar, publicar anuncios, buscar canales/roles/miembros.

• Webhooks: CRUD completo + prueba, reenvío, estadísticas.

• Análisis: resumen, horas pico, tabla de clasificación de agentes, exportación CSV.

• CRM: prueba, sincronización, extracción desde Salesforce/HubSpot/Zendesk/Freshdesk.

• Disparadores Cron: ejecutar escaneo de SLA, cierre automático, verificación de escalación bajo demanda.

• Equipo: invitar, eliminar, establecer carga de trabajo/horario/estado/habilidades.

Ejecuta npx -y concierge-mcp y llama a tools/list para ver el catálogo completo en vivo.

Endpoints de descubrimiento (para integraciones que no son MCP)

• GET https://api.conciergetickets.net/api/v1/public/openapi.json: especificación completa de OpenAPI 3.1 para la API REST.

• GET https://api.conciergetickets.net/api/v1/public/schema.json: esquema de Prisma analizado (cada modelo, campo, enumeración).

Enlaces

• Concierge: https://conciergetickets.net

• Documentación: https://conciergetickets.net/docs

• Model Context Protocol: https://modelcontextprotocol.io

Licencia

MIT