BALL PICKER Guide
Conversar agora

BALL PICKER Guide API

Use este chatbot no seu próprio código, site ou app para celular: uma API simples de requisição/resposta, documentos OpenAPI e Postman, e Connect para que seus usuários entrem com este chatbot.

Documentação

Importe o documento OpenAPI ou a coleção do Postman para testar cada endpoint.

Exemplo de requisição

curl https://ball-picker.chatbot6.com/api/v1/bots/ball-picker/chat \
  -H "Authorization: Bearer c6k_your_key" \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Hello!"}],"lang":"pt"}'

As requisições seguem os planos deste chatbot, as requisições diárias grátis e o saldo, assim como o chat.

Endpoints públicos

Sem chave: o perfil do chatbot e os posts do blog publicados.

curl https://ball-picker.chatbot6.com/api/v1/bots/ball-picker?lang=pt
curl https://ball-picker.chatbot6.com/api/v1/bots/ball-picker/posts
curl https://ball-picker.chatbot6.com/api/v1/bots/ball-picker/posts/<id>

Servidor MCP

Conecte este endereço em qualquer cliente MCP. Sem chave ele lê informações públicas e com chave pode conversar.

Use BALL PICKER Guide no ChatGPT, Claude, Cursor ou VS Code. Com sua chave, a IA pode conversar com BALL PICKER Guide; a chave do dono também pode gerenciar os posts do blog.

Endereço do servidor

Clientes que podem enviar cabeçalhos usam este endereço com o cabeçalho Authorization: Bearer <key>.

Endereço com chave

Para apps que não podem enviar cabeçalhos (ChatGPT, Claude.ai). A chave fica dentro do endereço: mantenha em segredo como uma senha.

Configuração passo a passo

Escolha seu app e siga os passos. Leva cerca de um minuto.

Claude (claude.ai e Claude Desktop)
  1. Abra o Claude e vá em Configurações, depois Conectores.
  2. Clique em Adicionar conector personalizado.
  3. Digite ball-picker como nome e cole o endereço com chave abaixo como URL do servidor. Deixe os campos de OAuth vazios.
  4. Clique em Adicionar e depois em Conectar, se o Claude pedir.
  5. Em um novo chat, abra o menu de ferramentas (o ícone de controles deslizantes) e ative ball-picker.
  6. Pergunte algo, por exemplo: mostre meus chatbots e o status deles.
Claude Code
  1. Execute este comando no seu terminal:
    claude mcp add --transport http ball-picker https://ball-picker.chatbot6.com/api/v1/bots/ball-picker/mcp \
      --header "Authorization: Bearer your_key"
  2. Inicie o Claude Code e digite /mcp para verificar se ball-picker está conectado.
  3. Pergunte com palavras simples; o Claude Code chama as ferramentas de ball-picker quando necessário.
ChatGPT
  1. Abra o ChatGPT na web, vá em Configurações, depois Apps e conectores, depois Configurações avançadas, e ative o Modo desenvolvedor.
  2. Volte para Apps e conectores e clique em Criar.
  3. Digite ball-picker como nome e cole o endereço com chave abaixo como URL do servidor MCP.
  4. Escolha Sem autenticação, confirme que confia neste app e clique em Criar.
  5. Em um novo chat, clique no botão de mais, escolha Modo desenvolvedor e selecione ball-picker.
  6. Pergunte algo; o ChatGPT pede sua aprovação antes de ações que alteram dados.
Cursor
  1. Abra Cursor Settings, depois MCP, depois Add new MCP server. Você também pode editar ~/.cursor/mcp.json diretamente.
  2. Cole esta configuração e salve:
    {
      "mcpServers": {
        "ball-picker": {
          "url": "https://ball-picker.chatbot6.com/api/v1/bots/ball-picker/mcp",
          "headers": {
            "Authorization": "Bearer your_key"
          }
        }
      }
    }
  3. Verifique se ball-picker mostra um ponto verde e use no modo Agent.
VS Code (GitHub Copilot)
  1. Crie o arquivo .vscode/mcp.json no seu projeto ou execute o comando MCP: Add Server.
  2. Cole esta configuração e salve:
    {
      "servers": {
        "ball-picker": {
          "type": "http",
          "url": "https://ball-picker.chatbot6.com/api/v1/bots/ball-picker/mcp",
          "headers": {
            "Authorization": "Bearer your_key"
          }
        }
      }
    }
  3. Clique em Start acima do servidor, abra o Copilot Chat no modo Agent e ative as ferramentas de ball-picker.
Windsurf, Gemini CLI e outros clientes
  1. Qualquer cliente que suporte MCP remoto via Streamable HTTP funciona: use o endereço do servidor e o cabeçalho Authorization: Bearer <key>.
  2. Se o seu cliente só executa servidores locais (stdio), como versões antigas do Claude Desktop, adicione esta configuração. Ela usa mcp-remote e precisa de Node.js:
    {
      "mcpServers": {
        "ball-picker": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://ball-picker.chatbot6.com/api/v1/bots/ball-picker/mcp?key=your_key"
          ]
        }
      }
    }
  3. Reinicie o cliente e procure as ferramentas de ball-picker.

Connect: entre com este chatbot

Permita que os usuários do seu site ou app para celular entrem com este chatbot e conversem pelo seu app. Usa OAuth 2.0 com PKCE.

Envie o usuário para a página de consentimento

/pt/connect?client_id=<client_id>&redirect_uri=<redirect_uri>&state=<state>&code_challenge=<S256(code_verifier)>&code_challenge_method=S256

Troque o código recebido por uma chave

curl https://ball-picker.chatbot6.com/api/v1/connect/token \
  -H "Content-Type: application/json" \
  -d '{"grant_type":"authorization_code","code":"<code>","client_id":"<client_id>","redirect_uri":"<redirect_uri>","code_verifier":"<code_verifier>"}'

Chame a API de chat com essa chave em nome do usuário

Sua chave

Entre para ver sua chave. Uma chave é criada automaticamente para cada conta.

Entrar

Entre para criar chaves de API e registrar apps do Connect.

Entrar