MCP Servidor

como funciona

El servidor MCP reside en el punto final MCP de su cuenta. Los asistentes de IA se conectan mediante OAuth2 y luego pueden llamar a herramientas para leer datos o realizar acciones. El servidor resuelve automáticamente su equipo y los eventos activos, por lo que la mayoría de las consultas no necesitan configuración.

Autenticación

La autenticación utiliza OAuth2 a través de Laravel Passport. El cliente de IA se registra como una aplicación OAuth, lo redirecciona para autorizar el acceso y recibe un token al portador. Incluya el token en cada solicitud al servidor MCP.

Authorization: Bearer {token}

Los tokens están destinados a su equipo y caducan después de un período configurable. Revocar el acceso en cualquier momento desde la configuración de su cuenta.

Descubrimiento de contexto

Empiece siempre con get_organizer_context. Esta herramienta devuelve información de su equipo, eventos activos y elementos pendientes. Si tiene un solo equipo o un solo evento, otras herramientas se resuelven automáticamente sin necesidad de ID explícitas.

// Example response from get_organizer_context
{
  "team": { "id": "01HX...", "name": "Acme Events" },
  "active_events": [
    { "id": "01HY...", "name": "DevConf 2026", "status": "published" }
  ],
  "pending": {
    "speaker_applications": 3,
    "refund_requests": 1,
    "sponsorship_requests": 2
  }
}

Herramientas de análisis de ventas

Consulta datos de ingresos y venta de entradas para tus eventos. Todos los importes monetarios se devuelven en valores de centavos brutos (p. ej. revenue_cents) y cadenas formateadas legibles por humanos (p. ej. revenue_formatted).

Análisis de tráfico

get_traffic_channels desglosa los visitantes por canal (orgánico, social, pago, referencia, directo), fuente, campaña, tipo de dispositivo y país. Utilice esto para medir el ROI del marketing y comprender de dónde proviene su audiencia.

Herramientas de gestión de eventos

Enumere e inspeccione eventos, incluidos los borradores de eventos que solo son visibles para los organizadores.

Herramientas para asistentes

search_attendees le permite buscar por nombre o correo electrónico y filtrar por tipo de boleto o estado de check-in. get_attendee_detail devuelve el registro completo de asistentes, incluido el historial de pedidos y los registros de escaneo.

// Search for an attendee by email
search_attendees({ query: "[email protected]", checked_in: false })

// Get full details for a specific attendee
get_attendee_detail({ attendee_id: "01HZ..." })

Herramientas de revisión pendientes

Revise los elementos que necesitan su atención. Todas las herramientas admiten el filtrado de estado para mostrar solo los elementos pendientes, aprobados o rechazados.

Flujo de trabajo de creación de eventos

Crear un evento a través del servidor MCP es un proceso de tres pasos.

• Llamar search_venues con una cadena de consulta para encontrar lugares coincidentes.
• Llamar resolve_venue con un resultado seleccionado para obtener un lugar confirmado con dirección completa y coordenadas.
• Llamar create_event con el ID del lugar resuelto más los detalles de su evento (nombre, fecha, descripción, tipos de entradas).

Flujo de trabajo de importación de contactos

La importación de contactos es un proceso asincrónico de dos pasos.

Llamar import_contacts con una matriz JSON de objetos de contacto. Cada objeto acepta email, first_name, last_name, company, y title campos. El servidor responde con un estado 202 y una ID de importación.

// Start a contact import
import_contacts({
  contacts: [
    { "email": "[email protected]", "first_name": "Jane", "last_name": "Doe", "company": "Acme", "title": "CTO" },
    { "email": "[email protected]", "first_name": "Bob", "last_name": "Smith" }
  ]
})
// Returns: { "import_id": "01HZ...", "status": "pending", "count": 2 }

// Poll for completion
check_import_status({ import_id: "01HZ..." })
// Returns: { "status": "processed", "imported": 2, "skipped": 0, "errors": 0 }

Encuesta check_import_status con el ID de importación hasta que el estado sea processed o error.

Recursos e indicaciones

El servidor MCP expone recursos y plantillas de avisos prediseñadas que brindan a los asistentes de IA acceso estructurado a sus datos y flujos de trabajo de análisis listos para usar.

Clientes de IA compatibles

Cualquier cliente compatible con MCP funciona con el servidor Kagibag MCP. Claude Desktop tiene soporte integrado para MCP y es el cliente recomendado. Agregue la URL del servidor y sus credenciales OAuth a la configuración MCP de su cliente para comenzar.

{
  "mcpServers": {
    "kagibag": {
      "url": "https://your-account.kagibag.com/mcp",
      "auth": {
        "type": "oauth2",
        "client_id": "your-client-id",
        "client_secret": "your-client-secret"
      }
    }
  }
}