ChatRail

ChatRail MCP サーバー

Claude、Cursor、VS Code など、あらゆる Model Context Protocol クライアントから ChatRail ワークスペースを操作できます。WhatsApp 接続の状態を確認したり、グループを検索したり、メッセージが失敗した理由を調べたり、予約メッセージを管理したり、エディターを離れずに Webhook の配信を再実行したりできます。

ChatRail は開発者向けの WhatsApp API です。すでにお持ちの電話番号を使って、HTTP 経由で WhatsApp メッセージを送受信できます。詳細については、MCP ドキュメントをご覧ください。

プライバシーを重視した設計

• メッセージ本文、受信者の電話番号、認証情報がツールから返されることはありません。
• 状態を変更するツールは、まずプレビューを返し、confirm: true を指定して再度呼び出した場合にのみ変更を適用します。
• すべての呼び出しは 1 つのワークスペースに限定され、その監査ログに記録されます。

2 つの接続方法

1. OAuth を使用したホスト型サーバー（推奨）

リモート MCP サーバーに対応した任意のクライアントから、次の URL を指定します。

https://www.chatrail.dev/v1/mcp

クライアントがブラウザーウィンドウを開き、ワークスペースの所有者、管理者、または開発者がアクセスを承認します。インストールもキーのコピーも不要です。

Claude Code

claude mcp add --transport http chatrail https://www.chatrail.dev/v1/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "chatrail": { "url": "https://www.chatrail.dev/v1/mcp" }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "chatrail": { "type": "http", "url": "https://www.chatrail.dev/v1/mcp" }
  }
}

2. API キーを使用したローカル stdio サーバー

ローカルサーバーのみを実行するクライアント向け、または API キーを使用したい場合の方法です。このパッケージはお使いのマシン上で実行され、リクエストをホスト型サーバーに転送します。

1. ChatRail ダッシュボードで、mcp:read スコープを持つワークスペース API キーを作成します。アシスタントが予約の変更、キャンセル、リアクションの設定、または再実行を行う場合は、mcp:write を追加してください。
2. サーバーをクライアントに追加します。

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "chatrail": {
      "command": "npx",
      "args": ["-y", "chatrail-mcp"],
      "env": { "CHATRAIL_API_KEY": "cr_live_..." }
    }
  }
}

このパッケージは npm で chatrail-mcp として公開されているため、npx がレジストリから取得します。まだ公開されていないバージョンが必要な場合は、代わりにリポジトリから直接実行してください。

"args": ["-y", "github:chatrail/chatrail_mcp"]

Docker

docker build -t chatrail-mcp .
docker run -i --rm -e CHATRAIL_API_KEY=cr_live_... chatrail-mcp

変数	必須	説明
CHATRAIL_API_KEY	ツールの呼び出しに必要	mcp:read（および任意で mcp:write）を持つワークスペース API キーです。
CHATRAIL_MCP_URL	いいえ	エンドポイントを上書きします。デフォルトは https://www.chatrail.dev/v1/mcp です。

キーがなくてもサーバーは起動してツールを一覧表示するため、登録前に内容を確認できます。

ツール

ツール	スコープ	機能
list_connections	read	ワークスペース内のすべての WhatsApp 接続と、その状態および健全性を表示します。
get_connection	read	1 つの接続と、その状態、健全性、最近の状態履歴を表示します。
list_whatsapp_groups	read	接続された番号から確認できるグループと、その ID および参加者数を表示します。
get_whatsapp_group	read	1 つのグループの名前、説明、設定、メンバー数を表示します。
list_messages	read	最近のメッセージと、その配信状態を表示します。
get_message	read	1 つのメッセージと、その配信タイムラインを表示します。
explain_message_failure	read	メッセージが失敗した理由を構造化して説明します。
list_scheduled_messages	read	送信待ちのメッセージを、送信時刻が早い順に表示します。
list_webhook_deliveries	read	最近の Webhook 配信と、その結果を表示します。
reschedule_message	write	予約メッセージの送信時刻を変更します。まずプレビューを表示します。
cancel_scheduled_message	write	未送信のメッセージをキャンセルします。まずプレビューを表示します。
react_to_message	write	メッセージの絵文字リアクションを設定または削除します。まずプレビューを表示します。
replay_webhook	write	失敗またはスキップされた Webhook 配信を再度キューに追加します。まずプレビューを表示します。

プラン

MCP アクセスは ChatRail の Core + AI プランおよび Team プランに含まれています。料金をご覧ください。

開発

npm install
npm run build
CHATRAIL_API_KEY=cr_test_... node dist/index.js

tools.json は、API キーが設定されていない場合に提供されるツールカタログです。ホストされたサーバーからエクスポートされており、ホスト側のツールが変更されたときに更新してください。

エージェントスキル

ChatRail は、エージェントに ChatRail をいつ使用するか、ユーザーが何を設定する必要があるか、送受信の方法、送信時のルールを伝えるスキルファイルを公開しています。この MCP サーバーはワークスペースを操作するもので、メッセージを送信できないため、スキルでは送信に REST API を使用するよう案内しています。

エージェントに次の行を指定してください。

Read https://www.chatrail.dev/SKILL.md and follow it to set up ChatRail.

または、GitHub リポジトリからエージェントスキルをインストールする skills CLI を使ってインストールしてください。

npx skills add chatrail/chatrail_mcp

または、手動で Claude Code にコピーしてください。

mkdir -p ~/.claude/skills/chatrail
curl -fsSL https://www.chatrail.dev/SKILL.md -o ~/.claude/skills/chatrail/SKILL.md

正規ファイルは https://www.chatrail.dev/SKILL.md です。GitHub からスキルをインストールするツールが見つけられるよう、このリポジトリにも skills/chatrail/SKILL.md のコピーを置いています。

リンク

• ウェブサイト：https://www.chatrail.dev
• MCP ドキュメント：https://www.chatrail.dev/mcp
• API リファレンス：https://www.chatrail.dev/api-reference
• 認証：https://www.chatrail.dev/auth.md
• エージェントスキル：https://www.chatrail.dev/SKILL.md

ライセンス

MIT