/ ディレクトリ / プレイグラウンド / Gram
● 公式 speakeasy-api ⚡ 即起動

Gram

作者 speakeasy-api · speakeasy-api/gram

Speakeasyが構築したコントロールプレーン — エージェント/MCP/skillのオブザーバビリティ、ポリシー、レジストリを備え、APIファーストの設計思想に基づく。

Gramはエジェント向けAPIのSDKを手がけるSpeakeasyが提供するコントロールプレーンです:エージェント間のツール呼び出しを観察し、ポリシーを適用し、MCPサーバーを管理し、skillをデプロイ可能なアーティファクトとして扱います。エージェントをサービスとして運用する組織向けに設計されています。

なぜ使うのか

主な機能

ライブデモ

実際の動作

準備完了

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "gram-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@speakeasy/gram"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "gram-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@speakeasy/gram"
      ]
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "gram-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@speakeasy/gram"
      ]
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "gram-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@speakeasy/gram"
      ]
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "gram-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@speakeasy/gram"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json
{
  "context_servers": {
    "gram-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@speakeasy/gram"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add gram-mcp -- npx -y @speakeasy/gram

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方: Gram

エージェントが実際に何を呼び出しているかを把握する

👤 開発者 ⏱ ~15 min intermediate

使うタイミング: 組織全体のMCPツール使用状況の実際の監査が必要な場合。

フロー
  1. Gramを接続
    Gramを経由してルーティングするようにクライアントを設定します。✓ コピーしました
    → テレメトリーが流れている
  2. 確認
    Gramダッシュボードを開き、ツール/ユーザーでフィルタします。✓ コピーしました
    → パターンが浮かび上がっている

結果: エージェントのツール使用状況の実態が把握できます。

組み合わせ

他のMCPと組み合わせて10倍の力を

gram-mcp + agentgateway

Gramをコントロールプレーンに、agentgatewayを高性能データプレーンに使う

gram-mcpとagentgatewayを組み合わせる:Gramをコントロールプレーンに、agentgatewayを高性能データプレーンに使う✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
control-plane (ドキュメント参照) 呼び出し可能なツールなし — エージェントの傍らで動作します 1 call

コストと制限

運用コスト

APIクォータ
プランに依存
呼び出しあたりのトークン
N/A
金額
無料枠あり;組織向け機能は有料
ヒント
トレースのサンプリングを有効化する — フルトレースはコストがかかります

セキュリティ

権限、シークレット、影響範囲

最小スコープ: gram-admin
認証情報の保管: OAuth + 組織tokenを保管
データ送信先: Speakeasy SaaSまたはセルフホスト
絶対に付与しない: 管理者権限をエンジニアリング全体に広く公開すること

トラブルシューティング

よくあるエラーと対処法

トレースが欠落している

クライアントが出力するよう設定されているか確認し、サンプリングも確認してください

代替案

Gram 他との比較

代替案代わりに使う場面トレードオフ
archestra純粋なレジストリが必要な場合オブザーバビリティが少ない

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る