Brug AttendBeacon med din AI-assistent

#Hvad det er

Model Context Protocol (MCP) er den måde, AI-assistenter bruger andre programmers værktøjer på. AttendBeacons MCP-server lader en assistent læse dine events og, når du tillader det, foretage nogle få sikre ændringer, med de samme nøgler, scopes, grænser og den samme log som REST API'et.

Adressen: https://attendbeacon.com/mcp (Streamable HTTP)

Når forbindelsen er oprettet, kan du spørge med dine egne ord:

• „Hvordan sælger Beacon Summit i forhold til sidste uge, og hvornår er vi udsolgt i dette tempo?“
• „Hvem fra Contoso kommer, og er de tjekket ind?“
• „Hvad foregår der i Main Hall torsdag eftermiddag?“
• „Hvilke oplægsholdere har skaffet flest billetter med deres delingslinks?“
• „Tilføj en session på 30 minutter, 'Lightning talks', i Room 2 den 13. november kl. 14.00.“ (spørger, før den ændrer noget)

#To måder at forbinde på

Log ind (Claudes custom connectors, ChatGPT, Copilot Studio med OAuth): assistenten sender dig til AttendBeacon, du logger ind som dig selv, vælger arbejdsområdet og hvad assistenten må, og giver tilladelse. AttendBeacon opretter en nøgle til den assistent, som du kan se og tilbagekalde under Integrationer › API & MCP.

En nøgle (Claude Code, VS Code, Copilot Studio med en API-nøgle og enhver anden klient): opret en nøgle under Integrationer › API & MCP med AI-assistent (kun læsning) som udgangspunkt, og giv den til klienten som Authorization: Bearer abk_... eller som X-Api-Key.

Uanset hvad kan en assistent ikke gøre mere, end nøglens scopes tillader. Start med kun læsning; tilføj kun et skrive-scope (fx tickets:write til rabatkoder) til det, du vil have den til at gøre.

#Claude

Claude på nettet og Claude Desktop (custom connector):

1. Åbn Settings › Connectors, og vælg Add custom connector. (I en Team- eller Enterprise-plan tilføjer en ejer den først under Organization settings › Connectors.)
2. Kald den AttendBeacon, og angiv adressen https://attendbeacon.com/mcp. Lad de avancerede indstillinger være tomme.
3. Vælg Connect, log ind på AttendBeacon, vælg arbejdsområdet og dine scopes, og giv tilladelse.
4. Slå AttendBeacon til i værktøjsmenuen i en chat, og spørg løs.

Claude Code, med en nøgle:

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

Eller tilføj den uden headeren, og kør /mcp i Claude Code for i stedet at logge ind.

#ChatGPT

1. Åbn Settings › Apps & Connectors i ChatGPT, og slå Developer mode til under Advanced settings (din plan og administratoren af dit workspace skal tillade custom connectors).
2. Vælg Create, kald den AttendBeacon, angiv MCP-serveradressen https://attendbeacon.com/mcp og OAuth som godkendelse.
3. Log ind på AttendBeacon, vælg arbejdsområdet og dine scopes, og giv tilladelse.
4. Tilføj AttendBeacon fra værktøjsmenuen i en chat.

ChatGPT viser en bekræftelse før hvert værktøj, der ændrer data.

#VS Code og GitHub Copilot

Tilføj serveren til .vscode/mcp.json i dit projekt (eller til dine brugerindstillinger). VS Code beder om nøglen én gang og gemmer den i sit lager til hemmeligheder:

{
  "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}" }
    }
  }
}

Åbn Copilot Chat i Agent-tilstand; AttendBeacons værktøjer ligger under værktøjsknappen.

#Copilot Studio

1. Åbn Tools › Add a tool › New tool › Model Context Protocol i din agent.
2. Angiv servernavnet AttendBeacon, en beskrivelse („Læser og opdaterer vores AttendBeacon-events“) og server-URL'en https://attendbeacon.com/mcp.
3. Vælg API key som godkendelse, type Header, headernavn X-Api-Key. (Eller OAuth 2.0 med dynamic discovery for i stedet at logge ind.)
4. Opret forbindelsen med din nøgle, og føj værktøjerne til agenten.

#Andre klienter

Cursor, Windsurf, Gemini CLI og enhver klient, der taler Streamable HTTP, forbinder på samme måde: adressen og nøglen som header, eller login, hvor klienten understøtter OAuth.

#Værktøjerne

Alle værktøjer svarer med kompakt JSON i én tekstblok, og listerne svarer med en side og nextCursor til at bede om mere. Tidspunkter kommer i UTC og i stedets lokale tid, beløb i eventets valuta.

Værktøjer, der ændrer data, skriver CHANGES DATA først i deres beskrivelse og er markeret som ikke-skrivebeskyttede, så assistenter spørger dig, før de kalder dem. Ingen af dem sletter noget: et event oprettes som kladde, en kapacitet sættes aldrig under det solgte, og en indtjekning følger indgangens regler.

#Det, du ser i arbejdsområdet

• Integrationer › API & MCP › Nøglernes aktivitet viser hvert værktøjskald, med mcp som kanal og værktøjets navn, også de afviste og hvorfor.
• Ændringer vises i arbejdsområdets aktivitetslog som "API key abk_... (name) via MCP".
• Tilbagekald nøglen eller den forbundne app, så stopper assistenten med det samme.

#Når noget afvises

Værktøjet svarer med en fejl, hvis tekst starter med API'ets kode, så assistenten kan fortælle dig, hvad du skal gøre:

• missingScope: nøglen mangler et scope; opret en nøgle med det.
• peopleScope: spørgsmålet handler om personer ved navn; nøglen skal have Personoplysninger.
• moduleOff: arrangøren har slået den funktion fra for eventet.
• rateLimited: mere end 120 kald i minuttet, delt med REST API'et.

#For de nysgerrige

Serveren er bygget på det officielle C# SDK, over Streamable HTTP og stateless: hver forespørgsel står alene, så enhver af AttendBeacons servere kan besvare den. Den tilbyder værktøjer og tre prompts (event_briefing, door_status, sales_update); den beder ikke klienten om noget til gengæld. Login er OAuth 2.1 med PKCE og dynamisk klientregistrering, som MCP's autorisationsspecifikation beskriver, annonceret på /.well-known/oauth-protected-resource.