MCP 認証

Pipe2.ai の MCP サーバーは 2 つの認証方法をサポートしています。手早くセットアップできる**パーソナルアクセストークン（PAT）**と、対応する MCP クライアントが自動的に処理する OAuth 2.1 です。

パーソナルアクセストークン

PAT は最もシンプルな認証方法です。ダッシュボードから 1 つ生成し、MCP クライアントの設定に追加します。

1. Pipe2.ai ダッシュボードの API Keys → Personal Access Tokens に移動します。

2. わかりやすい名前（例: 「Claude Desktop」）を付けて新しいトークンを作成します。

3. トークンをコピーします — 表示されるのは一度だけです。

4. MCP クライアントの設定にトークンを追加します:

   {
     "headers": {
       "Authorization": "Bearer YOUR_TOKEN"
     }
   }

トークンのプロパティ

プロパティ	詳細
形式	署名付き JWT
有効期限	作成から 1 年。リクエストごとに検証されます
無効化	ダッシュボードから無効化できます（30 秒以内に反映）
最終使用日時	自動的に更新されます

トークンの無効化

トークンはいつでもダッシュボードから無効化できます。無効化は 30 秒以内に反映されます。

注意

トークンは安全に保管してください。トークンを持つ人は誰でも MCP を介してあなたの Pipe2.ai アカウントにアクセスできます。漏洩した場合は、直ちにダッシュボードから無効化してください。

OAuth 2.1

MCP OAuth 仕様をサポートする MCP クライアント（Claude Desktop など）は、認証を自動的に処理します。接続すると、クライアントは次のことを行います:

1. ブラウザで Pipe2.ai のログインページを開く
2. あなたがログインしてアクセスを承認する
3. クライアントがトークンを受け取って保存する

手動設定は不要です — 管理すべきクライアント ID、シークレット、リダイレクト URI はありません。Pipe2.ai が MCP プロトコルを介してクライアント登録を自動的に処理します。

ディスカバリー

MCP クライアントは、次を通じて OAuth エンドポイントを自動的に検出します:

GET https://mcp.pipe2.ai/.well-known/oauth-authorization-server

仕組み

MCP クライアントがトークンなしで接続すると、サーバーは OAuth ディスカバリー URL を含む 401 を返します。その後クライアントは次のことを行います:

1. OAuth メタデータ（認可エンドポイント、トークンエンドポイント）を取得する
2. ユーザーがログインするためのブラウザウィンドウを開く
3. 認可コードをアクセストークンと交換する（PKCE を使用）
4. 以降のすべての MCP リクエストにアクセストークンを含める

フロー全体は MCP クライアントが処理します — あなたは「接続」をクリックしてログインするだけです。

トラブルシューティング

問題	解決策
401 Unauthorized	PAT が Authorization: Bearer ヘッダーに含まれているか確認してください
Token expired	ダッシュボードから新しいパーソナルアクセストークンを生成してください
Token revoked	トークンが無効化されています。ダッシュボードから新しいものを作成してください
OAuth ポップアップが表示されない	MCP クライアントが OAuth 2.1 をサポートしているか確認してください。代替として PAT を使ってください