SosoAPIのインストール：パッケージ・クライアント・リモートMCP

どのnpmパッケージをインストールすべきですか？

新規設定はsosoapiをインストールします。@sosoapi/cli、sosoapi-cli、sosoapi-mcpは同じ特定版を導入するエイリアスです。同じCLI・MCPを使うため一パッケージで十分です。

ローカルMCPはNode.js 20以降とnpm/npxが必要です。ホスト型はローカルパッケージ不要です。導入・接続後にログインしてアクセスを付与します。

• sosoapi
• @sosoapi/cli
• sosoapi-cli
• sosoapi-mcp

ローカルMCPクライアントを接続

以下のコマンドでcore接続を追加します。SosoAPIがすでに接続され正常なら、その接続を維持してください。引数なしのsosoapiはstdio MCPサーバーを起動し、stdinでクライアントを待ちます。

Claude Desktop、CursorなどのstdioクライアントはMCP設定に以下のJSONを追加します。場所と承認手順は異なります。必要なら再起動・接続し、会話でSosoAPIツールが使えるか確認してください。

claude mcp add sosoapi -e SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi

codex mcp add sosoapi --env SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi

{
  "mcpServers": {
    "sosoapi": {
      "command": "npx",
      "args": [
        "-y",
        "sosoapi"
      ],
      "env": {
        "SOSOAPI_TOOL_PROFILE": "core"
      }
    }
  }
}

• MCPツールリファレンス

OAuthでリモートMCPを接続

リモートMCP、OAuth、動的クライアント登録に対応するクライアントで以下のURLを追加します。ブラウザーでログインし、許可するワークスペースと操作を選んでください。APIキー、client ID、client secretの貼り付けは不要です。HTTPのメディアは公開URLからインポートします。ローカルファイルのアップロードにはローカルMCPサーバーが必要です。

ChatGPTカスタムアプリとClaudeリモートコネクターは、プランとクライアント設定に依存します。この手順はカスタム接続の設定で、アプリディレクトリ掲載の説明ではありません。

https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp

• 認証と権限

公開せずに設定を検証

認証状況を確認し、必要ならログインします。ワークスペースと接続アカウントを取得し、返された対象が意図したものか確認してください。投稿せずにアクセスを検証できます。公開の可否はアカウントの権限にも依存します。

設定完了のためにテスト投稿を公開する必要はありません。既存のコンテンツで元の作業を続けます。本人がプロバイダーの同意を完了し、依頼した書き込み前に投稿先、内容、日時を確認します。

npx sosoapi auth status

npx sosoapi api contract --route /identity-api/workspace/list --summary

更新・バージョン固定

npx -y sosoapi@latest --helpで最新のCLIを取得してから、MCPクライアントを再起動します。保存済みコマンドがある場合は、希望バージョンをargsに指定してください。エイリアスは特定のsosoapiバージョンに固定されるため、別のグローバルインストールを更新しても変わりません。

バージョン不一致エラーでは、インストール済み契約と必要な操作を比較します。MCPクライアントが実際に使うコマンドのパッケージを更新し、再接続して再試行してください。スキーマ不一致に新しい認証情報や広い権限は不要です。

npx -y sosoapi@latest --help

npx sosoapi api contract --summary

• トラブルシューティング