Usa AttendBeacon con tu asistente de IA

#Qué es

El Model Context Protocol (MCP) es la forma en que los asistentes de IA usan las herramientas de otro software. El servidor MCP de AttendBeacon permite que un asistente lea tus eventos y, si lo permites, haga algunos cambios seguros, con las mismas claves, ámbitos, límites y registro que la API REST.

La dirección: https://attendbeacon.com/mcp (Streamable HTTP)

Una vez conectado, pregunta con tus propias palabras:

• «¿Cómo van las ventas de Beacon Summit comparadas con la semana pasada y cuándo agotaremos las entradas a este ritmo?»
• «¿Quién viene de Contoso y ya han registrado su entrada?»
• «¿Qué hay en la Main Hall el jueves por la tarde?»
• «¿Qué ponentes han vendido más entradas con sus enlaces para compartir?»
• «Añade una sesión de 30 minutos, "Lightning talks", en la Room 2 el 13 de noviembre a las 14:00.» (pregunta antes de cambiar nada)

#Dos formas de conectar

Iniciando sesión (conectores personalizados de Claude, ChatGPT, Copilot Studio con OAuth): el asistente te lleva a AttendBeacon, inicias sesión con tu cuenta, eliges el espacio de trabajo y lo que puede hacer el asistente, y das tu permiso. AttendBeacon crea una clave para ese asistente, que puedes ver y revocar en Integraciones › API & MCP.

Con una clave (Claude Code, VS Code, Copilot Studio con una clave de API y cualquier otro cliente): crea una clave en Integraciones › API & MCP, partiendo de Asistente de IA (solo lectura), y dásela al cliente como Authorization: Bearer abk_... o como X-Api-Key.

En ambos casos, un asistente no puede hacer más de lo que permiten los ámbitos de su clave. Empieza con solo lectura; añade un ámbito de escritura (como tickets:write para los códigos de descuento) solo para lo que quieras que haga.

#Claude

Claude en la web y Claude Desktop (conector personalizado):

1. Abre Settings › Connectors (Ajustes › Conectores) y elige Add custom connector. (En un plan Team o Enterprise, primero lo añade un propietario en Organization settings › Connectors.)
2. Llámalo AttendBeacon e indica la dirección https://attendbeacon.com/mcp. Deja vacía la configuración avanzada.
3. Elige Connect, inicia sesión en AttendBeacon, elige el espacio de trabajo y los ámbitos, y da tu permiso.
4. En un chat, activa AttendBeacon en el menú de herramientas y pregunta.

Claude Code, con una clave:

claude mcp add --transport http attendbeacon https://attendbeacon.com/mcp \
  --header "Authorization: Bearer $ATTENDBEACON_KEY"

O añádelo sin la cabecera y ejecuta /mcp en Claude Code para iniciar sesión en su lugar.

#ChatGPT

1. En ChatGPT, abre Settings › Apps & Connectors y, en Advanced settings, activa Developer mode (tu plan y el administrador de tu espacio de trabajo deben permitir conectores personalizados).
2. Elige Create, llámalo AttendBeacon, indica la dirección del servidor MCP https://attendbeacon.com/mcp y OAuth como autenticación.
3. Inicia sesión en AttendBeacon, elige el espacio de trabajo y los ámbitos, y da tu permiso.
4. En un chat, añade AttendBeacon desde el menú de herramientas.

ChatGPT pide confirmación antes de cada herramienta que modifica datos.

#VS Code y GitHub Copilot

Añade el servidor a .vscode/mcp.json en tu proyecto (o a tu configuración de usuario). VS Code pide la clave una vez y la guarda en su almacén de secretos:

{
  "inputs": [
    { "type": "promptString", "id": "attendbeacon-key", "description": "AttendBeacon API key", "password": true }
  ],
  "servers": {
    "attendbeacon": {
      "type": "http",
      "url": "https://attendbeacon.com/mcp",
      "headers": { "Authorization": "Bearer ${input:attendbeacon-key}" }
    }
  }
}

Abre Copilot Chat en modo Agent; las herramientas de AttendBeacon están bajo el botón de herramientas.

#Copilot Studio

1. En tu agente, abre Tools › Add a tool › New tool › Model Context Protocol.
2. Indica como nombre del servidor AttendBeacon, una descripción («Lee y actualiza nuestros eventos de AttendBeacon») y la URL del servidor https://attendbeacon.com/mcp.
3. Como autenticación, elige API key, tipo Header, nombre de cabecera X-Api-Key. (O OAuth 2.0 con detección dinámica, para iniciar sesión en su lugar.)
4. Crea la conexión con tu clave y añade las herramientas al agente.

#Otros clientes

Cursor, Windsurf, Gemini CLI y cualquier cliente que hable Streamable HTTP se conectan igual: la dirección y la clave como cabecera, o el inicio de sesión si el cliente admite OAuth.

#Las herramientas

Cada herramienta responde con JSON compacto en un único bloque de texto, y las listas responden con una página y nextCursor para pedir más. Las horas llegan en UTC y en la hora local del recinto, y los importes en la moneda del evento.

Las herramientas que modifican datos empiezan su descripción con CHANGES DATA y están marcadas como no de solo lectura, así que los asistentes te preguntan antes de llamarlas. Ninguna elimina nada: un evento se crea como borrador, un aforo nunca se fija por debajo de lo vendido y un registro de entrada sigue las reglas de la puerta.

#Qué ves en el espacio de trabajo

• Integraciones › API & MCP › Actividad de las claves muestra cada llamada a una herramienta, con mcp como canal y el nombre de la herramienta, incluidas las rechazadas y el motivo.
• Los cambios aparecen en el registro de actividad del espacio de trabajo como «API key abk_... (nombre) via MCP».
• Revoca la clave, o la app conectada, y el asistente se detiene de inmediato.

#Cuando algo se rechaza

La herramienta responde con un error cuyo texto empieza por el código de la API, para que el asistente pueda decirte qué hacer:

• missingScope: a la clave le falta un ámbito; crea una clave que lo tenga.
• peopleScope: la pregunta es sobre personas por su nombre; la clave necesita Datos personales.
• moduleOff: el organizador ha desactivado esa función en el evento.
• rateLimited: más de 120 llamadas por minuto, compartidas con la API REST.

#Para curiosos

El servidor es el del SDK oficial de C#, sobre Streamable HTTP y sin estado: cada solicitud es independiente, así que cualquiera de los servidores de AttendBeacon puede responderla. Ofrece herramientas y tres prompts (event_briefing, door_status, sales_update); no le pide nada de vuelta al cliente. El inicio de sesión es OAuth 2.1 con PKCE y registro dinámico de clientes, tal como describe la especificación de autorización de MCP, anunciado en /.well-known/oauth-protected-resource.