Suprsend Mcp Server

Name: Suprsend Mcp Server
Author: suprsend

ローカル

suprsend.com開発ツール125 日前に更新

リポジトリ公式サイト

Suprsend Mcp Server について

Suprsend CLIは、SuprSend APIを操作するコマンドラインツールで、通知ワークスペースの資産や環境設定の管理に使えます。AIツールの接続には、非推奨の内蔵サーバーではなく、ホスト型MCPサーバーを推奨しています。

主な機能

01テンプレート、ワークフロー、イベントの管理
02ワークスペース間での資産同期
03複数言語の型付きコード生成
04複数アカウントと環境の設定

活用シーン

01通知ワークスペースの資産確認や反映
02ワークスペース間での資産移行
03スキーマからの型付きコード生成

MCP 対応

READMEでは、CLI内蔵のMCPサーバーは非推奨とされ、AIクライアントには https://mcp.suprsend.com/mcp のホスト型サービスが推奨されています。旧サーバーは、サービストークン認証またはセルフホスト型BYOCで利用できます。

#notifications #email #sms #push #in-app #mcp-notification #whatsapp #slack #workflows #multi-channel #developer-tools

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "cli-suprsend": {
      "command": "npx",
      "args": [
        "-y",
        "suprsend"
      ],
      "env": {
        "SUPRSEND_SERVICE_TOKEN": "<SUPRSEND_SERVICE_TOKEN>",
        "SUPRSEND_BASE_URL": "<SUPRSEND_BASE_URL>",
        "SUPRSEND_MGMNT_URL": "<SUPRSEND_MGMNT_URL>"
      }
    }
  }
}

起動コマンドnpx -y suprsend

設定が必要な環境変数

SUPRSEND_SERVICE_TOKENシークレットSuprSend service token. Create one in the SuprSend dashboard under Developers → API Keys.

SUPRSEND_BASE_URLBase API URL. Only set for BYOC / self-hosted SuprSend instances.

SUPRSEND_MGMNT_URLManagement API URL. Only set for BYOC / self-hosted SuprSend instances.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npmsuprsend1.0.1stdio

ツール

掲載時のツール一覧 · 2 週間前に更新

パラメーター	型	必須	説明
object_id	string	はい	サブスクリプションを取得するオブジェクトの object_id。
workspace	string	いいえ	オブジェクトの取得元となる Suprsend ワークスペース。
properties	object	いいえ	ユーザー／オブジェクトのプロパティ
recipients	array	はい	オブジェクトを購読しているユーザーとオブジェクト
object_type	string	はい	取得するオブジェクトの種類。

詳細

SuprSend CLI

SuprSend CLI は、SuprSend API を操作するための Go 製コマンドラインインターフェースツールです。AI エージェント（Claude、Cursor、VS Code、Gemini など）を SuprSend に接続するには、CLI ではなくホスト型の SuprSend MCP サーバーを使用してください。

できること

ワークスペースのリソースを管理 — template、workflow、schema、event、category、translation、workspace。ほとんどのコマンドは、ローカルの作業ディレクトリに対して list、get、pull、push、commit をサポートします（event に commit はなく、category に get はなく、workspace は list のみです）。
ワークスペース間で同期 — suprsend sync は、ローカルディレクトリ（デフォルトは ./suprsend）を中間ストレージとして使用し、あるワークスペースからアセットを取得して別のワークスペースにプッシュおよびコミットします（変更は移行先に反映されます）。
型付きペイロードコードを生成 — suprsend generate-types は、イベント／ワークフローの JSON Schema から、Go、TypeScript、Python、Java、Kotlin、Swift、Dart の型付きコードを生成します。
MCP サーバー（非推奨） — suprsend start-mcp-server は引き続き動作しますが、非推奨です。https://mcp.suprsend.com/mcp のホスト型 MCP サーバー（Claude Code の場合：claude mcp add --transport http suprsend https://mcp.suprsend.com/mcp）、または suprsend/claude-plugin と suprsend/agent-plugin プラグインを使用してください。Gemini CLI の場合：~/.gemini/settings.json の mcpServers の下に "suprsend": {"httpUrl": "https://mcp.suprsend.com/mcp"} を追加し、/mcp auth suprsend を実行してください（Gemini CLI 拡張機能は提供終了しています）。サービス認証トークン認証またはセルフホスト（BYOC）インスタンスが必要な場合に限り、start-mcp-server を引き続き使用してください。
複数アカウント／複数環境のプロファイル — suprsend profile add|modify|list|use|remove は、アカウントごとの認証情報とベース URL を保存するため、同じ CLI をパブリッククラウド、BYOC、ステージング、プレプロダクションなどで使用できます。

コマンドの完全なリファレンス：docs.suprsend.com/reference/cli-intro。または suprsend --help を実行すると、コマンドツリーを確認できます。

インストール

npm / npx

インストールせずに実行します：

npx suprsend --help

または、グローバルにインストールします：

npm i -g suprsend
suprsend --help

macOS、Linux、Windows（x64 と arm64）で動作します。Node.js ≥ 18 が必要です（npx の場合）。

Homebrew

Homebrew を使用して SuprSend CLI をインストールできます：

brew tap suprsend/tap
brew install --cask suprsend

バイナリリリース

各種プラットフォーム向けにコンパイル済みのバイナリをリリースページから入手できます。

ソースからビルド

ソースから SuprSend CLI をビルドするには、次の手順に従ってください：

Go がシステムにインストールされていることを確認します（バージョン 1.27.3 以降 — go.mod を参照）。

リポジトリをクローンします：

git clone https://github.com/suprsend/cli.git
cd cli/cmd/suprsend

バイナリをビルドします：
```
go build -o suprsend
```
バイナリは現在のディレクトリに作成されます。簡単にアクセスできるよう、PATH 内の場所に移動できます：
```
sudo mv suprsend /usr/local/bin/
```

これで、ターミナルのどこからでも suprsend コマンドを使用できます。

使用方法

インストール後、suprsend コマンドを実行して CLI を使用できます。例：

suprsend --help

ドキュメント

ドキュメントはこちらを参照してください。cobra で生成されたドキュメントを確認する場合はこちらを参照してください。

コントリビューション

コントリビューションを歓迎します！お気軽にプルリクエストを送信してください。

ビルド成果物をローカルで生成する

make build は、埋め込み用の type-morph Deno バイナリをコンパイルし（Deno が必要です）、その後、CLI ドキュメントを docs/ に、AI スキルを skills/ に生成します。

make build

main への PR では、CI チェックにより docs/ と skills/ が最新であることが検証されます。PR を作成する前に make build を実行し、生成されたファイルをコミットしてください。どちらもコマンド定義から生成されるため、生成ファイルではなくコマンドのヘルプテキストを編集してください。

ユニットテストを実行するには（パッケージがコンパイル時に参照する埋め込みバイナリを作成するため、先に make build を実行してください）：

go test ./...

ローカルのビルド成果物を削除する

make clean

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。

Markdown 対応

ログインしてコメント

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。