標準のOAuthログインフローの代替として、APIキーを使用してmabl cloud MCPに認証することができます。APIキー認証は、個々のユーザーアカウントではなく単一のワークスペースにアクセスをスコープする必要があるエージェント間のユースケースに適しています。
APIキー認証を使用するタイミング
OAuthとAPIキー認証の両方がサポートされており、それぞれに強みがあります。
- OAuthはmablユーザーアカウントに接続するため、ユーザーが所属するすべてのワークスペースにアクセスできます。mablのログインを使用するため、mablアプリと同様に、時折再認証が必要になります。どちらの方法を選べばよいかわからない場合は、こちらから始めてください。
- APIキーは接続を直接認証します。アクセスはキーが生成された単一のワークスペースにスコープされ、キー自体が削除または期限切れになるまで持続します。エージェント間のユースケースに最適です。
「編集者」と「閲覧者」の両方のAPIキーがサポートされています。すべてのMCPツールが正常に機能するよう、「編集者」キーをお勧めします。
試してみる
- 「編集者」または「閲覧者」のmabl APIキーを作成または取得してください。
- 以下の設定をAIクライアントのMCP設定に追加し、
YOUR_API_KEY_HEREをご自身のAPIキーに置き換えてください。
{
"mcpServers": {
"mabl": {
"url": "https://mcp.mabl.com/mcp",
"headers": {
"x-api-key": "YOUR_API_KEY_HERE"
}
}
}
}設定ファイルがバージョン管理にチェックインされている場合や他のユーザーと共有している場合は、APIキーを直接貼り付けるのではなく、環境変数から参照してください。例: "x-api-key": "${MABL_API_KEY}"。
Claude Codeでは、次のコマンドを実行することもできます。
claude mcp add --transport http mabl https://mcp.mabl.com/mcp --header "x-api-key: YOUR_API_KEY_HERE"
AIクライアントがHTTPをサポートしていない場合、SSEおよびstdioブリッジトランスポートもAPIキー認証で使用できます。
詳細を見る
- クラウドMCPサーバーのセットアップ - 代替トランスポートを含む完全なセットアップ手順。
- mabl MCPツールとプロンプト - 利用可能なツールとサンプルプロンプトのリファレンス。