Pushpad MCP

Pushpad MCPサーバーは、ウェブプッシュ通知の送信とPushpad上のリソース管理（通知、購読、プロジェクト、送信者のCRUD操作）をPushpad APIを使用して行います。

このプロジェクトは、公式のPushpad OpenAPI仕様とFastMCP for TypeScriptを使用して、Pushpad API上に構築された薄いレイヤーです。

セキュリティ

MCP技術を使用してPushpadアカウントとやり取りすることにはリスクが伴う可能性があります。

このMCPサーバーはPushpad APIへのフルアクセスを提供し、元に戻せない破壊的なアクション（更新、削除など）を含みます。また、APIはプッシュ購読キー（Subscriptions API）やVAPIDキー（Senders API）などの機密データを返す可能性があります。

エージェントで適切な権限モードを使用し、アクセス制限されたPushpadトークンを使用することをお勧めします。

エージェント設定で権限モードを手動に変更するか、このMCPサーバーが提供するさまざまなツールに対して許可/拒否の権限を設定できます。

送信者に保存されているVAPIDキーをAIコンテキストから除外することをお勧めします。アクセス制限されたPushpadトークンを使用するか、Senders APIへのアクセスを提供するツールを拒否することができます。

アクセストークンを秘密に保ち、Gitリポジトリに保存しないようにしてください。

Related MCP server: Dialpad Universal MCP Server

インストール

ステップ1: APIトークンを環境変数として設定する

まず、新しいPushpadトークンを作成する必要があります。Pushpadダッシュボードを開き、アカウント名をクリックし、Access tokensをクリックして新しいトークンを作成します。

次に、Pushpadトークンを環境変数として保存する必要があります。マシン全体に設定する（~/.bashrc、~/.zshrc、または他のシェルプロファイル）、パスワードマネージャー（1Password CLIなど）を使用する、プロジェクト固有の.envファイルに設定する、またはMCPクライアント設定ファイル（.mcp.jsonなど）に直接追加することができます。.env、.mcp.json、またはシークレットを含む可能性のあるその他のファイルを.gitignoreに追加することを忘れないでください。

ステップ2: MCPサーバーをAIエージェントに追加する

ローカルのMCPサーバーは、MCP JSON設定ファイルで定義された設定を使用して、MCPクライアントによって直接起動されます。このファイルの正確な場所と適用方法は、MCPクライアントによって異なります。

MCPサービスを有効にするには、mcpServersブロックにエントリを追加します：

{
  "mcpServers": {
    "pushpad": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "pushpad-mcp"],
      "env": {
        "PUSHPAD_TOKEN": "${PUSHPAD_TOKEN}"
      }
    }
  }
}

上記の例では、Pushpad MCPサーバーを${PUSHPAD_TOKEN}で設定しています。これを自分のPushpadトークンに置き換えるか、クライアント固有の変数置換方法（利用可能な場合）を使用して、トークンを設定ファイルの外に保持してください。

ステップ3: Pushpad MCPを使用する

最後に、MCPとAIエージェントを使用してPushpadとやり取りできます。

例：

Pushpadを使用して、全員にXYZに関する通知を送信する。

Pushpadを使用してユーザー123に通知を送信する。

通知98765は何回クリックされましたか？

プロジェクト456の通知のデフォルトTTLは何ですか？

MCPサーバーは、Notifications API、Subscriptions API、Projects API、Senders APIを含むPushpad API全体をサポートしています。

開発

このプロジェクトに貢献したい場合は、遠慮なくIssueを開くかプルリクエストを送信してください。

このパッケージに変更を加えたい場合、ローカル開発のためにこのリポジトリをクローンし、VS Codeをdev containerとともに使用するとセットアップが簡単になります。

その後、以下のコマンドを使用できます：

• npm run build TypeScriptプロジェクトをコンパイルする

• npm run start MCPサーバーを起動する

• npm run inspect MCPサーバーを起動し、@modelcontextprotocol/inspectorで検査する

.envファイルにPUSHPAD_TOKENを設定すると、自動的に読み取られます。

このリポジトリには、devコンテナ内のClaude Codeと、このMCPサーバーのローカルバージョンを試すために使用できる.mcp.jsonも含まれています。これは、このパッケージに変更を加える予定があり、プルリクエストを送信する前に修正版を試したい場合にのみ役立ちます。

ライセンス

このMCPサーバーはオープンソースライセンス（MIT）の下で公開されています。