このガイドでは、Notta MCPとNotta CLIでよくある問題の解決方法を説明します。該当する問題を探し、以下の確認事項をお試しください。
ご注意： MCPでは、記載されているツールを呼び出すようAIアシスタントに依頼してください。CLIでは、お使いのパソコンのターミナルまたはコマンドラインアプリでコマンドを実行してください。
Nottaが見つからない、またはMCPツールが表示されない
使用するツールのパッケージがインストールされていることを確認してください。
npm list -g @notta-labs/notta-mcp --depth=0
npm list -g @notta-labs/notta-cli --depth=0使用するツールに対応するコマンドだけを実行してください。パッケージがインストールされていない場合は、そのツールのセットアップガイドに従ってください。
-
CLI：ターミナルを開き直してから、
notta --versionを実行してください。 -
MCP：アシスタントの設定にある
nottaの項目を確認してから、アシスタントを完全に終了し、再度起動してください。
それでもMCPがnotta-mcpを見つけられない場合は、アシスタントのセットアップガイドで、インストール済みのコマンドを見つけるための手順を確認してください。サポートにお問い合わせの際は、エラーメッセージを正確にお伝えください。
特定のコマンドやツールを利用できない場合は、インストール済みのバージョンがガイドの対象バージョンと一致しているか確認してください。古いバージョンでは、コマンド名が異なる場合があります。
ログインに失敗する、または認証情報が見つからない
インストールしたツールを使って、新たにログインを開始してください。
| 操作 | 呼び出しを依頼するMCPツール | CLIコマンド |
|---|---|---|
| ログインを開始する | auth_setup |
notta auth setup |
| 保存済みの接続情報を確認する | auth_status |
notta auth status |
| 接続先のアカウントを確認する | auth_user_info |
notta auth user info |
ブラウザでの認証手順を完了してから、保存済みの接続情報と接続先のアカウントを確認してください。ログインページが開いただけでは、認証が成功したことにはなりません。
ブラウザに「認証に失敗しました。もう一度お試しください。」と表示される、Invalid authorization requestというエラーが出る、コールバックの状態が一致しない、または認証が待機したまま進まない場合は、次の手順をお試しください。
- 完了していないログインをキャンセルし、その認証用のタブを閉じてください。
- 新たなログインを1件だけ開始し、新しく開いたページで完了させてください。
- 同じエラーが再び発生する場合は、エラーメッセージとパッケージのバージョンを添えて、サポートにお問い合わせください。
ご注意： サポートから指示がない限り、認証情報ファイルの削除、認証URLの変更、環境の切り替えは行わないでください。
ノートが表示されない
正しいNottaアカウントに接続していることと、Nottaでそのノートにアクセスできることを確認してください。検索キーワードを短くするか、検索の代わりにノートの一覧を取得してみてください。
結果が複数のページに分かれる場合があります。MCPでは、次のページを取得するようアシスタントに依頼してください。CLIでは、返されたnext_cursorの値を使用してください。
notta record list --cursor "NEXT_CURSOR"NEXT_CURSORを、直前に一覧を取得した際の応答に含まれる値に置き換えてください。検索結果の続きを取得する場合は、同じキーワードと検索コマンドの--cursorオプションを使用してください。
MCPでアップロードまたはダウンロードのパスが拒否される
アップロードするファイルまたはダウンロード先が、MCP設定のargsに記載したフォルダ内にあることを確認してください。
- 実在するフォルダのフルパスを使用してください。
- OSのユーザーアカウントに、そのフォルダの読み取りまたは書き込み権限があることを確認してください。
- 設定を変更した後は、アシスタントを完全に再起動してください。
ヒント： ホームフォルダ全体へのアクセスは許可せず、必要なフォルダだけを追加してください。
文字起こしがまだ完了していない
ファイルを再度アップロードする前に、既存のノートの状態を確認してください。
MCPでは、Record IDを指定してrecord_statusを呼び出すよう依頼してください。CLIでは、以下のRECORD_IDを置き換えてください。
notta record status RECORD_ID文字起こしがまだ処理中の場合は、時間をおいて再度確認してください。失敗した場合は、サポートへの問い合わせに備えてRecord IDとエラーメッセージを控えておいてください。待機がタイムアウトしただけでは、文字起こしが失敗したとは限りません。
エクスポートしたファイルをダウンロードできない
新たなエクスポートタスクを作成する前に、既存のタスクを確認してください。MCPでは、export_statusを呼び出すよう依頼してください。CLIでは、TASK_IDをRecord IDではなくエクスポートタスクIDに置き換えてください。
notta export status TASK_IDエクスポートが成功してからダウンロードしてください。保存先のフォルダを確認し、同じ名前のファイルがすでに存在する場合は別のファイル名を使用してください。MCPでダウンロードする場合は、保存先も設定済みのフォルダ内である必要があります。
問題が解決しない場合
Notta MCPまたはCLIについてご不明な点がありましたら、サポートチーム（support@notta.ai）までお問い合わせください。
お問い合わせの際は、以下の情報をお知らせください。
- お使いのOS
- パッケージのバージョン
- アシスタント名（MCPをご利用の場合）
- 正確なエラーメッセージ
- Record IDまたはエクスポートタスクID（該当する場合）
ご注意： スクリーンショットやログを共有する前に、パスワード、トークン、認証リンク、非公開のノート内容を削除してください。認証情報ファイルは絶対に送信しないでください。
よくあるご質問
いいえ。ブラウザでの認証手順を完了してから、auth_statusまたはnotta auth statusで保存済みの接続情報を確認し、auth_user_infoまたはnotta auth user infoで接続先のアカウントを確認してください。
いいえ。まず既存のノートの状態を確認してください。まだ処理中の場合は、時間をおいて再度確認してください。
ファイルまたは保存先が、MCP設定で許可されているフォルダの外にある可能性があります。設定済みのフォルダ内のフルパスを使用してください。設定を変更した後は、アシスタントを再起動してください。