Instagram MCP Server（WhatsApp と Messenger にも対応）

MCP サーバー。Claude、Cursor、Claude Code、その他の MCP クライアントが、公式 Meta Business API を介して Instagram のDM、WhatsApp のメッセージ、Facebook Messenger の会話を読み取り、返信できるようにします。

アシスタントに*「Instagram で価格について質問した進入り込み客を探して、その人に予約テンプレートを送って」*と頼むと、実際のアカウントで実行されます。

なぜこれが違うか

ほとんどの Instagram・WhatsApp MCP サーバーは、個人アカウントを動かすものです。ブラウザの自動化セッション、非公式ブリッジ、あるいはリバースエンジニアリングされたモバイル API を使います。Meta が何か変えると動かなってしまい、アカウントが停止されるリスクがありう。

本サーバーは、SetSmart の Meta 承認済み Business アプリを介して、公式 Instagram Messaging API・WhatsApp Cloud API・Messenger Platform に接続します。承認されたがなくては、Instagram、WhatsApp、Messenger へのメッセージ送信をプログラムで行うことはできません。そのため、このブリッジには Instagram のパスワードではなく、SetSmart のワークスペースが必要なのです。

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

必要なもの

• Node.js 18 以降

• SetSmart のワークスペース（Instagram、WhatsApp、Messenger のうち、少なくとも1つのチャネルが接続されていること）

• Settings の Integrations から取得したワークスペースの API キー

クイックスタート

Claude Desktop / Claude Code

MCP 設定（claude_desktop_config.json。または Claude Code の .mcp.json）に追加します:

{
  "mcpServers": {
    "setsmart": {
      "command": "npx",
      "args": ["-y", "github:setsmart-git/instagram-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のツールを、操作対象ごとにグループ分けしています。

メッセージング

会話

連絡先

AI 制御

Instagram

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

意図的にできないこと

APIキー は長期間有効な静的シークレットであるため、機能を制限しています。これらは、リモートサーバー上のインタラクティブな OAuth を使用すれば実行できますが、このブリッジでは実行できません:

• 課金やサブスクリプションの変更

• ワークスペース設定

• チャネルの接続・切断

• AI アシスタントの作成・変更

• 一括削除、ブラックリスト、利用禁止国

SetSmart の設定でキーをローテーションすると、次のリクエスト時にすぐにアクセスが無効になります。

設定

動作の仕組み

このパッケージにはメッセージ送信のロジックは含まれていません。これは stdio から Streamable HTTP へのパイプです。クライアントは stdin・stdout で MCP を話し、ブリッジは Authorization ヘッダーにキーを付けて各リクエストをホスト型 SetSmart MCP サーバーに転送し、レスポンスをストリームして返します。全部で約150行で、src/index.js にあります。アカウントで信頼する前に、全体を読むことができます。

リンク

• SetSmart

• REST API ドキュメント

• Model Context Protocol

ライセンス

MIT