/ Каталог / Песочница / Gram
● Официальный speakeasy-api ⚡ Сразу

Gram

автор speakeasy-api · speakeasy-api/gram

Control plane от Speakeasy — observability, политика и реестр для agent'ов/MCP/skills, с глубокими корнями в API-first подходе.

Gram создан командой Speakeasy (авторы API-SDK). Это control plane: наблюдение за tool-вызовами всех agent'ов, применение политик, управление MCP-серверами и обращение со skills как с развёртываемыми артефактами. Предназначен для организаций, рассматривающих agent'ов как сервисы.

Зачем использовать

Ключевые функции

Живое демо

Как выглядит на практике

готово

Установка

Выберите клиент

~/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 использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

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

Щёлкните значок MCP Servers на боковой панели Cline, затем "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 использует массив объектов серверов, а не map.

~/.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

Увидеть, что ваши agent'ы реально вызывают

👤 Разработчики ⏱ ~15 min intermediate

Когда использовать: Вам нужен реальный аудит использования MCP-инструментов в организации.

Поток
  1. Подключить Gram
    Настройте клиентов на маршрутизацию через Gram.✓ Скопировано
    → Телеметрия поступает
  2. Инспекция
    Откройте дашборд Gram; фильтруйте по инструменту/пользователю.✓ Скопировано
    → Паттерны выявлены

Итог: Реальная картина использования инструментов agent'ами.

Комбинации

Сочетайте с другими MCP — эффект x10

gram-mcp + agentgateway

Gram для control plane; agentgateway для высокопроизводительного data plane

Combine gram-mcp with agentgateway: Use Gram for control plane; agentgateway for high-perf data plane✓ Скопировано

Инструменты

Что предоставляет этот MCP

ИнструментВходные данныеКогда вызыватьСтоимость
control-plane (см. документацию) Нет вызываемых инструментов — располагается рядом с agent'ом 1 вызов

Стоимость и лимиты

Во что обходится

Квота API
Зависит от плана
Токенов на вызов
Не применимо
Деньги
Бесплатный уровень; платный для организаций
Совет
Включите семплирование трассировок — полные трассировки дорогостоящи

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: gram-admin
Хранение учётных данных: OAuth + токены организации
Исходящий трафик: Speakeasy SaaS или self-host
Никогда не давайте: expose admin to engineering broadly

Устранение неполадок

Частые ошибки и исправления

Трассировки отсутствуют

Убедитесь, что клиенты настроены на эмиссию; проверьте семплирование

Альтернативы

Gram в сравнении

АльтернативаКогда использоватьКомпромисс
archestraНужен чистый реестрМеньше observability

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills