查看 agent 实际调用了什么
何时使用: 你想对组织内 MCP tool 的使用情况做真实审计。
步骤
-
接入 GramConfigure clients to route through Gram.✓ 已复制→ 遥测数据开始流入
-
检查Open Gram dashboard; filter by tool/user.✓ 已复制→ 使用规律浮现
结果: 真实掌握 agent tool 的使用全貌。
作者 speakeasy-api · speakeasy-api/gram
Speakeasy 出品的控制平面——agent/MCP/skill 的可观测性、策略管控与注册表,深度 API 优先。
Gram 来自 Speakeasy(API SDK 领域的知名团队)。它是一个控制平面:观测跨 agent 的 tool 调用、执行策略、管理 MCP server、将 skill 作为可部署制品管理。专为将 agent 视作服务来治理的团队设计。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"gram-mcp": {
"command": "npx",
"args": [
"-y",
"@speakeasy/gram"
]
}
}
}
打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。
{
"mcpServers": {
"gram-mcp": {
"command": "npx",
"args": [
"-y",
"@speakeasy/gram"
]
}
}
}
Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。
{
"mcpServers": {
"gram-mcp": {
"command": "npx",
"args": [
"-y",
"@speakeasy/gram"
]
}
}
}
点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。
{
"mcpServers": {
"gram-mcp": {
"command": "npx",
"args": [
"-y",
"@speakeasy/gram"
]
}
}
}
格式与 Claude Desktop 相同。重启 Windsurf 生效。
{
"mcpServers": [
{
"name": "gram-mcp",
"command": "npx",
"args": [
"-y",
"@speakeasy/gram"
]
}
]
}
Continue 使用服务器对象数组,而非映射。
{
"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 卸载。
何时使用: 你想对组织内 MCP tool 的使用情况做真实审计。
结果: 真实掌握 agent tool 的使用全貌。
Gram 负责控制平面,agentgateway 负责高性能数据平面
| 工具 | 输入参数 | 何时调用 | 成本 |
|---|---|---|---|
| control-plane | (见文档) | 无可调用 tool——它位于 agent 旁边运作 | 1 次调用 |
追踪数据缺失确认客户端配置了 emit;检查采样设置
| 替代方案 | 何时用它替代 | 权衡 |
|---|---|---|
| archestra | 你只需要纯注册表功能 | 可观测性较弱 |