開発者ドキュメント
API・CLI・MCPの接続問題を解決
認証情報を公開せず、受理済み作業を重複させずに、ログイン・権限・スキーマ・アップロード・不確かな書き込みを解決します。
Markdownで読むSosoAPIチームが確認 ·
別ブラウザー・ローカルログインの問題
保留ログインを止め、auth login --no-openを実行します。新しい表示URLを目的のブラウザープロフィールで開き、アカウントとワークスペースを確認して許可します。同じリンクを複数プロフィールで使わないでください。8789ポート使用中ならリスナーを調べ、自分が起動したログインプロセスの場合のみ停止します。
npx sosoapi auth login --no-openlsof -nP -iTCP:8789 -sTCP:LISTEN401・403と利用できないアカウント
401は有効な認証情報でログインしているか、403はロール、スコープ、必要機能を確認します。auth status、メール、認証種別を調べ、必要な場合だけアクセスを変更します。プロファイルの変更で権限は付与されません。
ソーシャルアカウントを別に確認し、接続・機能を取得します。プロバイダーが再同意を求める場合のみ再接続し、内部障害で正常接続を作り直さないでください。
400検証エラーとバージョン不一致
レスポンス本文と検証のフィールドパスを確認します。検証はZodError、ハンドラーはerror、message、codeを使う場合があります。インストール契約と比較し、必要なら更新します。必須値を除いたり非対応フィルターを追加せず、指定フィールドを修正します。
npx sosoapi api contract --route /studio-api/scheduled-posts/409、429、5xx、または書き込みのタイムアウト
409は最新バージョンと操作を取得してから変更します。429はRetry-Afterに従って待ち、同時実行を減らします。書き込みのタイムアウトや5xxではIDを保持し、先に既存結果を確認します。切断前に受理されている可能性があります。
操作と現在の状態が許可する場合のみ再試行します。同じ内容は同じキーを使い、不確かな結果を迂回する代替作成はしません。認証失敗を先に直します。保留中ジョブにも確認すべき実行エラーが含まれる場合があります。
アップロード・ツール検出の問題
ローカルアップロードは作業・一時フォルダー、Pictures/Movies/Videos、SOSOAPI_UPLOAD_ROOTS内の対応ファイルを最大500 MiBまで受け付けます。ドットフォルダーや範囲外へのシンボリックリンクは拒否します。ホーム全体でなく必要フォルダーだけを追加してください。HTTP接続でローカルファイルは読めません。
ツールがなければ再接続し、プロファイルと接続種別をリファレンスと比較します。現在の会話に読み込まれているか確認してください。保存済みサーバー名だけでは確認になりません。
役立つ診断情報を安全に共有
操作名、日時、HTTPステータス、安全なエラーコード、request_idまたはx-request-idを共有します。CLI版とローカル・リモートMCPの別も添えてください。トークン、Cookie、認可リンク、署名付きメディアURL、顧客内容、非公開IDは除き、認証ファイルや全応答ではなく該当エラーのみ共有します。