Salvy

Salvy MCP サーバー

AI エージェントを、ブラジルの法人向け携帯通信事業者である Salvy に接続します。エージェントは会社の電話回線、利用状況、請求書、従業員を確認し、回線の停止やプラン変更などを実行できます。

このリポジトリではサーバーについてのみ説明します。サーバー自体は Salvy が次の場所でホストしています。

https://mcp.salvy.com.br/mcp

• トランスポート：Streamable HTTP
• 認証：OAuth 2.0。Salvy ダッシュボードのアカウント（app.salvy.com.br）でサインインします。エージェントが実行できる操作は、そのアカウントでダッシュボード上から実行できる操作に限られます。
• 詳細ガイド（ポルトガル語）：docs.salvy.com.br/mcp-guide

できること

• 回線の状況を確認します。 電話回線、データ使用量、SMS メッセージと履歴、各回線の利用者を一覧表示します。
• コストを把握します。 請求書、当月の見積もり、コストセンター別の費用を確認します。
• 回線を操作します。 回線の停止、停止解除、解約、新規作成、データの追加、プラン変更、番号の移行を行います。
• 情報を整理します。 従業員、コストセンター、回線グループ、および携帯電話やノートパソコンなどの資産を管理します。

請求が発生する操作（新規回線、追加データ、プラン変更）では、まず見積もりが返され、確認後にのみ課金されます。

プロンプトの例

• 今月、最も多くのデータを使用した回線はどれですか？各回線の利用者も教えてください。
• 10月の請求書では、各コストセンターはいくら使いましたか？
• 「Sales Team」の回線を停止してください。

セットアップ

VS Code の GitHub Copilot

.vscode/mcp.json に追加します。

{
  "servers": {
    "salvy": {
      "type": "http",
      "url": "https://mcp.salvy.com.br/mcp"
    }
  }
}

サーバーを起動し、VS Code の指示に従ってサインインします。

Claude

Claude の設定にあるコネクターディレクトリから Salvy を追加するか、上記の URL を使ってカスタムコネクターを追加します。

Gemini アプリ

gemini.google.com で、設定 → 接続済みアプリを開き、カスタムアプリを追加して上記の URL を貼り付けます。

Gemini CLI

gemini extensions install https://github.com/SalvyLTD/salvy-mcp

次に、Gemini CLI 内で /mcp auth salvy を実行してサインインします。

その他のクライアント

OAuth を使った Streamable HTTP 経由のリモートサーバーに対応する MCP クライアントであれば利用できます。https://mcp.salvy.com.br/mcp を指定してください。

ツール

分野	ツール
会社	list_companies
電話回線	list_phone_accounts, get_phone_account, get_phone_account_usage, get_phone_account_timeline, list_phone_account_sms_messages, update_phone_accounts, create_phone_account_group
回線の操作	create_phone_accounts, block_phone_accounts, unblock_phone_accounts, cancel_phone_accounts, unschedule_phone_account_cancellations, add_data_to_phone_accounts, change_subscription_plan, list_subscription_plans
SIM の配送	list_sim_card_shipments, get_sim_card_shipment
番号移行	port_number, get_portability_status
請求	list_invoices, get_invoice, get_current_month_estimate, get_cost_by_cost_center
人員	list_employees, create_employee, list_cost_centers, create_cost_center, update_cost_center
資産	list_assets, get_asset, get_asset_summary, create_assets, update_assets, list_asset_categories, create_asset_category, delete_asset_category, list_asset_statements, send_asset_statement
その他	get_task, submit_mcp_feedback

要件

Salvy を利用している会社と、Salvy ダッシュボードにアクセスできるユーザーが必要です。

サポート

[email protected] · プライバシーポリシー · 脆弱性の報告