/ Directorio / Playground / Gram
● Oficial speakeasy-api ⚡ Instantáneo

Gram

por speakeasy-api · speakeasy-api/gram

Plano de control construido por Speakeasy — observabilidad, políticas y un registro para agentes/MCPs/skills, con profundas raíces API-first.

Gram viene de Speakeasy (los creadores de API-SDK). Es un plano de control: observa llamadas a herramientas entre agentes, aplica políticas, gestiona servidores MCP y trata los skills como artefactos desplegables. Diseñado para organizaciones que tratan los agentes como servicios.

Por qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

listo

Instalar

Elige tu cliente

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

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

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

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

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

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

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

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

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

Continue usa un array de objetos de servidor en lugar de un mapa.

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

Añádelo a context_servers. Zed recarga en caliente al guardar.

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

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Gram

Ver qué llaman realmente tus agentes

👤 Desarrolladores ⏱ ~15 min intermediate

Cuándo usarlo: Quieres una auditoría real del uso de herramientas MCP en toda tu organización.

Flujo
  1. Conectar Gram
    Configure clients to route through Gram.✓ Copiado
    → Telemetría fluyendo
  2. Inspeccionar
    Open Gram dashboard; filter by tool/user.✓ Copiado
    → Patrones emergen

Resultado: Imagen real del uso de herramientas por agentes.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

gram-mcp + agentgateway

Usar Gram para el plano de control; agentgateway para el plano de datos de alto rendimiento

Combine gram-mcp with agentgateway: Use Gram for control plane; agentgateway for high-perf data plane✓ Copiado

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
control-plane (see docs) Sin herramientas invocables — se sienta junto al agente 1 call

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
Depende del plan
Tokens por llamada
N/A
Monetario
Tier gratuito; pago para funciones de organización
Consejo
Activa muestreo de trazas — las trazas completas se vuelven costosas

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: gram-admin
Almacenamiento de credenciales: OAuth + tokens de organización
Salida de datos: SaaS de Speakeasy o self-host
No conceder nunca: expose admin to engineering broadly

Resolución de problemas

Errores comunes y soluciones

Trazas faltantes

Confirma que los clientes están configurados para emitir; verifica el muestreo

Alternativas

Gram vs otros

AlternativaCuándo usarlaContrapartida
archestraQuieres solo registroMenos observabilidad

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills