SendSeven Messaging

SendSeven MCP Server

SendSeven の公式 Model Context Protocol（MCP）サーバーです。SendSeven は、WhatsApp、Instagram のダイレクトメッセージ、Telegram、SMS、Messenger、ライブチャット、メールに対応する統合メッセージング API プラットフォームです。

SendSeven アカウントを Claude、ChatGPT、Gemini、Cursor、または MCP 互換の AI アシスタントに接続すると、統合受信トレイの管理、オムニチャネルメッセージ（WhatsApp、Instagram のプライベート返信、Telegram、SMS、Messenger、メール）の送信、マーケティングキャンペーンの実施、チームチャットボットの運用、自然言語によるナレッジベースの検索ができます。これらすべてを、既存のカスタマーサポートおよびメッセージング API プラットフォームを通じて利用できます。

クイックスタート

オプション 1：リモートサーバー（推奨）

インストールは不要です。AI クライアントに追加してください。

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "sendseven": {
      "url": "https://mcp.sendseven.com/mcp",
      "auth": {
        "type": "oauth2",
        "authorizationUrl": "https://mcp.sendseven.com/authorize",
        "scopes": ["conversations:read", "messages:create", "contacts:read"]
      }
    }
  }
}

Claude Code（.claude/settings.json）：

{
  "mcpServers": {
    "sendseven": {
      "url": "https://mcp.sendseven.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

ChatGPT（Settings > Connectors > Add custom connector）：

MCP Server URL: https://mcp.sendseven.com/mcp
Authentication: OAuth

ChatGPT が OAuth 同意と機能の選択を自動的に案内するため、設定ファイルは不要です。

オプション 2：API トークン（開発者向け設定）

開発者および CI/CD パイプラインでは、静的な API トークンを使用します。

1. SendSeven で API トークンを生成します：Settings > API Tokens
2. トークンを Bearer ヘッダーとして、MCP クライアントを設定します

オプション 3：セルフホスト

git clone https://github.com/SendSeven-GmbH/sendseven-mcp-server.git
cd sendseven-mcp-server
npm install
npm run dev  # Runs on localhost:8787

何ができますか？

サポート業務

• 「未対応の会話を表示して」 - 会話の一覧表示とフィルタリング
• 「John との会話はどんな内容？」 - 会話の詳細を表示
• 「メモに『返金済み』と記載してチケット #123 を終了して」 - 会話を終了
• 「これを Sarah に割り当てて」 - チームメンバーに振り分け

メッセージング

• 「+49 170 1234567 に WhatsApp で『ご注文の商品をご用意できました』と送信して」 - マルチチャネルメッセージング
• 「会議について [email protected] にメールして」 - 最適なチャネルを自動検出
• 「VIP の顧客をすべて検索して」 - 連絡先の検索

マーケティング

• 「フラッシュセールについてプッシュ通知キャンペーンを作成して」 - キャンペーンの作成
• 「エンタープライズ向けリストにメールニュースレターを送信して」 - メールキャンペーン
• 「WhatsApp キャンペーンにはいくらかかる？」 - 費用の見積もり

ナレッジベース

• 「返金について FAQ には何と書いてある？」 - AI を活用した KB 検索
• 「WhatsApp 連携を設定するには？」 - セルフサービスでの回答

利用可能なツール

ツールは、OAuth 接続時に選択した機能に基づいて登録されます。以下の表では、見やすいようにツールを機能別に分類しています。OAuth の同意画面では、同じ 45 個のツールがより大きな 8 つの機能グループ（会話、メッセージング、メール、連絡先、キャンペーン、ナレッジベース、Webhook、チームチャットボット）にまとめられます。グループを許可すると、その下に記載されているすべてのツールが許可されます。パラメーターの全リファレンス：docs/TOOLS.md。

カテゴリー	ツール
会話	list_conversations, get_conversation, send_reply, close_conversation, reopen_conversation, snooze_conversation, assign_conversation, add_internal_note, email_conversation_transcript, get_attachment_summary
メッセージング	send_message_to_contact, send_whatsapp_template, send_email, upload_attachment
連絡先	search_contacts, create_contact, update_contact
タグ	list_tags, create_tag, tag_conversation, untag_conversation, tag_contact, untag_contact
キャンペーン	list_contact_lists, list_campaigns, get_campaign_status, create_and_send_campaign, list_email_campaigns, get_email_campaign_analytics
ナレッジベース	query_knowledge_base, list_knowledge_base_folders
チャネル	list_channels, list_email_mailboxes, list_verified_email_domains, list_whatsapp_templates, get_whatsapp_template
チーム	list_team_members, set_out_of_office, end_out_of_office
チームチャットボット	list_team_chat_channels, send_team_chat_channel_message, send_team_chat_direct_message
Webhook（開発者向け）	list_webhooks, create_webhook, delete_webhook

認証

OAuth 2.0 + PKCE（推奨）

このサーバーは MCP クライアント向けの完全な OAuth 2.0 認可サーバーであり、アプリを事前登録する必要のない動的クライアント登録（DCR）に対応しています。

エンドポイント	URL
MCP エンドポイント	https://mcp.sendseven.com/mcp（ストリーミング可能な HTTP）
認可	https://mcp.sendseven.com/authorize
トークン	https://mcp.sendseven.com/token
動的クライアント登録	https://mcp.sendseven.com/register

ほとんどの MCP クライアント（Claude、Cursor など）は、https://mcp.sendseven.com/mcp からこれらを自動的に検出するため、必要なのはベース URL だけです。上記の claude-desktop.json の例と examples/ ディレクトリを参照してください。フローの詳細な手順が必要なクライアントの場合：

1. クライアントは DCR（POST /register）を使って自身を登録し、client_id を受け取ります。
2. クライアントは PKCE の code_challenge と要求するスコープを指定して、ユーザーを /authorize に誘導します。
3. ユーザーは SendSeven アカウントでログインし、同意画面で要求されたスコープを許可します。
4. 認可コードを /token で引き換え、PKCE の code_verifier を使ってアクセストークンとリフレッシュトークンを取得します。
5. すべての MCP リクエストでアクセストークンを Bearer トークンとして送信します。サーバーはリフレッシュトークンを使って自動的に更新します。

ユーザーが許可できるのは、SendSeven で割り当てられているロールがすでに持つスコープのみです。キャンペーンの権限を持たないサポートエージェントには、クライアントが何を要求してもキャンペーンツールは表示されません。

API トークン（開発者向け）

SendSeven のダッシュボード（設定 > API トークン）でトークンを生成し、Bearer ヘッダーとして渡します。CI/CD やスクリプトではより簡単ですが、自動更新されないため、手動でローテーションする必要があります。

Claude スキル

このリポジトリには、AI アシスタントにベストプラクティスを教えるワークフローガイド（スキル）が含まれています。

• キャンペーンの作成 - キャンペーンのワークフローをステップごとに説明
• 会話の管理 - トリアージ、返信、解決
• 連絡先へのメッセージ送信 - 連絡先を見つけてメッセージを送信
• チームチャットボット - チームチャットのチャネルやユーザーにボットメッセージを投稿

設定例

設定ファイルについては、examples/ ディレクトリを参照してください。

• claude-desktop.json - Claude Desktop
• claude-code.json - Claude Code CLI
• cursor.json - Cursor IDE

料金

すべての SendSeven ユーザーが無料で利用できます。 MCP サーバーへのアクセスは、すべてのプランに含まれています。

• 読み取り操作：無制限（レート制限の範囲内）
• 書き込み操作：通常の API 使用量として課金されます
• レート制限：プランに応じて 20～500 req/min

開発

# Install dependencies
npm install

# Run locally
npm run dev

# Run tests
npm test

# Type check
npm run typecheck

# Deploy to Cloudflare Workers
npm run deploy

セキュリティ

• PKCE を使用した OAuth 2.0（ブラウザーにクライアントシークレットは不要です）
• すべてのトークンは保存時に暗号化されます
• スコープベースのアクセス制御（27 個の詳細な OAuth スコープを、同意時に選択する 8 つの機能グループに分類）
• テナント分離（他のテナントのデータにはアクセスできません）
• プランごとのレート制限
• SendSeven の設定からトークンを無効化できます

ライセンス

MIT - LICENSE を参照してください

リンク

• SendSeven - 統合メッセージング API
• MCP Specification - Model Context Protocol
• API ドキュメント - SendSeven REST API