/mcp uç noktası, Authorization başlığında bir Bearer belirteci gerektirir. MCP istemcileri bu belirteci OAuth 2.1 PKCE akışı üzerinden otomatik olarak alır; oluşturulacak, yapıştırılacak veya yenilenecek bir API anahtarı yoktur. Test amacıyla belirteci elle de sağlayabilirsiniz.
OAuth 2.1 PKCE akışı
Flowstep,https://api.flowstep.ai adresinde kendi OAuth 2.1 yetkilendirme sunucusunu çalıştırır. MCP istemcileri akışı otomatik olarak bulur ve tamamlar: sizin giriş yapıp erişimi onaylamanız için bir tarayıcı penceresi açar, ardından belirteç değişimini arka planda gerçekleştirir. İstemciler kendilerini dinamik olarak kaydedebildiğinden, önce bir istemci kimliği ayarlamanız gerekmez.
Desteklenen giriş yöntemleri
/oauth/authorize adresindeki yetkilendirme sayfası şunları destekler:
- Email/password — parolası ayarlanmış herhangi bir Flowstep hesabı
- Google SSO — Supabase sosyal kimlik doğrulaması üzerinden yönlendirir ve istemciye otomatik olarak geri döner
Erişimi inceleyin ve onaylayın
Giriş yaptıktan sonra Flowstep, belirteç vermeden önce bir onay ekranı gösterir; hiçbir istemci sizin açık onayınız olmadan bağlantıyı tamamlayamaz. Ekranın başlığı Authorize access şeklindedir. Erişim isteyen istemcinin adı kalın olarak gösterilir ve ardından “is requesting access to your Flowstep account” (Flowstep hesabınıza erişim talep ediyor) ifadesi gelir. Ardından You’ll be redirected to ve hedef ana bilgisayar gösterilir. Bağlantıyı tamamlamak için Allow (İzin ver) seçeneğini, iptal etmek için Deny (Reddet) seçeneğini seçin. Reddetmek, istemciye biraccess_denied hatası döndürür ve belirteç verilmez.
claude.ai bağlayıcısı kullanıcıları için hesap oluşturma
OAuth giriş sayfasında kayıt formu bulunmaz. Flowstep bağlayıcısını Claude’un bağlayıcı dizininden ekliyorsanız ve henüz bir Flowstep hesabınız yoksa, önce app.flowstep.ai adresinde bir hesap oluşturun, ardından bağlantıyı tamamlamak için Claude’a dönün.Çerez yedek yöntemi
Authorization başlığı yoksa ara katman, çerez tabanlı bir Supabase oturumuna geri döner. Bu yöntem, etkin bir Flowstep oturumu olan bir tarayıcıdan doğrudan /mcp adresine erişildiğinde çalışır. MCP istemcileri her zaman Bearer yolunu kullanır.
Elle belirteç (test)
İstemci OAuth akışı olmadan uç noktayı doğrudan çağırmak için:- Tarayıcınızda app.flowstep.ai adresine oturum açın
- DevTools → Console bölümünü açın ve şunu çalıştırın:
- Belirteci bir başlık olarak gönderin: