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

正規URL： https://sosoapi.ai/ja/docs/installation

ローカルパッケージかホスト型MCPでエージェントをSosoAPIに接続します。インストール、接続確認、更新を説明します。

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

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

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

npmパッケージ

| パッケージ | 用途 | コマンド |

| --- | --- | --- |

| sosoapi | 正規のCLI・MCPサーバー | npx -y sosoapi --help |

| @sosoapi/cli | sosoapiの特定バージョンに対応するエイリアス | npx -y @sosoapi/cli --help |

| sosoapi-cli | sosoapiの特定バージョンに対応するエイリアス | npx -y sosoapi-cli --help |

| sosoapi-mcp | sosoapiの特定バージョンに対応するエイリアス | npx -y sosoapi-mcp --help |

- [sosoapi](https://www.npmjs.com/package/sosoapi)

- [@sosoapi/cli](https://www.npmjs.com/package/@sosoapi/cli)

- [sosoapi-cli](https://www.npmjs.com/package/sosoapi-cli)

- [sosoapi-mcp](https://www.npmjs.com/package/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ツールリファレンス](https://sosoapi.ai/ja/docs/mcp)

## OAuthでリモートMCPを接続

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

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

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

- [認証と権限](https://sosoapi.ai/ja/docs/authentication)

## 公開せずに設定を検証

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

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

```
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
```

- [トラブルシューティング](https://sosoapi.ai/ja/docs/troubleshooting)