Use a AttendBeacon com o seu assistente de IA

#O que é

O Model Context Protocol (MCP) é a forma como os assistentes de IA usam as ferramentas de outro software. O servidor MCP da AttendBeacon permite que um assistente leia os seus eventos e, quando o autorizar, faça algumas alterações seguras, com as mesmas chaves, âmbitos, limites e registo da API REST.

O endereço: https://attendbeacon.com/mcp (Streamable HTTP)

Depois de ligado, pergunte por palavras suas:

• «Como estão as vendas do Beacon Summit em comparação com a semana passada, e quando esgotamos a este ritmo?»
• «Quem da Contoso vem, e já registaram a entrada?»
• «O que há na Main Hall na quinta-feira à tarde?»
• «Que oradores trouxeram mais bilhetes com os seus links de partilha?»
• «Adicione uma sessão de 30 minutos 'Lightning talks' na Room 2 a 13 de novembro às 14:00.» (pergunta antes de alterar o que quer que seja)

#Duas formas de ligar

Iniciar sessão (conectores personalizados do Claude, ChatGPT, Copilot Studio com OAuth): o assistente envia-o para a AttendBeacon, inicia sessão com a sua conta, escolhe a área de trabalho e o que o assistente pode fazer, e autoriza. A AttendBeacon cria uma chave para esse assistente, que pode ver e revogar em Integrações › API & MCP.

Uma chave (Claude Code, VS Code, Copilot Studio com uma chave de API, e qualquer outro cliente): crie uma chave em Integrações › API & MCP, a partir de Assistente de IA (só leitura), e entregue-a ao cliente como Authorization: Bearer abk_... ou como X-Api-Key.

Em qualquer dos casos, um assistente não pode fazer mais do que os âmbitos da sua chave permitem. Comece só com leitura; adicione um âmbito de escrita (como tickets:write para códigos de desconto) apenas para o que quer que ele faça.

#Claude

Claude na web e Claude Desktop (conector personalizado):

1. Abra Settings › Connectors e escolha Add custom connector. (Num plano Team ou Enterprise, um proprietário adiciona-o primeiro em Organization settings › Connectors.)
2. Dê-lhe o nome AttendBeacon e o endereço https://attendbeacon.com/mcp. Deixe as definições avançadas em branco.
3. Escolha Connect, inicie sessão na AttendBeacon, escolha a área de trabalho e os âmbitos, e autorize.
4. Numa conversa, ative a AttendBeacon no menu de ferramentas e pergunte.

Claude Code, com uma chave:

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

Ou adicione-o sem o cabeçalho e execute /mcp no Claude Code para iniciar sessão.

#ChatGPT

1. No ChatGPT, abra Settings › Apps & Connectors e, em Advanced settings, ative Developer mode (o seu plano e o administrador da área de trabalho têm de permitir conectores personalizados).
2. Escolha Create, dê-lhe o nome AttendBeacon, indique o endereço do servidor MCP https://attendbeacon.com/mcp e OAuth como autenticação.
3. Inicie sessão na AttendBeacon, escolha a área de trabalho e os âmbitos, e autorize.
4. Numa conversa, adicione a AttendBeacon a partir do menu de ferramentas.

O ChatGPT pede confirmação antes de cada ferramenta que altera dados.

#VS Code e GitHub Copilot

Adicione o servidor a .vscode/mcp.json no seu projeto (ou às suas definições de utilizador). O VS Code pede a chave uma vez e guarda-a no seu cofre de segredos:

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

Abra o Copilot Chat no modo Agent; as ferramentas da AttendBeacon estão no botão de ferramentas.

#Copilot Studio

1. No seu agente, abra Tools › Add a tool › New tool › Model Context Protocol.
2. Indique o nome do servidor AttendBeacon, uma descrição («Lê e atualiza os nossos eventos da AttendBeacon») e o URL do servidor https://attendbeacon.com/mcp.
3. Como autenticação, escolha API key, tipo Header, nome do cabeçalho X-Api-Key. (Ou OAuth 2.0 com descoberta dinâmica, para iniciar sessão.)
4. Crie a ligação com a sua chave e adicione as ferramentas ao agente.

#Outros clientes

O Cursor, o Windsurf, o Gemini CLI e qualquer cliente que fale Streamable HTTP ligam-se da mesma forma: o endereço e a chave como cabeçalho, ou o início de sessão quando o cliente suporta OAuth.

#As ferramentas

Cada ferramenta responde com JSON compacto num único bloco de texto, e as listas respondem com uma página e nextCursor para pedir mais. As horas vêm em UTC e na hora local do evento, e os montantes na moeda do evento.

As ferramentas que alteram dados começam a descrição com CHANGES DATA e estão marcadas como não sendo só de leitura, para que os assistentes lhe perguntem antes de as chamar. Nenhuma elimina nada: um evento é criado como rascunho, uma capacidade nunca fica abaixo do que foi vendido, e um registo de entrada segue as regras da porta.

#O que vê na área de trabalho

• Integrações › API & MCP › Atividade das chaves lista cada chamada de ferramenta, com mcp como canal e o nome da ferramenta, incluindo as recusadas e o motivo.
• As alterações aparecem no registo de atividade da área de trabalho como «API key abk_... (nome) via MCP».
• Revogue a chave, ou a app ligada, e o assistente para de imediato.

#Quando algo é recusado

A ferramenta responde com um erro cujo texto começa pelo código da API, para que o assistente lhe possa dizer o que fazer:

• missingScope: falta um âmbito à chave; crie uma chave que o tenha.
• peopleScope: a pergunta é sobre pessoas pelo nome; a chave precisa de Dados pessoais.
• moduleOff: o organizador desligou essa funcionalidade para o evento.
• rateLimited: mais de 120 chamadas por minuto, partilhadas com a API REST.

#Para os curiosos

O servidor é o do SDK oficial de C#, sobre Streamable HTTP, sem estado: cada pedido é independente, por isso qualquer um dos servidores da AttendBeacon o responde. Oferece ferramentas e três prompts (event_briefing, door_status, sales_update); não pede nada de volta ao cliente. O início de sessão é OAuth 2.1 com PKCE e registo dinâmico de clientes, tal como a especificação de autorização do MCP descreve, anunciado em /.well-known/oauth-protected-resource.