メインコンテンツへスキップ
/mcp エンドポイントは、Supabase access_token をBearerトークンとして渡すことが必要です。ほとんどのMCPクライアントはOAuth 2.1 PKCEフローを介して自動的にこれを取得します。テスト目的でトークンを手動で提供することもできます。

OAuth 2.1 PKCEフロー

FlowstepはOAuth 2.1認可サーバーを https://api.flowstep.ai で実装しています。MCPクライアントは標準的なRFCメタデータエンドポイント経由でこれを発見します。

ディスカバリーチェーン

OAuthエンドポイント

サポートされているログイン方法

/oauth/authorize の認可ページは以下をサポートしています:
  • メール/パスワード ― パスワードが設定されているFlowstepアカウント
  • Google SSO ― Supabaseソーシャル認証を通じてリダイレクトされ、クライアントに自動的に戻ります

claude.aiコネクタユーザーのアカウント作成

OAuthログインページにはサインアップフォームが含まれていません。claude.aiのカスタムコネクタ経由で接続していてFlowstepアカウントをまだお持ちでない場合は、まず app.flowstep.ai でアカウントを作成してから、コネクタセットアップに戻って認証してください。

トークンメカニズム

トークンはすべてのリクエストで supabase.auth.getUser(token) を介して検証されます。有効期限切れまたは無効なトークンは 401WWW-Authenticate ヘッダーを返し、これはクライアントの再認証フローをトリガーします。

クッキーフォールバック

Authorization ヘッダーがない場合、ミドルウェアはクッキーベースのSupabaseセッションにフォールバックします。これはアクティブなFlowstepセッションでブラウザから直接 /mcp にアクセスする場合に機能します。MCPクライアントは常にBearerパスを使用します。

手動トークン(テスト)

クライアントOAuthフローなしにエンドポイントを直接呼び出すには:
  1. ブラウザで app.flowstep.ai にサインインしてください
  2. DevTools → Consoleを開いて、以下を実行してください:
  1. トークンをヘッダーとして渡してください:
MCPセッションは30日間持続します―サーバーは基盤となるトークンを透過的に更新するため、OAuthフローを使用するクライアントは通常の使用中に再認証する必要がありません。上記のような手動で抽出されたトークンは約1時間後に期限切れになります。これはクイックテストのみを目的としています。