Bruk AttendBeacon med KI-assistenten din

#Hva det er

Model Context Protocol (MCP) er måten KI-assistenter bruker verktøyene til annen programvare på. AttendBeacons MCP-server lar en assistent lese arrangementene dine og, når du tillater det, gjøre noen få trygge endringer, med de samme nøklene, omfangene, grensene og den samme loggen som REST-API-et.

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

Når den er tilkoblet, spør du med dine egne ord:

• «Hvordan selger Beacon Summit sammenlignet med forrige uke, og når er vi utsolgt i dette tempoet?»
• «Hvem fra Contoso kommer, og har de sjekket inn?»
• «Hva skjer i Main Hall torsdag ettermiddag?»
• «Hvilke foredragsholdere har skaffet flest billetter med delingslenkene sine?»
• «Legg til en økt på 30 minutter, ‘Lightning talks’, i Room 2 den 13. november kl. 14.00.» (spør før den endrer noe)

#To måter å koble til på

Pålogging (Claudes egendefinerte koblinger, ChatGPT, Copilot Studio med OAuth): assistenten sender deg til AttendBeacon, du logger på som deg selv, velger arbeidsområdet og hva assistenten får gjøre, og gir tillatelse. AttendBeacon oppretter en nøkkel for den assistenten, som du ser og kan tilbakekalle under Integrasjoner › API & MCP.

En nøkkel (Claude Code, VS Code, Copilot Studio med en API-nøkkel og alle andre klienter): opprett en nøkkel under Integrasjoner › API & MCP med KI-assistent (bare lesing) som utgangspunkt, og gi den til klienten som Authorization: Bearer abk_... eller som X-Api-Key.

Uansett kan en assistent ikke gjøre mer enn nøkkelens omfang tillater. Begynn med bare lesing; legg til et omfang for endring (for eksempel tickets:write for rabattkoder) bare for det du vil at den skal gjøre.

#Claude

Claude på nettet og Claude Desktop (egendefinert kobling):

1. Åpne Settings › Connectors og velg Add custom connector. (I et Team- eller Enterprise-abonnement legger en eier den først til under Organization settings › Connectors.)
2. Gi den navnet AttendBeacon og adressen https://attendbeacon.com/mcp. La de avanserte innstillingene stå tomme.
3. Velg Connect, logg på AttendBeacon, velg arbeidsområdet og omfangene, og gi tillatelse.
4. Slå på AttendBeacon i verktøymenyen i en chat, og spør.

Claude Code, med en nøkkel:

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

Eller legg den til uten headeren, og kjør /mcp i Claude Code for å logge på i stedet.

#ChatGPT

1. Åpne Settings › Apps & Connectors i ChatGPT, og slå på Developer mode under Advanced settings (abonnementet ditt og administratoren av arbeidsområdet må tillate egendefinerte koblinger).
2. Velg Create, gi den navnet AttendBeacon, oppgi MCP-serveradressen https://attendbeacon.com/mcp og OAuth som autentisering.
3. Logg på AttendBeacon, velg arbeidsområdet og omfangene, og gi tillatelse.
4. Legg til AttendBeacon fra verktøymenyen i en chat.

ChatGPT viser en bekreftelse før hvert verktøy som endrer data.

#VS Code og GitHub Copilot

Legg til serveren i .vscode/mcp.json i prosjektet ditt (eller i brukerinnstillingene). VS Code spør etter nøkkelen én gang og oppbevarer den i hemmelighetslageret sitt:

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

Åpne Copilot Chat i Agent-modus; AttendBeacons verktøy ligger under verktøyknappen.

#Copilot Studio

1. Åpne Tools › Add a tool › New tool › Model Context Protocol i agenten din.
2. Oppgi servernavnet AttendBeacon, en beskrivelse («Leser og oppdaterer AttendBeacon-arrangementene våre») og server-URL-en https://attendbeacon.com/mcp.
3. Som autentisering velger du API key, type Header, headernavn X-Api-Key. (Eller OAuth 2.0 med dynamisk oppdagelse, for å logge på i stedet.)
4. Opprett tilkoblingen med nøkkelen din, og legg til verktøyene i agenten.

#Andre klienter

Cursor, Windsurf, Gemini CLI og alle klienter som støtter Streamable HTTP, kobler til på samme måte: adressen, og nøkkelen som header, eller pålogging der klienten støtter OAuth.

#Verktøyene

Hvert verktøy svarer med kompakt JSON i én tekstblokk, og listene svarer med en side og nextCursor for å be om mer. Tider kommer i UTC og i lokal tid på stedet, beløp i arrangementets valuta.

Verktøy som endrer data, sier CHANGES DATA først i beskrivelsen sin og er merket som ikke skrivebeskyttet, så assistenter spør deg før de kaller dem. Ingen av dem sletter noe: et arrangement opprettes som utkast, en kapasitet settes aldri under det som er solgt, og en innsjekking følger inngangens regler.

#Hva du ser i arbeidsområdet

• Integrasjoner › API & MCP › Nøklenes aktivitet viser hvert verktøykall, med mcp som kanal og verktøyets navn, også de avviste og hvorfor.
• Endringer vises i arbeidsområdets aktivitetslogg som «API key abk_... (navn) via MCP».
• Tilbakekall nøkkelen, eller den tilkoblede appen, så stopper assistenten med en gang.

#Når noe avvises

Verktøyet svarer med en feil der teksten begynner med API-ets kode, slik at assistenten kan fortelle deg hva du skal gjøre:

• missingScope: nøkkelen mangler et omfang; opprett en nøkkel med det.
• peopleScope: spørsmålet gjelder personer ved navn; nøkkelen trenger Personopplysninger.
• moduleOff: arrangøren har slått av den funksjonen for arrangementet.
• rateLimited: mer enn 120 kall i minuttet, delt med REST-API-et.

#For de nysgjerrige

Serveren er den offisielle C#-SDK-ens, over Streamable HTTP, tilstandsløs: hver forespørsel står for seg selv, så hvilken som helst av AttendBeacons servere kan svare. Den tilbyr verktøy og tre prompter (event_briefing, door_status, sales_update); den ber ikke klienten om noe tilbake. Påloggingen er OAuth 2.1 med PKCE og dynamisk klientregistrering, slik MCP-autorisasjonsspesifikasjonen beskriver, og annonseres på /.well-known/oauth-protected-resource.