Använd AttendBeacon med din AI-assistent

#Vad det är

Model Context Protocol (MCP) är sättet som AI-assistenter använder andra programs verktyg på. AttendBeacons MCP-server låter en assistent läsa dina evenemang och, när du tillåter det, göra några säkra ändringar, med samma nycklar, behörigheter, gränser och logg som REST-API:t.

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

När assistenten är ansluten frågar du med egna ord:

• ”Hur säljer Beacon Summit jämfört med förra veckan, och när är vi slutsålda i den här takten?”
• ”Vilka från Contoso kommer, och har de checkat in?”
• ”Vad pågår i Main Hall på torsdag eftermiddag?”
• ”Vilka talare drog in flest biljetter med sina delningslänkar?”
• ”Lägg till en 30 minuter lång session ’Lightning talks’ i Room 2 den 13 november kl. 14.00.” (frågar innan den ändrar något)

#Två sätt att ansluta

Logga in (anpassade anslutningar i Claude, ChatGPT, Copilot Studio med OAuth): assistenten skickar dig till AttendBeacon, du loggar in som dig själv, väljer arbetsytan och vad assistenten får göra, och godkänner. AttendBeacon skapar en nyckel för den assistenten, som du ser och kan återkalla under Integrationer › API & MCP.

En nyckel (Claude Code, VS Code, Copilot Studio med en API-nyckel, och alla andra klienter): skapa en nyckel under Integrationer › API & MCP med AI-assistent (endast läsning) som utgångspunkt, och ge den till klienten som Authorization: Bearer abk_... eller som X-Api-Key.

Oavsett sätt kan en assistent inte göra mer än nyckelns behörigheter tillåter. Börja med endast läsning; lägg bara till en skrivbehörighet (till exempel tickets:write för rabattkoder) för det du vill att den ska göra.

#Claude

Claude på webben och Claude Desktop (anpassad anslutning):

1. Öppna Settings › Connectors och välj Add custom connector. (I en Team- eller Enterprise-plan lägger en ägare först till den under Organization settings › Connectors.)
2. Ge den namnet AttendBeacon och adressen https://attendbeacon.com/mcp. Lämna de avancerade inställningarna tomma.
3. Välj Connect, logga in på AttendBeacon, välj arbetsytan och behörigheterna, och godkänn.
4. Slå på AttendBeacon i verktygsmenyn i en chatt, och fråga.

Claude Code, med en nyckel:

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

Eller lägg till den utan huvudet och kör /mcp i Claude Code för att logga in i stället.

#ChatGPT

1. Öppna Settings › Apps & Connectors i ChatGPT och slå på Developer mode under Advanced settings (din plan och din ChatGPT-arbetsytas administratör måste tillåta anpassade anslutningar).
2. Välj Create, ge den namnet AttendBeacon, MCP-serverns adress https://attendbeacon.com/mcp och OAuth som autentisering.
3. Logga in på AttendBeacon, välj arbetsytan och behörigheterna, och godkänn.
4. Lägg till AttendBeacon från verktygsmenyn i en chatt.

ChatGPT visar en bekräftelse före varje verktyg som ändrar data.

#VS Code och GitHub Copilot

Lägg till servern i .vscode/mcp.json i ditt projekt (eller i dina användarinställningar). VS Code frågar efter nyckeln en gång och förvarar den i sitt hemlighetslager:

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

Öppna Copilot Chat i läget Agent; AttendBeacons verktyg finns under verktygsknappen.

#Copilot Studio

1. Öppna Tools › Add a tool › New tool › Model Context Protocol i din agent.
2. Ange servernamnet AttendBeacon, en beskrivning (”Läser och uppdaterar våra AttendBeacon-evenemang”) och server-URL:en https://attendbeacon.com/mcp.
3. Som autentisering väljer du API key, typen Header och huvudnamnet X-Api-Key. (Eller OAuth 2.0 med dynamisk identifiering, för att logga in i stället.)
4. Skapa anslutningen med din nyckel och lägg till verktygen i agenten.

#Andra klienter

Cursor, Windsurf, Gemini CLI och alla klienter som talar Streamable HTTP ansluter på samma sätt: adressen och nyckeln som ett huvud, eller inloggning där klienten stöder OAuth.

#Verktygen

Varje verktyg svarar med kompakt JSON i ett textblock, och listorna svarar med en sida och nextCursor för att be om mer. Tider anges i UTC och i lokal tid på platsen, belopp i evenemangets valuta.

Verktyg som ändrar data börjar sin beskrivning med CHANGES DATA och är markerade som inte skrivskyddade, så att assistenter frågar dig innan de anropar dem. Inget av dem raderar något: ett evenemang skapas som utkast, en kapacitet sätts aldrig under det som har sålts, och en incheckning följer entréns regler.

#Vad du ser i arbetsytan

• Integrationer › API & MCP › Nycklarnas aktivitet listar varje verktygsanrop, med mcp som kanal och verktygets namn, även de avvisade och varför.
• Ändringar syns i arbetsytans aktivitetslogg som ”API key abk_... (name) via MCP”.
• Återkalla nyckeln, eller den anslutna appen, så slutar assistenten direkt.

#När något avvisas

Verktyget svarar med ett fel vars text börjar med API:ts kod, så att assistenten kan berätta vad du ska göra:

• missingScope: nyckeln saknar en behörighet; skapa en nyckel som har den.
• peopleScope: frågan gäller personer med namn; nyckeln behöver Personuppgifter.
• moduleOff: arrangören har stängt av den funktionen för evenemanget.
• rateLimited: fler än 120 anrop i minuten, delat med REST-API:t.

#För den nyfikne

Servern bygger på det officiella C#-SDK:t, över Streamable HTTP, tillståndslöst: varje anrop står för sig självt, så vilken som helst av AttendBeacons servrar kan besvara det. Den erbjuder verktyg och tre promptar (event_briefing, door_status, sales_update); den ber inte klienten om något tillbaka. Inloggningen är OAuth 2.1 med PKCE och dynamisk klientregistrering, så som MCP:s auktoriseringsspecifikation beskriver, och annonseras på /.well-known/oauth-protected-resource.