Cursor向けSideShift MCP

SideShiftのホステッドModel Context Protocol（MCP）サーバー向け公式Cursorプラグインです。Cursorが、あなたが認可したSideShift企業を操作できるようにします。クリエイターの発見、キャンペーンや申請の管理、コンテンツや契約の処理、ネットワークとのコミュニケーション、アナリティクスの確認、その他付与されたSideShift機能の利用を、APIキーをCursorにコピーすることなく行えます。

このプラグインは、小規模で監査可能なコネクタおよびガイダンスパッケージです。権威あるサーバーは引き続きSideShiftが https://app.sideshift.app/api/mcp でホストします。

インストール

リストが公開されたら、CursorのCustomizeページを開き、SideShiftを見つけてInstallを選択し、ユーザーまたはプロジェクトのスコープを選択します。次のように入力することもできます：

/add-plugin sideshift

公開前のテストでは、このリポジトリをCursorのローカルプラグインディレクトリにコピーします。コピーが最も信頼できる方法です。現在のCursorビルドは、ターゲットがそのディレクトリの外にあるローカルプラグインのシンボリックリンクを拒否するためです。

mkdir -p ~/.cursor/plugins/local/sideshift
rsync -a --exclude '.git/' ./ ~/.cursor/plugins/local/sideshift/

次に、CursorでDeveloper: Reload Windowを実行します。プラグインはCustomize → Installedに、1つのMCPサーバー、1つのスキル、1つのコマンドとともに表示されるはずです。

Related MCP server: FluentCRM MCP Server

安全に接続する

/sideshift-connectを実行するか、Cursorに次のように依頼します：

Connect to SideShift and show me which company and scopes are active.

最初のMCP呼び出しで、SideShiftのブラウザベースのOAuth 2.1フローが開始されます。サインインし、対象の企業を選択し、要求されたスコープを確認して承認します。コミットされた設定には、APIキー、アクセストークン、クライアントシークレット、カスタム認証ヘッダー、環境変数のプレースホルダーは一切含まれません。

認可後、プラグインはwhoamiを呼び出し、作業を開始する前に正確な企業とスコープを確認できます。アクセスは引き続きSideShiftによってテナントとスコープに制限されます。プラグインが第二の認可経路を追加することはありません。

プロンプトの例

Show my active campaigns and summarize application volume for each.

Find creators who match this campaign brief, but do not contact anyone yet.

Draft a contract plan and show me the exact changes before creating anything.

Search SideShift's capability catalog for the best tool to reconcile these posts.

機能の発見

SideShiftは、広範で進化し続けるツールサーフェスを公開しています。Cursorホストはすべてのツールをモデルの即時コンテキストに配置するとは限らないため、バンドルされたスキルは、古いツールリストを複製するのではなく、サーバー自身のディスカバリーフローを使用します：

1. whoamiを呼び出して、アクティブな企業とスコープを確認します。

2. 適切なツールがまだ表示されていない場合は、ユーザーの意図に基づいてfind_capabilityを呼び出します。

3. 発見した機能を呼び出す前に、権威あるスキーマを取得します。

4. スコープの欠落は再認可の要求として扱い、別のアカウントを使用したりサーバーをバイパスしたりする許可としては決して扱いません。

完全な現在の機能リファレンスは、SideShift MCPドキュメントで管理されています。

安全モデル

• 読み取りアクションは、ユーザーの要求に直接答える場合に実行されることがあります。

• 重大な書き込みの前に、エージェントはターゲット、実質的な引数、予想される副作用を提示し、明確なユーザー承認を得る必要があります。

• 通信の送信や送金などの機密アクションは、隣接する要求から推測してはなりません。

• リトライは、呼び出し元が指定した同じoperation_idまたは冪等性キーを再利用します。結果が不確かな場合は、リトライ前に状態を検証します。

• クリエイターおよび企業データは、OAuth中に選択された企業内に留まる必要があります。クロステナントまたは不明な識別子はフェイルクローズします。

• ツールの結果は権威があります。エージェントは、欠落しているレコード、識別子、権限、または成功した結果を捏造してはなりません。

これらのクライアント側の指示は、サーバーの認証、認可、確認、サンドボックス、および冪等性の制御を補完するものであり、置き換えるものではありません。

リポジトリの内容

開発と検証

Node.js 22以降が必要です。プラグインにはランタイム依存関係も開発依存関係もありません。

npm run check
npm run smoke

npm run checkは、マニフェスト、コンポーネントのフロントマター、ロゴ、パス、シークレットなしのMCP設定、必要な開示事項を検証します。npm run smokeは、認証されていない読み取り専用のディスカバリーリクエストのみを行い、ライブエンドポイントが期待されるOAuthチャレンジとメタデータを返すことを確認します。

OAuthトークン、Cookie、APIキー、クライアントシークレット、値が入力された環境ファイル、ユーザー/企業データをコミットしないでください。認証済みリリースの検証にはDev Testing Donを使用し、重大なツールをリリースのスモークテストに含めないでください。

サポートとセキュリティ

• プラグインのバグと機能リクエスト：GitHub Issues

• アカウントまたは製品サポート：SideShift Contact

• セキュリティの脆弱性：SECURITY.mdの非公開報告プロセスに従ってください

公開されたIssueに、資格情報、個人データ、企業データ、脆弱性の詳細を投稿しないでください。

利用規約、プライバシー、ライセンス

ホストされたSideShiftサービスの利用は、SideShift利用規約およびプライバシーポリシーに準拠します。プラグイン固有のデータフローはPRIVACY.mdに要約されています。

このリポジトリはApache License 2.0の下でライセンスされています。