Relay

Relay MCP サーバー

Relay のリモートModel Context Protocolサーバーです。Relay は、モントリオールで開発された、チーム向けのビジネス電話・SMS アプリです。

Claude やその他の MCP クライアントから、チームの電話機能を利用できます。通話とテキストメッセージの一覧表示、通話の文字起こしの閲覧、連絡先の検索と更新、チーム番号からの SMS 送信、通話ルーティングフローの下書き作成ができます。

エンドポイント	https://api.yesrelay.com/api/mcp
トランスポート	Streamable HTTP（仕様 2025-06-18）、ステートレス
認証	Authorization: Bearer <Relay API key>
ツール	16
プラン	無料プランを含むすべてのプラン
ドキュメント	https://yesrelay.com/en/api-docs

このリポジトリにはサーバーコードは含まれていません。サーバーは Relay がホストしています。サーバー側でインストールするものはありません。

API キーを取得する

1. https://app.yesrelay.com で無料アカウントを作成します。
2. アプリで Administration を開き、Integrations & API に進んでキーを作成します。
3. キーは rk_live_ で始まり、一度だけ表示されます。シークレットマネージャーに保管してください。

アプリでキーを取り消すと、MCP と REST のアクセスが同時に遮断されます。

クライアントを接続する

Claude Code

claude mcp add --transport http relay https://api.yesrelay.com/api/mcp \
  --header "Authorization: Bearer rk_live_..."

Claude Desktop

mcp-remote を使用して claude_desktop_config.json を設定します。

{
  "mcpServers": {
    "relay": {
      "command": "npx",
      "args": ["mcp-remote", "https://api.yesrelay.com/api/mcp",
               "--header", "Authorization:${AUTH}"],
      "env": { "AUTH": "Bearer rk_live_..." }
    }
  }
}

その他のクライアント

上記の Authorization ヘッダーを指定して、https://api.yesrelay.com/api/mcp に接続してください。

ツール

通話とメッセージ

ツール	機能
relay_list_numbers	組織のチームと各チームの電話番号を一覧表示します
relay_list_calls	チームの最近の通話を新しい順に一覧表示します
relay_get_transcript	AI による要約とアクション項目を含む、通話の文字起こしを取得します
relay_list_messages	チームの最近のテキストメッセージを新しい順に一覧表示します。連絡先で絞り込めます
relay_send_sms	チーム番号からテキストメッセージを送信します。実際に送信され、料金が発生し、取り消せません

連絡先とチーム

ツール	機能
relay_search_contacts	チームの連絡先リストを、名、姓、または会社名で検索します
relay_create_contact	チームの連絡先リストに連絡先を追加します
relay_update_contact	既存の連絡先のフィールドを置き換えます
relay_list_members	組織のメンバーとその識別子を一覧表示します

フロー（通話ルーティング、Business プランおよび Scale プラン）

ツール	機能
relay_list_flows	組織の通話フローを一覧表示します
relay_get_flow	フローの稼働中のグラフと下書きを取得します
relay_flow_schema	ブロックの種類、想定されるフィールド、ルーティングエンジンのルールを取得します
relay_create_flow	テンプレートから電話番号のフローを作成します
relay_save_flow_draft	下書きを置き換えます。発信者が聞く内容は変わりません
relay_check_flow	グラフを書き込まずにテストします
relay_discard_flow_draft	下書きを破棄し、稼働中の内容に戻します

フローを公開するツールはありません。エージェントは通話経路の下書きを作成してチェックできますが、稼働状態にするにはアプリから人が操作する必要があります。

安全対策

MCP 経由で送信されるテキストメッセージには、アプリから送信する場合と同じチェックが適用されます。

拒否コード	発生条件
recipient_opted_out	受信者がこのチームに STOP（または ARRET、UNSUBSCRIBE）と返信した場合
daily_limit_reached	チームの日次上限（顧客が設定した上限、または自動設定の上限）に達した場合
workspace_budget_reached	チームの利用上限に達した場合
sending_suspended	サーキットブレーカーによって送信が一時停止されている場合。受信は引き続き可能です

利用できる機能はプランによって異なります。テキストメッセージの送信には有料プランが必要で、フローツールの利用には Business プランまたは Scale プランが必要です。

制限

プラン	キーごとの 1 分あたりのリクエスト数	キー数
Free	30	2
有料	120	5

JSON-RPC バッチ内の各メッセージは、1 件のリクエストとしてカウントされます。

トラブルシューティング

クライアントに読み取りエラーが表示されるか、curl がエラー 56（「chunk hex-length」）で失敗します。 HTTPS トラフィックを検査する一部のウイルス対策ソフトウェアが MCP の応答を破損させます。Avast でこの問題を確認しています。サーバーは正しく応答しています。ウイルス対策ソフトウェアの HTTPS スキャン対象から api.yesrelay.com を除外してから、もう一度お試しください。

401 Invalid API key。 キーが未設定、取り消し済み、または期限切れです。アプリで新しいキーを作成してください。

こちらも利用できます

• REST API：https://api.yesrelay.com/api/v1。リファレンスは https://api.yesrelay.com/docs
• 通話および SMS イベント用の署名付き Webhook（HMAC SHA-256）

サポート

[email protected]