概要
auth_status は、認証方式、ユーザー識別情報、付与されているスコープなど、現在の認証状態に関する情報を返します。このツールはパラメータも特定のスコープも必要としません。
主なユースケース:
- 認証が正しく構成されているかを確認する
- 他のツールが認可エラーを返した際に権限の問題をデバッグする
- ツールを呼び出す前に、利用可能なスコープを確認する
- パラメータ不要
- スコープ不要
- 完全な認証コンテキストを返す
パラメータ
このツールはパラメータを取りません。リクエスト例
レスポンス形式
成功レスポンス
スコープについて
scopes 配列は、どのツールを使用する権限があるかを示します。
使用例
権限エラーのデバッグ
ツール呼び出しが403 Forbidden エラーを返した場合は、auth_status を使ってスコープを確認します。
mcp:notes:read スコープしかありません。別のスコープを必要とするツール（たとえばフォルダ検索の mcp:folders:read）は 403 Forbidden を返します。
API key の種類を確認する
userId と workspaceGuid を確認することで、どの種類の API key を使用しているかを判別できます。
- User-scoped key:
userIdが設定され、workspaceGuidがnull。複数のワークスペースにまたがってアクセスできます。 - Workspace-scoped key:
workspaceGuidが設定され、userIdがnull。単一のワークスペースに紐づき、ユーザー識別情報を持ちません。
よくあるエラー
無効または期限切れの認証情報
解決方法: API key または JWT token が正しく、期限切れになっていないことを確認してください。必要に応じて新しいキーを生成してください。ベストプラクティス
Call auth_status on Startup
Call auth_status on Startup
MCP クライアントを初期化する際は、まず
auth_status を呼び出して接続を確認し、利用可能なスコープを検証してください。これにより、他のツールを呼び出す前に構成の問題を早期に発見できます。Use for Troubleshooting
Use for Troubleshooting
ツールが予期しない認可エラーを返した場合、
auth_status は問題を診断する最も速い手段です。必要なスコープが scopes 配列に含まれているかをご確認ください。