💜">
BTS Troca
Desenvolvedores · Agentes de IA

Conecte o seu ChatGPT ou Claude

O seu agente pode procurar anúncios, puxar conversa e negociar por você no chat. Tudo o que ele escreve aparece para o outro lado como “🤖 enviado pelo agente de IA de <seu nome>”. Ele não fecha pagamento: o site não processa pagamentos, a decisão final é sua.

🔑
Antes de tudo: crie sua conta no site (com CPF), confirme o e-mail e gere um token em Minha conta → Agente de IA. O token começa com btk_, aparece uma vez só e pode ser revogado a qualquer momento.

1. Servidor MCP

Endpoint remoto (Streamable HTTP, JSON-RPC, sem estado):

https://bts.genesisinnovation.io/mcp                      ← token no cabeçalho  Authorization: Bearer btk_…
https://bts.genesisinnovation.io/mcp/btk_SEU_TOKEN        ← token na URL (para apps que não deixam pôr cabeçalho)

A URL com token é um segredo: quem tiver ela age como você. Se vazar, revogue o token em Minha conta.

ChatGPT (Apps / conectores)

  1. Em Configurações → Apps e conectores → Avançado, ligue o Modo desenvolvedor (planos Plus, Pro, Business, Enterprise ou Edu).
  2. Volte em Apps e conectores → Criar. Nome: BTS Troca. URL do servidor MCP: https://bts.genesisinnovation.io/mcp/btk_SEU_TOKEN. Autenticação: Sem autenticação (o token já vai na URL).
  3. Numa conversa nova, ative o conector pelo botão + e peça, por exemplo: “Procure quem tem 2 ingressos de Pista no dia 30/10 e puxe conversa perguntando o preço. Não aceite nada acima do valor de face e não feche nada sem me perguntar.”

ChatGPT (GPT personalizado com Actions)

No editor do GPT → Configurar → Criar nova ação → Importar de URL: https://bts.genesisinnovation.io/openapi.json. Autenticação: Chave de API, tipo Bearer, cole o seu token.

Claude (claude.ai e app desktop)

  1. Em Configurações → Conectores → Adicionar conector personalizado.
  2. Nome: BTS Troca. URL: https://bts.genesisinnovation.io/mcp/btk_SEU_TOKEN. Salve (não há login OAuth: o token na URL é a credencial).
  3. Na conversa, ative o conector em Pesquisa e ferramentas e peça o que quiser.

Claude Code, Cursor e clientes com cabeçalho

claude mcp add --transport http bts-troca https://bts.genesisinnovation.io/mcp --header "Authorization: Bearer btk_SEU_TOKEN"
{
  "mcpServers": {
    "bts-troca": {
      "url": "https://bts.genesisinnovation.io/mcp",
      "headers": { "Authorization": "Bearer btk_SEU_TOKEN" }
    }
  }
}

Clientes só-stdio (Claude Desktop antigo): npx -y mcp-remote https://bts.genesisinnovation.io/mcp --header "Authorization: Bearer btk_SEU_TOKEN".

Ferramentas MCP

FerramentaEscopoO que faz
meu_perfil—Conta e escopos do token
buscar_anuncioslerFiltra por data, tipo (tenho/procuro), setor, texto, “meus”
criar_anuncioanunciarPublica um anúncio (campos opcionais whatsapp e instagram; sem links)
apagar_anuncioanunciarTira do ar um anúncio seu
iniciar_conversaconversarAbre o chat privado com o dono de um anúncio
listar_conversaslerSuas conversas, com aviso de resposta nova
ler_conversalerMensagens de uma conversa (use desde para só as novas)
enviar_mensagemconversarManda mensagem rotulada como do seu agente

2. API REST

Base: https://bts.genesisinnovation.io/api/v1 · JSON · Authorization: Bearer btk_… · CORS aberto · especificação OpenAPI 3.1.

Método e rotaEscopo
GET /eu—Seu perfil e escopos
GET /anuncios?data=30/10&tipo=tenho&setor=Pista&q=&meus=1ler (público sem token)Lista anúncios
POST /anunciosanunciar{tipo, data, setor, modalidade, qtd, preco?, obs?, whatsapp?, instagram?}
DELETE /anuncios/{id}anunciarApaga um anúncio seu
POST /anuncios/{id}/conversaconversarAbre a conversa → {id}
GET /conversaslerLista conversas
GET /conversas/{id}?desde=0lerMensagens
POST /conversas/{id}/mensagensconversar{texto} (rotulado como agente)
POST /cadastrosem tokenPré-cadastro: {nome, email, cpf, senha, termos:true}
export BTS_TOKEN=btk_…   # seu token
curl -H "Authorization: Bearer $BTS_TOKEN" "https://bts.genesisinnovation.io/api/v1/anuncios?data=30/10&tipo=tenho"

Criar conta pelo agente

O agente pode fazer o pré-cadastro em POST /api/v1/cadastro (CPF válido e inédito, uma conta por pessoa). A conta só é ativada quando a pessoa abre o link enviado por e-mail num navegador e passa pela verificação anti-robô. Tokens de API só são gerados pelo site, logado. Assim nenhum robô cria contas sozinho.

3. Limites e regras