DialMCP

DialMCP Connector

AI エージェントに電話を持たせましょう。
DialMCP 用のオープンソースコネクターです。AI エージェントが、本人確認済みの自分の電話番号から実際に電話をかけられるホスト型 MCP サーバーです。

これは何ですか

DialMCP は、https://mcp.dialmcp.com/mcp にあるリモート MCP サーバーです。OAuth を使った Streamable HTTP に対応するクライアントであれば、直接接続できます。インストールも API キーも不要です。そうしたクライアントでは、このパッケージは必要ありません。

このリポジトリは、次の 2 つの目的で存在します。

1. ローカルサーバーのみをサポートするクライアント向けの stdio ブリッジ。 一部の MCP クライアントは、まだリモートサーバーと通信できません。dialmcp-connector は、ホスト型エンドポイントにプロキシするローカル stdio サーバーを起動し、OAuth のブラウザーフローを代行します。
2. DialMCP 連携に関する、オープンで公式なドキュメント。 ツールのスキーマ、クライアント設定、server.json レジストリーマニフェスト、安全性モデルを、監査可能な 1 か所にまとめています。

ホスト型の通話サービス自体はクローズドソースです。このコネクターは MIT ライセンスで、独自のロジックは含みません。公開エンドポイントを利用する薄いトランスポートシムです。

クイックスタート

直接接続（推奨）

クライアントがリモート MCP サーバーに対応している場合、このパッケージは使わずに接続してください。

URL:        https://mcp.dialmcp.com/mcp
Transport:  Streamable HTTP
Auth:       OAuth 2.1 (sign in with your phone number)

claude mcp add --transport http dialmcp https://mcp.dialmcp.com/mcp
# add --scope user to enable it in every project

[mcp_servers.dialmcp]
url = "https://mcp.dialmcp.com/mcp"

初回接続時には、サインイン用のブラウザーウィンドウが開きます。SMS コードで電話番号を確認すると、その番号が発信者番号になります。

このコネクター経由（stdio のみ対応するクライアント向け）

npx dialmcp-connector

または、MCP クライアントの設定に次のように記述します。

{
  "mcpServers": {
    "dialmcp": {
      "command": "npx",
      "args": ["-y", "dialmcp-connector"]
    }
  }
}

すぐに貼り付けて使える設定例は、examples/ をご覧ください。

ツール

API は設計上、非同期です。place_call は通話 ID をすぐに返し、エージェントは get_call をポーリングするため、数分に及ぶ通話でもクライアントのツールタイムアウトを超過しません。

通話が完了すると、get_call は achieved、partially_achieved、not_achieved のいずれかの構造化された結果を返します。結果には、概要、相手が行った約束、推奨されるフォローアップ、会話ターンごとの文字起こし、署名付きの音声録音リンクが含まれます。

通話中、サービスは自動音声応答システムの番号を押し、保留音の間は無言で待機し、留守番電話を検知した場合はメッセージを残さずに切断します。

安全モデル

すべての保護措置はサーバー側で適用され、エージェントが説得して覆せるようなモデルへの指示ではありません。

• 情報開示。 通話はすべて、依頼内容を伝える前に、AI アシスタントであること、誰のために電話しているか、通話が録音されることを伝えるところから始まります。各通話記録に対してコンプライアンスを独立して検証し、記録します。エージェントがAIであることを否定することはなく、通話相手が異議を唱えた場合は通話を終了します。
• お客様ご自身の電話番号。 発信時には、お客様ご自身のSMS認証済み発信者番号が表示されます。番号の偽装は行われず、受信者は折り返し電話できます。
• レート制限。 同時通話1件・1時間あたり3件・1日あたり10件・同じ宛先には1日あたり最大2件・デフォルト6分、ハード上限10分（ウォッチドッグによる強制）。一括発信は設計上不可能です。
• 時間と地域。 宛先の現地時間で8:00～21:00（TCPAに準拠）、米国とカナダのみです。不明なタイムゾーンは慎重に扱います。
• 回避不可能なブロックリスト。 緊急サービス（911）、プレミアム料金の回線（900/976）、不正利用リスクの高い番号帯には、決して発信できません。
• 恒久的なオプトアウト。 通話拒否の要求は通話中に確認し、独立した別の通話記録レビューでも検出して、恒久的に保存し、すべてのユーザーにわたってプラットフォーム全体で適用します。公開のセルフサービスによるオプトアウトはこちらです：https://mcp.dialmcp.com/opt-out — アカウントは不要です。
• 客観的な審査。 独立した審査担当者が、発信前に各通話の申告された目的について、嫌がらせ、欺瞞、不正行為がないか審査します。エージェントはタスクで提供された事実のみを伝えます。
• 禁止されている用途。 テレマーケティング、面識のない相手への営業電話、自動音声電話、アンケート、見込み客の獲得、債権回収、政治的な働きかけは、利用規約で禁止されています。

