/ Annuaire / Playground / Gram
● Officiel speakeasy-api ⚡ Instantané

Gram

par speakeasy-api · speakeasy-api/gram

Plan de contrôle construit par Speakeasy — observabilité, politique et registry pour les agents/MCPs/skills, avec des racines profondes API-first.

Gram vient de Speakeasy (les créateurs de SDK API). C'est un plan de contrôle : observez les appels d'outils entre agents, appliquez des politiques, gérez les serveurs MCP et traitez les skills comme des artefacts déployables. Conçu pour les organisations traitant les agents comme des services.

Pourquoi l'utiliser

Fonctionnalités clés

Démo en direct

Aperçu en pratique

prêt

Installer

Choisissez votre client

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

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

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

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

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

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

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

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

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

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

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

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : Gram

Voir ce que vos agents appellent réellement

👤 Développeurs ⏱ ~15 min intermediate

Quand l'utiliser : Vous souhaitez un vrai audit de l'utilisation des outils MCP dans votre organisation.

Déroulement
  1. Connecter Gram
    Configurez les clients pour router via Gram.✓ Copié
    → Télémétrie en flux
  2. Inspecter
    Ouvrez le dashboard Gram ; filtrez par outil/utilisateur.✓ Copié
    → Patterns qui émergent

Résultat : Image réelle de l'utilisation des outils d'agent.

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

gram-mcp + agentgateway

Gram pour le plan de contrôle ; agentgateway pour le data plane haute performance

Combiner gram-mcp avec agentgateway : Gram pour le plan de contrôle, agentgateway pour le data plane haute performance✓ Copié

Outils

Ce que ce MCP expose

OutilEntréesQuand appelerCoût
control-plane (voir la documentation) Pas d'outils appelables — se positionne à côté de l'agent 1 appel

Coût et limites

Coût d'exécution

Quota d'API
Dépend du plan
Tokens par appel
N/A
Monétaire
Tier gratuit ; payant pour les fonctionnalités org
Astuce
Activez le sampling de traces — les traces complètes deviennent coûteuses

Sécurité

Permissions, secrets, portée

Portées minimales : gram-admin
Stockage des identifiants : OAuth + tokens org
Sortie de données : SaaS Speakeasy ou auto-hébergé
Ne jamais accorder : expose admin to engineering broadly

Dépannage

Erreurs courantes et correctifs

Traces manquantes

Confirmez que les clients sont configurés pour émettre ; vérifiez le sampling

Alternatives

Gram vs autres

AlternativeQuand l'utiliserCompromis
archestraVous souhaitez un registry purMoins d'observabilité

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills