BALL PICKER Guide API
Usa este chatbot desde tu propio código, tu sitio web o tu app móvil: una API sencilla de solicitud/respuesta, documentos OpenAPI y Postman, y Connect para que tus usuarios inicien sesión con este chatbot.
Documentación
Importa el documento OpenAPI o la colección de Postman para probar cada endpoint.
Solicitud de ejemplo
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":"es"}'Las solicitudes siguen los planes de este chatbot, las solicitudes diarias gratis y el saldo, igual que el chat.
Endpoints públicos
Sin clave: el perfil del chatbot y sus entradas de blog publicadas.
curl https://ball-picker.chatbot6.com/api/v1/bots/ball-picker?lang=es 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
Conecta esta dirección en cualquier cliente MCP. Sin clave lee información pública y con clave puede chatear.
Usa BALL PICKER Guide dentro de ChatGPT, Claude, Cursor o VS Code. Con tu clave, la IA puede chatear con BALL PICKER Guide; la clave del propietario también puede gestionar las entradas del blog.
Dirección del servidor
Los clientes que pueden enviar cabeceras usan esta dirección con la cabecera Authorization: Bearer <key>.
Dirección con clave
Para apps que no pueden enviar cabeceras (ChatGPT, Claude.ai). La clave va dentro de la dirección: guárdala en secreto como una contraseña.
Configuración paso a paso
Elige tu app y sigue los pasos. Tarda alrededor de un minuto.
Claude (claude.ai y Claude Desktop)
- Abre Claude y ve a Configuración, luego Conectores.
- Haz clic en Añadir conector personalizado.
- Escribe ball-picker como nombre y pega la dirección con clave de abajo como URL del servidor. Deja vacíos los campos de OAuth.
- Haz clic en Añadir y luego en Conectar si Claude lo pide.
- En un chat nuevo, abre el menú de herramientas (el icono de controles deslizantes) y activa ball-picker.
- Pregunta algo, por ejemplo: muestra mis chatbots y su estado.
Claude Code
- Ejecuta este comando en tu terminal:
claude mcp add --transport http ball-picker https://ball-picker.chatbot6.com/api/v1/bots/ball-picker/mcp \ --header "Authorization: Bearer your_key"
- Inicia Claude Code y escribe /mcp para comprobar que ball-picker está conectado.
- Pregunta con palabras sencillas; Claude Code llama a las herramientas de ball-picker cuando hace falta.
ChatGPT
- Abre ChatGPT en la web, ve a Configuración, luego Aplicaciones y conectores, luego Configuración avanzada, y activa el Modo desarrollador.
- Vuelve a Aplicaciones y conectores y haz clic en Crear.
- Escribe ball-picker como nombre y pega la dirección con clave de abajo como URL del servidor MCP.
- Elige Sin autenticación, confirma que confías en esta app y haz clic en Crear.
- En un chat nuevo, haz clic en el botón más, elige Modo desarrollador y selecciona ball-picker.
- Pregunta algo; ChatGPT pide tu aprobación antes de acciones que cambian datos.
Cursor
- Abre Cursor Settings, luego MCP, luego Add new MCP server. También puedes editar ~/.cursor/mcp.json directamente.
- Pega esta configuración y guarda:
{ "mcpServers": { "ball-picker": { "url": "https://ball-picker.chatbot6.com/api/v1/bots/ball-picker/mcp", "headers": { "Authorization": "Bearer your_key" } } } } - Comprueba que ball-picker muestra un punto verde y úsalo en el modo Agent.
VS Code (GitHub Copilot)
- Crea el archivo .vscode/mcp.json en tu proyecto o ejecuta el comando MCP: Add Server.
- Pega esta configuración y guarda:
{ "servers": { "ball-picker": { "type": "http", "url": "https://ball-picker.chatbot6.com/api/v1/bots/ball-picker/mcp", "headers": { "Authorization": "Bearer your_key" } } } } - Haz clic en Start encima del servidor, abre Copilot Chat en modo Agent y activa las herramientas de ball-picker.
Windsurf, Gemini CLI y otros clientes
- Funciona cualquier cliente compatible con MCP remoto sobre Streamable HTTP: usa la dirección del servidor y la cabecera Authorization: Bearer <key>.
- Si tu cliente solo ejecuta servidores locales (stdio), como versiones antiguas de Claude Desktop, añade esta configuración. Usa mcp-remote y necesita 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" ] } } } - Reinicia el cliente y busca las herramientas de ball-picker.
Connect: inicia sesión con este chatbot
Permite que los usuarios de tu sitio web o app móvil inicien sesión con este chatbot y chateen a través de tu app. Usa OAuth 2.0 con PKCE.
Envía al usuario a la página de consentimiento
/es/connect?client_id=<client_id>&redirect_uri=<redirect_uri>&state=<state>&code_challenge=<S256(code_verifier)>&code_challenge_method=S256
Cambia el código devuelto por una clave
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>"}'Llama a la API de chat con esa clave en nombre del usuario
Tu clave
Inicia sesión para ver tu clave. Cada cuenta recibe una clave automáticamente.
Iniciar sesiónInicia sesión para crear claves de API y registrar apps de Connect.
Iniciar sesión