SetSmart

Instagram MCP サーバー（WhatsApp と Messenger にも対応）

Claude、Cursor、Claude Code、その他あらゆる MCP クライアントが、Meta の公式ビジネス API を通じてInstagram の DM、WhatsApp のメッセージ、Facebook Messenger の会話を読み取り、返信できるMCP サーバーです。

アシスタントに「Instagram で料金について問い合わせてきた見込み客を見つけて、予約用テンプレートを送信して」と頼めば、実際のアカウントで実行されます。

このサーバーの特長

多くの Instagram と WhatsApp の MCP サーバーは、ブラウザーの自動操作セッション、非公式のブリッジ、リバースエンジニアリングされたモバイル API を使って、個人アカウントを操作します。Meta が何かを変更すると動作しなくなり、アカウントが無効化されるリスクもあります。

このサーバーは、SetSmart の Meta 承認済みビジネスアプリを通じて、公式の Instagram Messaging API、WhatsApp Cloud API、Messenger Platform と通信します。Instagram、WhatsApp、Messenger でプログラムからメッセージを送るには、承認済みのアプリが必要です。そのため、このブリッジでは Instagram のパスワードではなく、SetSmart のワークスペースが必要になります。

率直に言えば、これはトレードオフです。ご自身のアカウントに対してセルフホストすることはできず、SetSmart API キーが必要です。

要件

• Node.js 18 以降
• 少なくとも 1 つのチャネル（Instagram、WhatsApp、Messenger）が接続された SetSmart ワークスペース
• ワークスペースの API キー（Settings の Integrations から取得）

クイックスタート

Claude Desktop / Claude Code

MCP 設定（claude_desktop_config.json、または Claude Code の場合は .mcp.json）に以下を追加します。

{
  "mcpServers": {
    "setsmart": {
      "command": "npx",
      "args": ["-y", "setsmart-mcp"],
      "env": {
        "SETSMART_API_KEY": "your-workspace-api-key"
      }
    }
  }
}

Cursor

同じブロックを ~/.cursor/mcp.json に追加します。

ブリッジを使わないリモート MCP

SetSmart MCP サーバーには、OAuth を使った Streamable HTTP でも直接接続できます。そのため、リモート MCP に対応するクライアントでは、このパッケージをまったく使わずに済みます。

https://setsmart.io/api/mcp

クライアントが stdio のみに対応している場合、または対話型の OAuth 同意ではなく静的な API キーで認証したい場合に、このブリッジを使ってください。

ツール

30 個のツールを、操作対象ごとに分類しています。

メッセージ

ツール	機能
message_send_text	Instagram、WhatsApp、Messenger でテキストメッセージを送信します
message_send_image	画像を送信します
message_send_video	動画を送信します
message_send_audio	音声メッセージを送信します
message_send_template	承認済みの WhatsApp テンプレートを送信します
message_send_reaction	メッセージにリアクションします

会話

ツール	機能
conversation_list	ワークスペース内の会話を一覧表示します
conversation_search	名前、番号、または内容で会話を検索します
conversation_get	1 件の会話とそのステータスを読み取ります
conversation_get_messages	メッセージ履歴を読み取ります
conversation_add_tag	会話にタグを付けます
conversation_remove_tag	タグを削除します
conversation_set_notes	内部メモを記録します

連絡先

ツール	機能
contact_find	電話番号、メールアドレス、Instagram ユーザー名、またはタグで連絡先を検索します
contact_get	1 件の連絡先を読み取ります
contact_import	連絡先を作成します
contact_add_tags	タグを追加します
contact_remove_tags	タグを削除します

AI の制御

ツール	機能
ai_get_all_status	AI アシスタントが有効になっている場所を確認します
ai_pause_conversation	担当者に引き継ぐため、1 件の会話でアシスタントを停止します
ai_resume_conversation	会話をアシスタントに戻します
ai_pause_channel	チャネル全体を一時停止します
ai_resume_channel	チャネルを再開します

Instagram

ツール	機能
instagram_post_list	アカウントの投稿を一覧表示します
instagram_post_get_triggers	投稿のコメントトリガーを読み取ります
comment_reply_get_auto_reply	コメントへの自動返信設定を読み取ります

スケジュール、テンプレート、統計

ツール	内容
scheduled_list	送信予定で、まだ送信されていないメッセージを一覧表示します
scheduled_cancel	スケジュール済みメッセージをキャンセルします
template_list	メッセージテンプレートを一覧表示します
analytics_stats	会話と返信の統計を読み取ります

意図的に対応していない機能

API キーは有効期間の長い静的なシークレットであるため、利用できる機能を制限しています。以下の機能にはリモートサーバーでのインタラクティブな OAuth を通じてアクセスできますが、このブリッジ経由では利用できません。

• 請求とサブスクリプションの変更
• ワークスペース設定
• チャンネルの接続または切断
• AI アシスタントの作成または書き換え
• 一括削除、ブラックリスト、ブロック対象の国

SetSmart の設定でキーをローテーションすると、次のリクエストからすぐにアクセスが取り消されます。

設定

変数	デフォルト	用途
SETSMART_API_KEY	required	ワークスペースの API キー
SETSMART_MCP_URL	https://setsmart.io/api/mcp	上流エンドポイントを上書きします

仕組み

このパッケージにはメッセージングのロジックは含まれていません。stdio と Streamable HTTP をつなぐパイプです。クライアントは stdin と stdout を通じて MCP で通信し、ブリッジは各リクエストを Authorization ヘッダーにキーを含めてホストされた SetSmart MCP サーバーに転送し、応答をストリーミングして返します。約 150 行のコードが src/index.js にあるため、アカウントを預ける前にすべてを確認できます。

リンク

• SetSmart
• REST API ドキュメント
• Model Context Protocol

ライセンス

MIT