{
  "schemaVersion": "1.0.0",
  "guideVersion": "2026-09-23.3",
  "kind": "static-integration-guide",
  "liveAuthority": false,
  "guide": "/docs/api/integracion.html",
  "markdown": "/docs/api/integracion.md",
  "availability": {
    "connectionAndRat": "admitted-synthetic-pilot-only",
    "coreFourAreas": "deployed-explicit-synthetic-admission-required",
    "mcp": "read-only-catalog-not-proof-of-live-access"
  },
  "contracts": [
    {
      "href": "/downloads/gtd-api-pilot.openapi.yaml",
      "status": "admitted-pilot"
    },
    {
      "href": "/downloads/gtd-core-base.openapi.json",
      "status": "deployed-admission-required"
    }
  ],
  "examples": [
    {
      "href": "/downloads/gtd-api-comprobar.mjs",
      "purpose": "connection-authentication-check"
    },
    {
      "href": "/downloads/gtd-api-core-base.mjs",
      "purpose": "candidate-core-calls-local-key-auth-or-existing-token",
      "offlineValidation": "structure-only-no-auth-no-network"
    }
  ],
  "requiredScopesByCandidateArea": {
    "rat": {
      "read": "rat:activities:read",
      "write": "rat:events:write"
    },
    "providers": {
      "read": "providers:read",
      "write": "providers:events:write"
    },
    "assets": {
      "read": "integrations:capabilities:read",
      "write": "integrations:events:write"
    },
    "rights": {
      "read": "rights:requests:read",
      "write": "rights:requests:write"
    }
  },
  "scopeMeaning": "requirements-only-never-grants",
  "mcpReadOnlyTools": [
    "gtd.capabilities.discover",
    "gtd.connection.status",
    "gtd.rat.activities.list",
    "gtd.rat.activities.get",
    "gtd.providers.list",
    "gtd.providers.get",
    "gtd.rights.requests.status",
    "gtd.rights.requests.timeline"
  ],
  "unsupported": [
    "universal-source-discovery",
    "automatic-admission",
    "core-batch",
    "core-webhooks",
    "mcp-writes",
    "autonomous-rights-resolution"
  ],
  "sections": [
    {
      "title": "1. Selecciona la fuente y el resultado",
      "anchor": "1-selecciona-la-fuente-y-el-resultado",
      "href": "/docs/api/integracion.html#1-selecciona-la-fuente-y-el-resultado"
    },
    {
      "title": "2. Prepara identidad, permisos y vigencia",
      "anchor": "2-prepara-identidad-permisos-y-vigencia",
      "href": "/docs/api/integracion.html#2-prepara-identidad-permisos-y-vigencia"
    },
    {
      "title": "3. Autentica y comprueba la conexión",
      "anchor": "3-autentica-y-comprueba-la-conexion",
      "href": "/docs/api/integracion.html#3-autentica-y-comprueba-la-conexion"
    },
    {
      "title": "4. Mapea sólo datos admitidos",
      "anchor": "4-mapea-solo-datos-admitidos",
      "href": "/docs/api/integracion.html#4-mapea-solo-datos-admitidos"
    },
    {
      "title": "5. Vincula, envía y revisa",
      "anchor": "5-vincula-envia-y-revisa",
      "href": "/docs/api/integracion.html#5-vincula-envia-y-revisa"
    },
    {
      "title": "6. Comprueba resultados y operación",
      "anchor": "6-comprueba-resultados-y-operacion",
      "href": "/docs/api/integracion.html#6-comprueba-resultados-y-operacion"
    },
    {
      "title": "7. Qué aporta MCP",
      "anchor": "7-que-aporta-mcp",
      "href": "/docs/api/integracion.html#7-que-aporta-mcp"
    },
    {
      "title": "8. Entrega del agente",
      "anchor": "8-entrega-del-agente",
      "href": "/docs/api/integracion.html#8-entrega-del-agente"
    }
  ]
}