MCP サーバー

✅ alpha 公開中 — @argosvix/mcp-server@alpha で npm から導入できます。安定版 (1.0) は準備中です。

できること

Model Context Protocol (MCP) に対応したクライアント（Claude Desktop、Cursor、Codex CLI、その他 MCP を話せるツール）から、Argosvix のデータを直接観測・照会・管理・操作できます。サーバーは 87 個の tools + 3 個の resources + 8 個の resource templates + 3 個の prompts = 合計 101 個 を公開しています（tools のうち 84 件は一般利用可能で、残り 3 件はサービス運営者専用です）。stdio と HTTP の両方の通信方式に対応します。

想定する使い方

# Claude Desktop のチャットで
あなた: 今月いちばんコストが高かったモデルは?
Claude: (argosvix MCP サーバーの get_cost_summary を呼び出す)
Claude: claude-opus-4-1-20250805 が 23 回呼び出され、合計 $0.452 でした。
        これは Anthropic の支出全体の 95% に相当します。

# Cursor の AI エージェントで
あなた: gpt-5.5 が最近遅い気がする — 何が起きてる?
エージェント: (query_calls と argosvix://traces/{id} で確認)
エージェント: 直近 10 件のうち 3 件が、ピーク時間帯に集中して 429 レート制限に当たっていました。
              残り 7 件は通常のレイテンシでした。

# Claude Desktop で、変更を伴う操作
あなた: カスタマーサポートのプロンプトに「丁寧に」を追加して。
Claude: (update_prompt でテンプレートを修正)
Claude: 追加しました。production ラベルは変更していません。

導入手順

# stdio mode (subprocess driven by Claude Desktop, Cursor, etc.)
npm install -g @argosvix/mcp-server@alpha

Claude Desktop の設定

claude_desktop_config.json に次を追記します。

{
  "mcpServers": {
    "argosvix": {
      "command": "argosvix-mcp",
      "env": {
        "ARGOSVIX_API_KEY": "argk_..."
      }
    }
  }
}

API キーは ダッシュボードの API キー画面 で発行できます。Claude Desktop を再起動すると、query_calls などの tool が表示されます。

キーの権限について: npx @argosvix/cli init が発行するキーは最小権限(読み取り + 記録の取り込みのみ)で、削除・プロンプト変更などの書き込み系ツールには使えません。ダッシュボードで発行するキーは現状フルアクセスです。エージェントに渡すキーは、書き込み操作をさせたい場合を除き CLI 発行の最小権限キーを推奨します。

Cursor の設定

Cursor を使っている場合は、ワンクリックで追加できます(開いたら YOUR_API_KEY を 自分の argk_... キーに置き換えてください):

➕ Cursor に Argosvix MCP を追加

手動で設定する場合は次のとおりです。

~/.cursor/mcp.json に次を追記します。

{
  "mcpServers": {
    "argosvix": {
      "command": "argosvix-mcp",
      "env": {
        "ARGOSVIX_API_KEY": "argk_..."
      }
    }
  }
}

Cursor を再起動すると、AI エージェントの設定画面から Argosvix の tools を利用できます。

Codex CLI の設定

~/.codex/config.toml に次を追記します。

[mcp_servers.argosvix]
command = "argosvix-mcp"
env = { ARGOSVIX_API_KEY = "argk_..." }

よくある失敗パターン

ツールを絞る(core プロファイル)

87 ツールすべてを常時使わない場合、環境変数 ARGOSVIX_MCP_PROFILE=core で日常運用の 要点 11 ツール(記録の検索・集計、コスト、レイテンシ、健康診断、異常検知、アラートの 基本操作、本番プロンプトの解決)だけに絞れます。クライアントのコンテキスト消費が 小さくなり、ツール選択の迷いも減ります。

{
  "mcpServers": {
    "argosvix": {
      "command": "npx",
      "args": ["-y", "@argosvix/mcp-server"],
      "env": {
        "ARGOSVIX_API_KEY": "argk_...",
        "ARGOSVIX_MCP_PROFILE": "core"
      }
    }
  }
}

既定は full(全ツール)。プロファイル外のツールを呼ぶと、full への切替手順つきの エラーが返ります。

HTTP transport モード

# Remote MCP server / multi-tenant. Per-request Bearer auth.
argosvix-mcp --http

# Alternate port / bind:
MCP_HTTP_PORT=4000 MCP_HTTP_HOST=0.0.0.0 \
MCP_HTTP_ALLOWED_HOSTS=mcp.example.com \
  argosvix-mcp --http

JSON-RPC 形式のボディを POST /mcp に送り、API キーを Authorization ヘッダで渡します。localhost への bind は既定で DNS rebinding 対策が有効です。localhost 以外への bind では MCP_HTTP_ALLOWED_HOSTS の明示が必須で、未設定の場合はサーバーが fail-closed で拒否します。詳細は README の Security notes を参照してください。

Tools（全 87 件、うち 3 件はサービス運営者専用）

自律 AI ops（診断と提案）

自律 AI ops（課金オペレーション — サービス運営者専用）

自律 AI ops（アラートの自動対処）

自律 AI ops（データ整理と復旧）

観測（LLM 呼び出し記録）

保存済みビュー（saved views）

監査ログ（audit log）

プロジェクト / ワークスペース

チームメンバー（Team プラン）

アラート

プロンプト管理

評価基準（eval criteria）

評価ラン（eval runs）

評価データセット

アノテーション

安全性分類

LLM 機能予算

ランタイム制御プレーン（予算ゲート）

ランタイム制御プレーン（ポリシーゲート）

ランタイム制御プレーン（人間承認ゲート）

提案（承認キュー）

イベント webhook

Resources（3 件 ── 静的スナップショット）

resources/read で取得する読み取り専用データです。ホストアプリケーションが会話の文脈に事前取得します。

Subscribe（stdio のみ）

stdio transport は resources.subscribe capability を宣言します。クライアントは 3 つの静的 resource に subscribe でき、サーバーは 60 秒ごとに polling して、内容が変化したら notifications/resources/updated を送信します。

# subscribe → change notification → auto-refresh
client: resources/subscribe { uri: "argosvix://cost/today" }
server: {}                          # accept
... internal 60s polling cycle ...
server: notifications/resources/updated { uri: "argosvix://cost/today" }
client: resources/read { uri: "argosvix://cost/today" }   # fetch latest

仕様と制限:

• subscribe できるのは上記 3 つの URI のみです。resource templates は subscribe できません。
• HTTP transport はリクエスト単位の stateless 設計で subscribe を宣言しません。resources/subscribe リクエストには -32601 Method not found を返します。
• notifications/resources/list_changed は未対応です（resource の一覧はサーバーの稼働中、固定です）。
• シャットダウンや接続切断時には、polling タイマーを停止し subscription のセットをクリアします（SIGINT / SIGTERM / beforeExit のハンドラを登録済みです）。

Resource templates（8 件 ── URI をパラメータ化）

{id} を query_calls や list_alerts などから得た id に置き換えて resources/read を呼び出します。

すべての resource template の読み取りにおいて、LLM の文脈に渡すフィールドは明示的に許可リスト方式で制限しています（prompt injection や内部実装の漏洩に対する構造的な防御です）。

Prompts（3 件 ── テンプレート化されたメッセージ）

prompts/get で取得します。ユーザーは通常、スラッシュコマンドとして呼び出します。

プラン別の上限

Team プランはベータ提供中です。詳細は 料金プラン を参照してください。

デバッグログ

既定では、バックエンドのエラー応答の生のボディは stderr に出力しません。デバッグ時のみ明示的に opt-in できます。

ARGOSVIX_MCP_DEBUG=1 argosvix-mcp           # stdio
ARGOSVIX_MCP_DEBUG=1 argosvix-mcp --http    # HTTP

この環境変数を設定しない場合は path / status / x-request-id のみを出力します。これにより、既定でバックエンド側の機微情報を本番のログ集約基盤に残しません。

リンク

• npm パッケージ / changelog: https://www.npmjs.com/package/@argosvix/mcp-server
• MCP プロトコル: https://modelcontextprotocol.io/

サポート

hello@argosvix.com

最終更新: 2026-07-09