AttendBeacon w twoim asystencie AI

#Co to jest

Model Context Protocol (MCP) to sposób, w jaki asystenci AI korzystają z narzędzi innego oprogramowania. Serwer MCP AttendBeacon pozwala asystentowi odczytywać twoje wydarzenia, a jeśli na to pozwolisz, wprowadzać kilka bezpiecznych zmian – z tymi samymi kluczami, uprawnieniami, limitami i dziennikiem co REST API.

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

Po połączeniu pytaj własnymi słowami:

• „Jak sprzedaje się Beacon Summit w porównaniu z zeszłym tygodniem i kiedy przy tym tempie wyprzedamy bilety?”
• „Kto przyjeżdża z Contoso i czy już przeszli check-in?”
• „Co dzieje się w Main Hall w czwartek po południu?”
• „Którzy prelegenci sprzedali najwięcej biletów przez swoje linki do udostępniania?”
• „Dodaj 30-minutową sesję »Lightning talks« w Room 2, 13 listopada o 14:00.” (zapyta, zanim cokolwiek zmieni)

#Dwa sposoby połączenia

Logowanie (niestandardowe łączniki Claude, ChatGPT, Copilot Studio z OAuth): asystent przekierowuje cię do AttendBeacon, logujesz się na własne konto, wybierasz przestrzeń roboczą i to, co asystent może robić, a potem udzielasz zgody. AttendBeacon tworzy dla tego asystenta klucz, który widzisz i możesz unieważnić w sekcji Integracje › API & MCP.

Klucz (Claude Code, VS Code, Copilot Studio z kluczem API i każdy inny klient): utwórz klucz w sekcji Integracje › API & MCP, zaczynając od Asystent AI (tylko odczyt), i przekaż go klientowi jako Authorization: Bearer abk_... lub jako X-Api-Key.

W obu przypadkach asystent może zrobić tylko to, na co pozwalają uprawnienia jego klucza. Zacznij od samego odczytu. Uprawnienie do zapisu (np. tickets:write dla kodów rabatowych) dodaj tylko do tego, co asystent ma rzeczywiście robić.

#Claude

Claude w przeglądarce i Claude Desktop (niestandardowy łącznik):

1. Otwórz Settings › Connectors (Ustawienia › Łączniki) i wybierz Add custom connector. (W planie Team lub Enterprise właściciel musi go najpierw dodać w Organization settings › Connectors).
2. Nazwij go AttendBeacon i podaj adres https://attendbeacon.com/mcp. Ustawienia zaawansowane pozostaw puste.
3. Wybierz Connect, zaloguj się do AttendBeacon, wybierz przestrzeń roboczą i uprawnienia, a następnie udziel zgody.
4. W czacie włącz AttendBeacon w menu narzędzi i zadaj pytanie.

Claude Code, z kluczem:

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

Możesz też dodać go bez nagłówka i zamiast tego zalogować się, uruchamiając /mcp w Claude Code.

#ChatGPT

1. W ChatGPT otwórz Settings › Apps & Connectors i w sekcji Advanced settings włącz Developer mode (twój plan i administrator przestrzeni roboczej muszą zezwalać na niestandardowe łączniki).
2. Wybierz Create, nazwij łącznik AttendBeacon, podaj adres serwera MCP https://attendbeacon.com/mcp i jako uwierzytelnianie wybierz OAuth.
3. Zaloguj się do AttendBeacon, wybierz przestrzeń roboczą i uprawnienia, a następnie udziel zgody.
4. W czacie dodaj AttendBeacon z menu narzędzi.

Przed każdym narzędziem, które zmienia dane, ChatGPT prosi o potwierdzenie.

#VS Code i GitHub Copilot

Dodaj serwer do pliku .vscode/mcp.json w projekcie (lub do ustawień użytkownika). VS Code raz poprosi o klucz i zapisze go w swoim magazynie sekretów:

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

Otwórz Copilot Chat w trybie Agent. Narzędzia AttendBeacon znajdziesz pod przyciskiem narzędzi.

#Copilot Studio

1. W swoim agencie otwórz Tools › Add a tool › New tool › Model Context Protocol.
2. Podaj nazwę serwera AttendBeacon, opis („Odczytuje i aktualizuje nasze wydarzenia w AttendBeacon”) oraz adres URL serwera https://attendbeacon.com/mcp.
3. Jako uwierzytelnianie wybierz API key, typ Header, nazwę nagłówka X-Api-Key. (Albo OAuth 2.0 z dynamicznym wykrywaniem, aby zamiast tego się logować).
4. Utwórz połączenie ze swoim kluczem i dodaj narzędzia do agenta.

#Inni klienci

Cursor, Windsurf, Gemini CLI i każdy klient obsługujący Streamable HTTP łączą się tak samo: adres i klucz w nagłówku albo logowanie, jeśli klient obsługuje OAuth.

#Narzędzia

Każde narzędzie zwraca zwięzły JSON w jednym bloku tekstu, a listy zwracają stronę z nextCursor do pobrania kolejnej. Czasy są podawane w UTC i w czasie lokalnym miejsca wydarzenia, kwoty w walucie wydarzenia.

Narzędzia, które zmieniają dane, zaczynają opis od CHANGES DATA i są oznaczone jako nie tylko do odczytu, więc asystenci pytają cię przed ich wywołaniem. Żadne z nich niczego nie usuwa: wydarzenie powstaje jako szkic, limit miejsc nigdy nie spada poniżej liczby sprzedanych, a check-in przestrzega zasad danego wejścia.

#Co widzisz w przestrzeni roboczej

• Integracje › API & MCP › Aktywność kluczy pokazuje każde wywołanie narzędzia z kanałem mcp i nazwą narzędzia, łącznie z odrzuconymi i powodem odmowy.
• Zmiany pojawiają się w dzienniku aktywności przestrzeni roboczej jako „API key abk_... (nazwa) via MCP”.
• Unieważnij klucz lub połączoną aplikację, a asystent natychmiast przestanie działać.

#Gdy coś zostanie odrzucone

Narzędzie zwraca błąd, którego tekst zaczyna się od kodu API, dzięki czemu asystent może ci powiedzieć, co zrobić:

• missingScope: kluczowi brakuje uprawnienia. Utwórz klucz, który je ma.
• peopleScope: pytanie dotyczy osób z imienia i nazwiska. Klucz potrzebuje uprawnienia Dane osobowe.
• moduleOff: organizator wyłączył tę funkcję dla wydarzenia.
• rateLimited: ponad 120 wywołań na minutę, łącznie z REST API.

#Dla dociekliwych

Serwer działa na oficjalnym SDK dla C#, przez Streamable HTTP, bezstanowo: każde żądanie jest niezależne, więc może je obsłużyć dowolny serwer AttendBeacon. Udostępnia narzędzia i trzy prompty (event_briefing, door_status, sales_update), a od klienta niczego nie żąda. Logowanie to OAuth 2.1 z PKCE i dynamiczną rejestracją klienta, zgodnie ze specyfikacją autoryzacji MCP, ogłaszane pod adresem /.well-known/oauth-protected-resource.