warp

warp-mcp

Ringer WARP プラットフォーム用の MCP サーバー — SIP トランキング、電話番号、番号ポータビリティ、メッセージング／10DLC、請求、CDR 分析に対応しています。

AI エージェント（Claude、Cursor、Copilot、Codex、ChatGPT）に WARP Customer API への完全なアクセスを提供します。トランクのプロビジョニング、番号の検索と注文、番号ポータビリティのライフサイクル、10DLC ブランド／キャンペーンの登録、SMS の送信、請求書、通話詳細分析をカバーする 135 個のツールを利用できます。

クイックスタート

# Recommended: global install — the setup wizard runs automatically
npm install -g warp-mcp

# Or run the wizard explicitly / without installing
npx -y warp-mcp setup

ウィザードは API キーを検証し、~/.warp-mcp/config.json に保存して、検出したすべての MCP クライアント（Claude Code、Claude Desktop、Cursor、Codex、GitHub Copilot、ChatGPT Desktop）にサーバーを登録します。

WARP API キー（rk_...）が必要です。WARP ポータルの Settings → API Keys から発行できます。

ワンコマンドでインストール

Claude Code

claude mcp add -s user warp -e WARP_API_TOKEN=rk_your_key -- npx -y warp-mcp

Cursor — クリックしてインストール（その後、YOUR_WARP_API_KEY を置き換えてください）

手動（任意の MCP クライアント）

{
  "mcpServers": {
    "warp": {
      "command": "npx",
      "args": ["-y", "warp-mcp"],
      "env": { "WARP_API_TOKEN": "rk_your_key" }
    }
  }
}

クライアントごとの手順、トラブルシューティング、アンインストール方法については、INSTALL.md を参照してください。

ホステッドエンドポイント

ローカルへのインストールは不要です — https://mcp.warp.ringer.tel/（Streamable HTTP）に直接接続してください。

デスクトップコネクター（claude.ai、ChatGPT）： その URL でカスタムコネクターを追加し、 プロンプトが表示されたら WARP アカウントでサインインしてください。ホステッドエンドポイントは OAuth 2.1 で認証し、お客様のスコープに限定された権限を付与します（管理機能、Buzz、 API キー管理は対象外です。これらはポータルで引き続き利用できます）。

開発者／CLI クライアント： 代わりに、ベアラー rk_ キーで認証してください。

claude mcp add --transport http warp https://mcp.warp.ringer.tel/ \
  --header "Authorization: Bearer $WARP_API_KEY"

{
  "mcpServers": {
    "warp": {
      "type": "http",
      "url": "https://mcp.warp.ringer.tel/",
      "headers": { "Authorization": "Bearer rk_your_key_here" }
    }
  }
}

キーはWARP ポータルの Settings → API Keys から発行できます。

ツール

プレフィックス	グループ	ツール数	機能
trunk_	SIP トランク	24	トランクの CRUD、SIP 認証情報、エンドポイント、IP ACL、登録
port_	番号ポータビリティ	33	番号ポータビリティの申請を最初から最後まで管理：下書き → 検証 → 送信 → 有効化、書類、TIN コンプライアンス
msg_	メッセージング	33	SMS の送信、メッセージ履歴、10DLC ブランド／キャンペーン、番号の登録、TCR 参照データ
num_	番号	15	DID の検索、注文、解放、TN ごとの音声／SMS 設定、番号ポータビリティ移出用 PIN
team_	チーム	9	メンバーと RBAC ロール
bill_	請求	5	残高、台帳、請求書（JSON + HTML）
cdr_	分析	5	通話詳細レコード、統計、傾向、CSV エクスポート
acct_ / net_ / key_	アカウント	10	容量、使用状況、スコープ、WARP ネットワーク IP、API キー監査
warp_status	診断	1	設定と接続状況の確認

このサーバーには、WARP の深いドメイン知識（ワークフロー、概念、よくある間違い）を含む warp-guide プロンプトとサーバー指示も付属しています。

環境変数

変数	デフォルト	用途
WARP_API_TOKEN	—	API キー（rk_...）。~/.warp-mcp/config.json の設定を上書きします
WARP_API_BASE_URL	https://api.warp.ringer.tel	API ベース URL の上書き
WARP_REQUEST_TIMEOUT_MS	30000	リクエストごとのタイムアウト

トークンの解決順序：環境変数 → ~/.warp-mcp/config.json → 未認証（ツールはセットアップの実行を案内します）。

開発

npm ci --ignore-scripts
npm run build   # tsc → dist/
npm test        # vitest (in-memory MCP transport)
npm run dev     # tsx src/index.ts

リリースは CI から公開します。npm version patch|minor|major を実行し、--follow-tags を付けてプッシュし、GitHub リリースを作成すると、ワークフローが npm（provenance 付き OIDC 信頼済みパブリッシング）と MCP Registry（io.github.ringer/warp）に公開します。初回リリース後は、ローカルで npm publish を実行しないでください。

ライセンス

MIT © Ringer