BALL PICKER Guide API
Bu chatbotu kendi kodundan, web sitenden ya da mobil uygulamandan kullan: basit istek/yanıt API’si, OpenAPI ve Postman belgeleri, kullanıcılarının bu chatbotla giriş yapması için Connect.
Belgeler
Bütün uçları denemek için OpenAPI belgesini ya da Postman koleksiyonunu içe aktar.
Örnek istek
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":"tr"}'İstekler sohbetteki gibi bu chatbotun paketlerine, günlük ücretsiz hakkına ve bakiyeye göre ücretlenir.
Herkese açık uçlar
Anahtar gerekmez: chatbot tanıtımı ve yayındaki blog yazıları.
curl https://ball-picker.chatbot6.com/api/v1/bots/ball-picker?lang=tr 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>
MCP sunucusu
Bu adresi herhangi bir MCP istemcisine bağla. Anahtarsız herkese açık bilgiyi okur, anahtarla sohbet eder.
BALL PICKER Guide chatbotunu ChatGPT, Claude, Cursor ya da VS Code içinde kullan. Anahtarınla AI BALL PICKER Guide ile sohbet edebilir; sahip anahtarı blog yazılarını da yönetebilir.
Sunucu adresi
Başlık gönderebilen istemciler bu adresi Authorization: Bearer <key> başlığıyla kullanır.
Anahtarlı adres
Başlık gönderemeyen uygulamalar için (ChatGPT, Claude.ai). Anahtar adresin içindedir: bir şifre gibi gizli tut.
Adım adım kurulum
Uygulamanı seç ve adımları izle. Yaklaşık bir dakika sürer.
Claude (claude.ai ve Claude Desktop)
- Claude uygulamasını aç ve Ayarlar, ardından Bağlayıcılar bölümüne git.
- Özel bağlayıcı ekle seçeneğine tıkla.
- Ad olarak ball-picker yaz ve sunucu adresi olarak aşağıdaki anahtarlı adresi yapıştır. OAuth alanlarını boş bırak.
- Ekle seçeneğine, Claude isterse Bağlan seçeneğine tıkla.
- Yeni bir sohbette araçlar menüsünü (kaydırıcı simgesi) aç ve ball-picker seçeneğini aç.
- Bir şey sor, örneğin: chatbotlarımı ve durumlarını göster.
Claude Code
- Bu komutu terminalinde çalıştır:
claude mcp add --transport http ball-picker https://ball-picker.chatbot6.com/api/v1/bots/ball-picker/mcp \ --header "Authorization: Bearer your_key"
- Claude Code uygulamasını başlat ve ball-picker bağlantısını kontrol etmek için /mcp yaz.
- Düz cümlelerle sor; Claude Code gerektiğinde ball-picker araçlarını çağırır.
ChatGPT
- ChatGPT web sürümünü aç, Ayarlar, ardından Uygulamalar ve Bağlayıcılar, ardından Gelişmiş ayarlar bölümüne git ve Geliştirici modunu aç.
- Uygulamalar ve Bağlayıcılar bölümüne dön ve Oluştur seçeneğine tıkla.
- Ad olarak ball-picker yaz ve MCP sunucu adresi olarak aşağıdaki anahtarlı adresi yapıştır.
- Kimlik doğrulama yok seçeneğini seç, bu uygulamaya güvendiğini onayla ve Oluştur seçeneğine tıkla.
- Yeni bir sohbette artı düğmesine tıkla, Geliştirici modunu seç ve ball-picker seçeneğini işaretle.
- Bir şey sor; ChatGPT veriyi değiştiren işlemlerden önce onayını ister.
Cursor
- Cursor Settings, ardından MCP, ardından Add new MCP server bölümünü aç. ~/.cursor/mcp.json dosyasını doğrudan da düzenleyebilirsin.
- Bu yapılandırmayı yapıştır ve kaydet:
{ "mcpServers": { "ball-picker": { "url": "https://ball-picker.chatbot6.com/api/v1/bots/ball-picker/mcp", "headers": { "Authorization": "Bearer your_key" } } } } - ball-picker yanında yeşil nokta göründüğünü kontrol et, sonra Agent modunda kullan.
VS Code (GitHub Copilot)
- Projende .vscode/mcp.json dosyasını oluştur ya da MCP: Add Server komutunu çalıştır.
- Bu yapılandırmayı yapıştır ve kaydet:
{ "servers": { "ball-picker": { "type": "http", "url": "https://ball-picker.chatbot6.com/api/v1/bots/ball-picker/mcp", "headers": { "Authorization": "Bearer your_key" } } } } - Sunucunun üstündeki Start seçeneğine tıkla, Copilot Chat uygulamasını Agent modunda aç ve ball-picker araçlarını etkinleştir.
Windsurf, Gemini CLI ve diğer istemciler
- Streamable HTTP üzerinden uzak MCP destekleyen her istemci çalışır: sunucu adresini ve Authorization: Bearer <key> başlığını kullan.
- İstemcin yalnızca yerel (stdio) sunucuları çalıştırıyorsa, örneğin eski Claude Desktop sürümleri, bu yapılandırmayı ekle. mcp-remote kullanır ve Node.js gerektirir:
{ "mcpServers": { "ball-picker": { "command": "npx", "args": [ "-y", "mcp-remote", "https://ball-picker.chatbot6.com/api/v1/bots/ball-picker/mcp?key=your_key" ] } } } - İstemciyi yeniden başlat ve ball-picker araçlarını bul.
Connect: bu chatbotla giriş
Web siten ya da mobil uygulamanın kullanıcıları bu chatbotla giriş yapıp senin uygulaman üzerinden sohbet etsin. OAuth 2.0 ve PKCE kullanır.
Kullanıcıyı izin sayfasına gönder
/tr/connect?client_id=<client_id>&redirect_uri=<redirect_uri>&state=<state>&code_challenge=<S256(code_verifier)>&code_challenge_method=S256
Dönen kodu anahtara çevir
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>"}'