Team Schema

Schema reference for federated team configuration files (external team configs).

Caution

Team configurations only support four fields: schema_version, enabled_plugins, disabled_plugins, and marketplaces. The fields additional_mcp_servers, delegation, and session do not exist in the team schema and should be configured at the organization level instead.

Top-Level Structure

{
  "schema_version": 1,
  "enabled_plugins": [],
  "disabled_plugins": [],
  "marketplaces": {}
}

schema_version

Schema version for compatibility (integer).

{
  "schema_version": 1
}

enabled_plugins

Plugins to enable for this team.

{
  "enabled_plugins": [
    "platform-tools@team-internal",
    "monitoring@shared",
    "scc-safety-net@sandboxed-code-official"
  ]
}

Plugin format: plugin-name@marketplace-name

disabled_plugins

Plugins to disable from org defaults.

{
  "disabled_plugins": [
    "legacy-tool",
    "deprecated-analyzer"
  ]
}

This allows teams to opt out of org-default plugins.

marketplaces

Team-specific plugin marketplaces (requires trust grant).

{
  "marketplaces": {
    "team-internal": {
      "source": "github",
      "owner": "myorg",
      "repo": "platform-internal-plugins"
    }
  }
}

Requirements:

• Org must set trust.allow_additional_marketplaces: true
• Marketplace URL must match trust.marketplace_source_patterns
• Name must not conflict with org marketplaces

Complete Example

{
  "schema_version": 1,
  "enabled_plugins": [
    "scc-safety-net@sandboxed-code-official",
    "platform-tools@team-internal",
    "monitoring@shared"
  ],
  "disabled_plugins": [
    "legacy-tool"
  ],
  "marketplaces": {
    "team-internal": {
      "source": "github",
      "owner": "myorg",
      "repo": "platform-internal-plugins"
    }
  }
}