Integração · Ferramentas para programadores

Conecte Claude e ChatGPT ao bttn

Pergunte à sua IA quais os seus botões estão online, quantas vezes foram pressionados ou o que aconteceu hoje. Ela pode listar os botões da sua conta, ler detalhes e status, contar pressões por tipo de evento e percorrer o feed de eventos. Receba respostas sobre os seus botões sem abrir o painel.

Ligar bttn gratuitamente

Plano gratuito, sem cartão de crédito. Demora cerca de um minuto.

Experimente pedir

“Quais são os meus botões na minha conta?”
A IA lista os seus botões com IDs e nomes, para que possa usar o ID correto na próxima pergunta.
“O botão de recepção está online e como está a bateria?”
Ela encontra o botão na sua lista e lê o seu estado atual, como se está online ou o estado da bateria/ligação.
“Quantas vezes foi pressionado o botão do salão de reuniões?”
Lê o contador de pressões para aquele botão. Pode contar apenas certos tipos de evento, como pressões longas.

O que a sua IA pode fazer

Os seus botões

Liste os botões da sua conta e leia o nome, endereço e configurações de um ou vários de uma vez.

Status

Verifique se um botão está online e veja a bateria ou estado de conexão.

Pressões e eventos

Conte pressões por tipo de evento ou até um ponto temporal, e navegue pelo feed de eventos de cada botão.

“Mostre os últimos 20 eventos do botão da cozinha.”
Lista o feed de eventos mais recentes: pressões, solicitações enviadas e respostas recebidas.
“Quantas pressões houve no botão 1234 antes do início deste mês?”
Conta as pressões para o botão até a um ponto temporal que você fornece, usando um timestamp Unix.
“Dê-me os nomes, endereços e configurações dos meus dois botões de armazém.”
Lê os detalhes de ambos os botões em uma única chamada, por ID ou endereço.

12 ferramentas para bttn

Estas ferramentas são ativadas quando estabelece a ligação. Pode desativar qualquer uma delas ou exigir a sua aprovação antes de ser executada.

create_hookAltera dadosCrie um novo hook. Obrigatório: url. Resumo da API: Registre a URL do webhook do bttn.
create_unhookAltera dadosCrie um novo unhook. Obrigatório: url. Resumo da API: Método conveniente para desregistrar a URL do webhook do bttn.
delete_hooksMovimenta dinheiroDele permanentemente um hook pelo ID x 2014 06 id. Ação financeira ou irreversível; pode exigir aprovação. Resumo da API: Desregistre a URL do webhook do bttn.
get_bttn_infoObtenha os detalhes de um ou mais botões (nome, endereço, configurações) por ID ou endereço do bttn; passe vários como uma lista separada por vírgula.
get_bttn_statusObtenha o status atual de um bttn por seu ID ou endereço, como se ele esteja online e seu estado de bateria ou conexão.
get_press_countObtenha quantas vezes um bttn foi pressionado, por ID do bttn. Opcionalmente conte apenas certos tipos de eventos em `filter` (pressed, pressed-long, not-pressed) ou apenas eventos antes de uma marca de tempo Unix em `before`.
list_bttnsListe os botões (botões inteligentes) na sua conta, com seus IDs e nomes. Use isso primeiro para encontrar o ID do bttn para as outras ferramentas; `filter` opcionalmente restringe a lista.
list_hooksListe os hooks. Resumo da API: Obtenha a URL do webhook do bttn.
list_indicesListe os índices. Resumo da API: Índice da API.
list_press_eventsListe o feed de eventos de um bttn (pressões, solicitações enviadas, respostas recebidas) por ID do bttn, mais recentes primeiro. Filtre por tipos de evento em `filter`, limite com `limit` e pague com `cursor` ou `before` (marca de tempo Unix).
list_versionsListe as versões. Resumo da API: Versão da API.
update_callbackAltera dadosAtualize um callback existente identificado pelo ID do callback. Resumo da API: Envie o resultado de um callback HTTP.

Configure em três passos

1
Escolha a aplicação
Crie uma conta gratuita no PipMCP e escolha bttn na lista de aplicações.
2
Cole a sua chave
Cole uma chave API do botão. Faça login no my.bt.tn, clique no seu nome no canto superior direito e escolha Configurações da Conta. No final, sob 'Gerar uma Chave API para acesso REST API', clique em Gerar, dê um nome à chave e copie-a.
3
Adicione a ligação à sua IA
Receberá uma ligação MCP pessoal. Adicione-a ao Claude, ao ChatGPT ou ao Cursor:
1. Clique no seu nome e depois em Definições › Conectores › Adicionar conector personalizado.
2. Cole a sua ligação no campo URL do servidor MCP remoto.
3. Ative-o no menu + de uma conversa.

Perguntas

O que a IA pode fazer no bttn?

A IA pode listar os botões da sua conta, ler detalhes e status atuais, contar quantas vezes um botão foi pressionado e ler o seu feed de eventos. Todas as ferramentas apenas leem dados. A IA não pode alterar os seus botões ou suas configurações.

A IA vê a minha chave API do botão?

Não. A sua chave API do botão está criptografada em repouso e nunca é mostrada à IA. Após você salvá-la, ela não é mostrada novamente, nem mesmo para você. A IA apenas vê os resultados das ferramentas que chama.

Posso controlar o que a IA é autorizada a fazer?

Sim. Você escolhe quais ferramentas estão ativadas, por exemplo apenas verificações de status sem o feed de eventos. Ações consideradas sensíveis podem exigir sua aprovação antes de rodar, e todas as chamadas de ferramenta são registradas.

Funciona com o ChatGPT?

Sim. No ChatGPT, vá em Configurações › Aplicações & Conectores › Avançado e ative o Modo Desenvolvedor, depois adicione seu link do PipMCP. O Modo Desenvolvedor requer um plano pago do ChatGPT: Plus, Pro, Business ou Enterprise. O mesmo link funciona também no Claude (Configurações › Conectores › Adicionar conector personalizado), Cursor e outros clientes MCP.

Qual é o custo?

O PipMCP tem um plano gratuito sem necessidade de cartão de crédito. Planos pagos cobram por tarefa concluída. Você também precisa de uma conta própria do bttn.

Como a IA sabe qual botão eu quero?

As outras ferramentas precisam de um ID ou endereço do bttn. Ao nomear um botão, a IA primeiro lista os botões na sua conta, encontra o que corresponde e usa seu ID. Você também pode fornecer o ID ou o endereço diretamente.