BALL PICKER Guide API
Korzystaj z tego chatbota we własnym kodzie, na stronie lub w aplikacji mobilnej: proste API typu żądanie/odpowiedź, dokumenty OpenAPI i Postman oraz Connect, dzięki któremu twoi użytkownicy zalogują się przez tego chatbota.
Dokumentacja
Zaimportuj dokument OpenAPI lub kolekcję Postman, aby wypróbować każdy endpoint.
Przykładowe żądanie
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":"pl"}'Żądania podlegają planom tego chatbota, darmowym dziennym żądaniom i saldu, tak jak czat.
Publiczne punkty końcowe
Bez klucza: profil chatbota i jego opublikowane wpisy na blogu.
curl https://ball-picker.chatbot6.com/api/v1/bots/ball-picker?lang=pl 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>
Serwer MCP
Podłącz ten adres w dowolnym kliencie MCP. Bez klucza odczytuje informacje publiczne, a z kluczem może rozmawiać.
Używaj BALL PICKER Guide w ChatGPT, Claude, Cursor lub VS Code. Z Twoim kluczem AI może czatować z BALL PICKER Guide; klucz właściciela pozwala też zarządzać wpisami na blogu.
Adres serwera
Klienty, które mogą wysyłać nagłówki, używają tego adresu z nagłówkiem Authorization: Bearer <key>.
Adres z kluczem
Dla aplikacji, które nie mogą wysyłać nagłówków (ChatGPT, Claude.ai). Klucz jest w adresie: chroń go jak hasło.
Konfiguracja krok po kroku
Wybierz aplikację i wykonaj kroki. Zajmuje to około minuty.
Claude (claude.ai i Claude Desktop)
- Otwórz Claude i przejdź do Ustawienia, a następnie Konektory.
- Kliknij Dodaj niestandardowy konektor.
- Wpisz ball-picker jako nazwę i wklej poniższy adres z kluczem jako URL serwera. Pola OAuth zostaw puste.
- Kliknij Dodaj, a potem Połącz, jeśli Claude o to poprosi.
- W nowym czacie otwórz menu narzędzi (ikona suwaków) i włącz ball-picker.
- Zadaj pytanie, na przykład: pokaż moje chatboty i ich status.
Claude Code
- Uruchom to polecenie w terminalu:
claude mcp add --transport http ball-picker https://ball-picker.chatbot6.com/api/v1/bots/ball-picker/mcp \ --header "Authorization: Bearer your_key"
- Uruchom Claude Code i wpisz /mcp, aby sprawdzić, czy ball-picker jest połączony.
- Pytaj zwykłymi słowami; Claude Code wywołuje narzędzia ball-picker, gdy są potrzebne.
ChatGPT
- Otwórz ChatGPT w przeglądarce, przejdź do Ustawienia, następnie Aplikacje i konektory, potem Ustawienia zaawansowane, i włącz Tryb dewelopera.
- Wróć do Aplikacje i konektory i kliknij Utwórz.
- Wpisz ball-picker jako nazwę i wklej poniższy adres z kluczem jako URL serwera MCP.
- Wybierz Brak uwierzytelniania, potwierdź, że ufasz tej aplikacji, i kliknij Utwórz.
- W nowym czacie kliknij przycisk plusa, wybierz Tryb dewelopera i zaznacz ball-picker.
- Zadaj pytanie; ChatGPT prosi o zgodę przed działaniami, które zmieniają dane.
Cursor
- Otwórz Cursor Settings, następnie MCP, potem Add new MCP server. Możesz też edytować bezpośrednio ~/.cursor/mcp.json.
- Wklej tę konfigurację i zapisz:
{ "mcpServers": { "ball-picker": { "url": "https://ball-picker.chatbot6.com/api/v1/bots/ball-picker/mcp", "headers": { "Authorization": "Bearer your_key" } } } } - Sprawdź, czy przy ball-picker widać zieloną kropkę, a potem używaj go w trybie Agent.
VS Code (GitHub Copilot)
- Utwórz plik .vscode/mcp.json w projekcie lub uruchom polecenie MCP: Add Server.
- Wklej tę konfigurację i zapisz:
{ "servers": { "ball-picker": { "type": "http", "url": "https://ball-picker.chatbot6.com/api/v1/bots/ball-picker/mcp", "headers": { "Authorization": "Bearer your_key" } } } } - Kliknij Start nad serwerem, otwórz Copilot Chat w trybie Agent i włącz narzędzia ball-picker.
Windsurf, Gemini CLI i inne klienty
- Działa każdy klient obsługujący zdalne MCP przez Streamable HTTP: użyj adresu serwera i nagłówka Authorization: Bearer <key>.
- Jeśli Twój klient uruchamia tylko lokalne serwery (stdio), jak starsze wersje Claude Desktop, dodaj tę konfigurację. Używa mcp-remote i wymaga 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" ] } } } - Uruchom ponownie klienta i poszukaj narzędzi ball-picker.
Connect: logowanie przez tego chatbota
Pozwól użytkownikom twojej strony lub aplikacji mobilnej logować się przez tego chatbota i czatować w twojej aplikacji. Używa OAuth 2.0 z PKCE.
Wyślij użytkownika na stronę zgody
/pl/connect?client_id=<client_id>&redirect_uri=<redirect_uri>&state=<state>&code_challenge=<S256(code_verifier)>&code_challenge_method=S256
Wymień otrzymany kod na klucz
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>"}'Wywołaj API czatu tym kluczem w imieniu użytkownika
Twój klucz
Zaloguj się, aby zobaczyć swój klucz. Klucz jest tworzony automatycznie dla każdego konta.
Zaloguj sięZaloguj się, aby tworzyć klucze API i rejestrować aplikacje Connect.
Zaloguj się