MCP のトラブルシューティング
接続の問題で次に行う手順を確認します。
ホスト型クライアントに接続できない
設定した URL が https://mcp.altifigence.com/cloud-mcp であり、クライアントが OAuth を使用する Streamable HTTP に対応していることを確認します。接続ガイドと現在の適合確認の状態に従ってください。サーバーのヘルスページや OAuth メタデータは、特定のクライアントで認可が完了したことを証明するものではありません。
結果 | 次の手順 |
|---|---|
HTTP 401 | 認可が期限切れまたは取り消されている場合は、Altifigence Cloud に再接続し、クライアントの認可手続きを再度完了する |
HTTP 403 | 同意した組織、現在のプロジェクトアクセス、ツールポリシーを確認する。組織がツールを有効にした後、必要な権限で再接続する |
ツールが空、または不足している | 公開済みカタログ、各ツールの明示的な組織承認、新たな同意を確認する。古いトークンの更新ではツールは追加されない |
ワークスペースを読み取れない | Cloud でワークスペースの状態とアクセスを確認し、準備が整ってから再試行する |
実行ツールがない | 新たに |
書き込みツールがない | 新たに |
ファイル変更の競合 | マニフェストとファイルを読み直し、同時に行われた変更を確認して、現在のリビジョンで意図した変更を送信する |
プロジェクト作成または Git 変更が確認できない | 再試行する前に、プロジェクト一覧、リポジトリ、リモートの状態を確認する。作成、コミット、プッシュの繰り返しは意図しない影響を及ぼす場合がある |
プロジェクト削除が受け付けられた | クリーンアップが完了するまで、プロジェクト・ワークスペースの状態を確認する。受け付けは完了を意味しない |
Git プロバイダーの転送が拒否された | 選択したリポジトリ、ブランチ、現在のプロバイダー接続を確認する。ツールはプロバイダー権限を回避できない |
ランタイム操作が確認できない | ランタイム状態を読み取り、操作 ID を保持する。再開には、停止したランタイムの操作 ID を使う |
プロジェクト世代、ファイルバージョン、ポリシーが変わった | 新しい見積もりを取得し、選択されたオファーと使用量ポリシーを確認する |
送信が確認できない | 同じジョブ ID を確認する。再試行は、同一の引数と同じ ID でのみ行う |
結果の準備ができていない | 結果を再要求する前にジョブ状態を読み取る |
クレジット不足 | Cloud で組織の請求状態を確認する |
HTTP 413 | 要求を、検出したツールスキーマに含まれる引数に絞る |
ローカルツールからの HTTP 501 | インストール済みランタイムはこの操作を実装していない。検出できるだけでは対応していることは確認できない |
HTTP 503 | サービスの復旧を待ち、設定済みのエンドポイントは保持する |
読み取り要求は、プロジェクトを起動も再起動もしません。不明なツール名や認可されていないツール名によって、編集や実行が有効になることはありません。再試行前に接続やアクセス条件を修正してください。引数に別の資格情報を指定しないでください。
要求回数が多すぎる
応答に HTTP 429 が含まれる場合は、Retry-After で指定された期間を待ってから再試行してください。登録やサインインの繰り返しを避けてください。
サポートに連絡する
お問い合わせは Altifigence Supportに、機密情報を削除したうえで、クライアント名、バージョン、問題が発生した時刻、エラーメッセージを添えて連絡してください。資格情報、Cookie、プロジェクトの内容は含めないでください。
作業を重複させずに復旧する
失敗した箇所 | 再試行前に確認するもの |
|---|---|
識別情報または検出 | クライアントのバージョン、エンドポイント、サインイン・セッション、同意したツール一覧。 |
ファイル読み取りの継続 | ファイルとマニフェストのバージョン。スナップショットが変わった場合は最初からやり直す。 |
ファイルの書き込み、コミット、プッシュ | 現在保存されているファイル、リポジトリ、リモートの状態。 |
ジョブ送信 | 既存のジョブ ID と状態。元の識別情報を保持する。 |
ターミナル入力または AI 要求 | 現在のセッションと出力。入力を自動で再実行しない。 |
プロジェクトデータをプレースホルダーに置き換え、再現可能な最小の要求を記録します。エラーコード、HTTP ステータス、表示される場合は要求識別子、およびタイムスタンプを保持してください。診断を共有する前に、トークンとソース内容を取り除きます。