{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/nerdit-ai/json-schema/nerdit-ai-connector-view-schema.json",
  "title": "ConnectorView",
  "description": "What a person has to type into Claude, read from this deployment.\n\nEvery field is nullable for the same reason: the ``/claude`` page must\nnever print a plausible-looking instruction that this server would refuse.\nNo registered client under\n:attr:`~nerdit_cloud.config.Settings.mcp_connector_client_id` means the\nidentifier would be rejected at ``/oauth/authorize``; no Remote Link\nentitlement means the consent screen would refuse the grant no matter what\nwas pasted. In both cases the page says so instead of showing a value.\n\nThe account gateway URL does not wait for a node: an entitled account gets\n:attr:`mcp_url` with the gateway on even before its first machine, so the\nconsole can put \"connect your agent\" first (2026-09-29). The consent\nscreen still refuses with 409 until a machine exists. Only a deployment\nwith the gateway dark needs a node, because the URL it recommends is that\nnode's own.\n\n:attr:`account_connector` is the same rule applied to *which* URL is\nrecommended, and it is why the recommendation is a server answer rather\nthan a page constant: ``/mcp`` answers 503 while\n:attr:`~nerdit_cloud.config.Settings.account_mcp_gateway_enabled` is off,\nso a deployment with the gateway dark recommends the direct node connector\nit does serve.",
  "x-generated": "2026-11-19",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/nerdit-ai-openapi.json#/components/schemas/ConnectorView",
  "properties": {
    "entitled": {
      "type": "boolean",
      "title": "Entitled"
    },
    "account_connector": {
      "type": "boolean",
      "title": "Account Connector"
    },
    "mcp_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Mcp Url"
    },
    "client_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Client Id"
    },
    "client_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Client Name"
    },
    "node": {
      "anyOf": [
        {
          "$ref": "#/$defs/ConnectorNodeView"
        },
        {
          "type": "null"
        }
      ]
    },
    "advanced_node_connectors": {
      "items": {
        "$ref": "#/$defs/ConnectorNodeView"
      },
      "type": "array",
      "title": "Advanced Node Connectors"
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "entitled",
    "account_connector",
    "mcp_url",
    "client_id",
    "client_name",
    "node",
    "advanced_node_connectors"
  ],
  "$defs": {
    "ConnectorNodeView": {
      "properties": {
        "node_id": {
          "type": "string",
          "format": "uuid",
          "title": "Node Id"
        },
        "slug": {
          "type": "string",
          "title": "Slug"
        },
        "display_name": {
          "type": "string",
          "title": "Display Name"
        },
        "online": {
          "type": "boolean",
          "title": "Online"
        },
        "mcp_url": {
          "type": "string",
          "title": "Mcp Url"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "node_id",
        "slug",
        "display_name",
        "online",
        "mcp_url"
      ],
      "title": "ConnectorNodeView",
      "description": "One owned node, its live state, and its advanced direct URL."
    }
  }
}