AttendBeacon tekoälyavustajan kanssa

#Mikä se on

Model Context Protocol (MCP) on tapa, jolla tekoälyavustajat käyttävät muiden ohjelmistojen työkaluja. AttendBeaconin MCP-palvelimen avulla avustaja voi lukea tapahtumiasi ja, jos sallit, tehdä muutamia turvallisia muutoksia. Se käyttää samoja avaimia, käyttöoikeuksia, rajoja ja lokia kuin REST API.

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

Kun yhteys on muodostettu, kysy omin sanoin:

• "Miten Beacon Summitin myynti sujuu viime viikkoon verrattuna, ja milloin liput loppuvat tällä tahdilla?"
• "Ketkä Contosolta ovat tulossa, ja ovatko he jo saapuneet?"
• "Mitä Main Hallissa on torstai-iltapäivänä?"
• "Ketkä puhujat toivat eniten lippuja jakolinkeillään?"
• "Lisää 30 minuutin ohjelmaosuus 'Lightning talks' Room 2:een 13. marraskuuta klo 14.00." (kysyy ennen kuin muuttaa mitään)

#Kaksi tapaa yhdistää

Kirjautuminen (Clauden mukautetut liittimet, ChatGPT, Copilot Studio OAuthilla): avustaja ohjaa sinut AttendBeaconiin, kirjaudut omana itsenäsi, valitset työtilan ja sen, mitä avustaja saa tehdä, ja annat luvan. AttendBeacon luo avustajalle avaimen, jonka näet ja voit peruuttaa kohdassa Integraatiot › API & MCP.

Avain (Claude Code, VS Code, Copilot Studio API-avaimella ja mikä tahansa muu asiakasohjelma): luo avain kohdassa Integraatiot › API & MCP pohjalla Tekoälyavustaja (vain luku) ja anna se asiakasohjelmalle muodossa Authorization: Bearer abk_... tai X-Api-Key.

Kummassakin tapauksessa avustaja voi tehdä vain sen, minkä sen avaimen käyttöoikeudet sallivat. Aloita pelkällä lukuoikeudella; lisää kirjoitusoikeus (kuten tickets:write alennuskoodeja varten) vain siihen, mitä haluat sen tekevän.

#Claude

Claude verkossa ja Claude Desktop (mukautettu liitin):

1. Avaa Settings › Connectors ja valitse Add custom connector. (Team- tai Enterprise-tilauksessa omistaja lisää sen ensin kohdassa Organization settings › Connectors.)
2. Anna nimeksi AttendBeacon ja osoitteeksi https://attendbeacon.com/mcp. Jätä lisäasetukset tyhjiksi.
3. Valitse Connect, kirjaudu AttendBeaconiin, valitse työtila ja käyttöoikeudet ja anna lupa.
4. Kytke keskustelussa AttendBeacon päälle työkaluvalikosta ja kysy.

Claude Code avaimella:

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

Voit myös lisätä sen ilman otsaketta ja kirjautua suorittamalla Claude Codessa komennon /mcp.

#ChatGPT

1. Avaa ChatGPT:ssä Settings › Apps & Connectors ja kytke kohdassa Advanced settings päälle Developer mode (tilauksesi ja työtilasi ylläpitäjän on sallittava mukautetut liittimet).
2. Valitse Create, anna nimeksi AttendBeacon, MCP-palvelimen osoitteeksi https://attendbeacon.com/mcp ja tunnistautumiseksi OAuth.
3. Kirjaudu AttendBeaconiin, valitse työtila ja käyttöoikeudet ja anna lupa.
4. Lisää keskustelussa AttendBeacon työkaluvalikosta.

ChatGPT pyytää vahvistuksen ennen jokaista työkalua, joka muuttaa tietoja.

#VS Code ja GitHub Copilot

Lisää palvelin projektisi tiedostoon .vscode/mcp.json (tai käyttäjäasetuksiisi). VS Code kysyy avainta kerran ja säilyttää sen salaisuuksien säilössään:

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

Avaa Copilot Chat Agent-tilassa; AttendBeaconin työkalut löytyvät työkalupainikkeen alta.

#Copilot Studio

1. Avaa agentissasi Tools › Add a tool › New tool › Model Context Protocol.
2. Anna palvelimen nimeksi AttendBeacon, kuvaus ("Lukee ja päivittää AttendBeacon-tapahtumiamme") ja palvelimen URL-osoitteeksi https://attendbeacon.com/mcp.
3. Valitse tunnistautumiseksi API key, tyypiksi Header ja otsakkeen nimeksi X-Api-Key. (Tai OAuth 2.0 dynaamisella löydöllä, jos haluat kirjautua.)
4. Luo yhteys avaimellasi ja lisää työkalut agenttiin.

#Muut asiakasohjelmat

Cursor, Windsurf, Gemini CLI ja mikä tahansa Streamable HTTP:tä tukeva asiakasohjelma yhdistetään samalla tavalla: osoite ja avain otsakkeena, tai kirjautuminen, jos asiakasohjelma tukee OAuthia.

#Työkalut

Jokainen työkalu vastaa tiiviillä JSONilla yhdessä tekstilohkossa, ja luettelot vastaavat sivun kerrallaan sekä nextCursor-arvon lisätietojen pyytämiseen. Ajat ilmoitetaan UTC-aikana ja tapahtumapaikan paikallisena aikana, rahamäärät tapahtuman valuutassa.

Tietoja muuttavien työkalujen kuvaus alkaa sanoilla CHANGES DATA, ja ne on merkitty muiksi kuin vain luku -työkaluiksi, joten avustajat kysyvät sinulta ennen kuin kutsuvat niitä. Mikään niistä ei poista mitään: tapahtuma luodaan luonnoksena, paikkamäärää ei koskaan aseteta alle myydyn ja sisäänkirjaus noudattaa oven sääntöjä.

#Mitä näet työtilassa

• Integraatiot › API & MCP › Avainten käyttöloki luettelee jokaisen työkalukutsun kanavana mcp ja työkalun nimellä, myös hylätyt ja niiden syyt.
• Muutokset näkyvät työtilan toimintalokissa muodossa "API key abk_... (nimi) via MCP".
• Peruuta avain tai yhdistetty sovellus, niin avustaja pysähtyy heti.

#Kun jotain hylätään

Työkalu vastaa virheellä, jonka teksti alkaa rajapinnan koodilla, joten avustaja osaa kertoa, mitä tehdä:

• missingScope: avaimelta puuttuu käyttöoikeus; luo avain, jolla se on.
• peopleScope: kysymys koskee ihmisiä nimeltä; avain tarvitsee Henkilötiedot-oikeuden.
• moduleOff: järjestäjä on kytkenyt toiminnon pois tapahtumalta.
• rateLimited: yli 120 kutsua minuutissa, yhteinen REST API:n kanssa.

#Uteliaille

Palvelin on rakennettu virallisella C#-SDK:lla, se toimii Streamable HTTP:n yli ja on tilaton: jokainen pyyntö on itsenäinen, joten mikä tahansa AttendBeaconin palvelimista voi vastata siihen. Se tarjoaa työkaluja ja kolme kehotetta (event_briefing, door_status, sales_update); asiakasohjelmalta se ei pyydä mitään. Kirjautuminen on OAuth 2.1 PKCE:llä ja dynaamisella asiakasrekisteröinnillä MCP:n valtuutusmäärityksen mukaisesti, ja se ilmoitetaan osoitteessa /.well-known/oauth-protected-resource.