詳細はこちら：https://dialmcp.com/safety.html

必要条件

• Node.js 18以降（stdioブリッジを使用する場合のみ）
• SMS認証用の米国またはカナダの携帯電話番号
• ユーザーは18歳以上である必要があります

リンク

• ウェブサイト — https://dialmcp.com
• 安全性とスパム対策 — https://dialmcp.com/safety.html
• プライバシー — https://dialmcp.com/privacy
• 利用規約 — https://dialmcp.com/terms
• 通話拒否のオプトアウト — https://mcp.dialmcp.com/opt-out
• サポート — [email protected]

リリース

各リリースは2か所に公開されます。npm（dialmcp-connector）と 公式MCP Registry（com.dialmcp/dialmcp）です。どちらも .github/workflows/release.ymlによって自動化されています。

リリースの作成

1. 両方のpackage.jsonとserver.jsonでversionを更新します。値が一致しない場合、npm run validate:manifestは失敗し、CIはプッシュのたびにこの検証を実行します。
2. mainにマージします。
3. Releaseワークフローを手動で実行し（Actions → Release → Run workflow、dry_runはオンのままにします）、成功するまで待ちます。これにより、tarballがパッケージ化され、公開を行わずにserver.jsonがレジストリのライブスキーマに対して検証されます。
4. vX.Y.Zタグを付けてGitHub Releaseを公開します。タグがpackage.jsonと一致しない場合、公開前にワークフローが停止します。

ステップ3に2分かける価値はあります。レジストリのバージョンは不変で、非公開にはできません。 問題のあるバージョンは、より大きい番号のバージョンで置き換えるか、非推奨としてマークするしかありません。

ワークフローの処理内容

--provenance は、tarball をビルドしたコミットとワークフローの実行に結び付ける署名済み証明を付与します。そのため、このジョブには id-token: write が必要です。

レジストリへの公開を別のジョブにしている理由は 2 つあります。まず、npm への反映を待つ必要があります。レジストリは、新しく公開されたバージョンを取得して mcpName フィールドを読み取ることで所有権を証明しますが、npm に反映されるまでは 404 になります（このジョブは約 2.5 分間リトライします）。また、このジョブは署名キーを保持します。このキーはこのパッケージだけでなく、com.dialmcp 名前空間全体に適用されるため、保護された環境に置かれています。この環境を publish ジョブに適用していないのは意図的です。ブランチポリシーで v* タグのみが許可されており、ジョブ全体に適用すると、main からの手動ドライランが完全にブロックされるためです。

初回のみの設定

TXT レコードは SPF と同様にドメイン名そのものに設定します。_mcp. セレクターは読み取られず、不明瞭な署名エラーになります。署名のタイムスタンプは ±15 秒の許容範囲なので、ランナーの時計は正確である必要があります。

貢献

コネクター、ドキュメント、クライアント設定に関する Issue やプルリクエストを歓迎します。ホスト型サービス自体のバグは、[email protected] にご連絡ください。セキュリティに関する報告の前に、SECURITY.md をお読みください。

ライセンス

MIT © Datawizz Inc. 詳細は LICENSE をご覧ください。