{"id":82425,"plugin_id":"plugin_asdk_app_6addf304f2f48191a34effeee30dd248","kind":"skill","collection_source":"plugin_package","comparison_source":null,"observed_at":"2026-11-05T06:11:52.176Z","digest":"49a4abff78a2436af207145d132eb184fc246c249d929329960abbcd0bcb882d","against":null,"payload":{"description":"Diagnose Markdown Logic MCP transport, authorization, discovery, rendering, and source-evidence refusals without exposing secrets or changing credentials.","included_files":[{"relative_path":"references/protocol-profiles.md","size_in_bytes":1539}],"name":"integration-troubleshooting","skill_md_contents":"---\nname: integration-troubleshooting\ndescription: Diagnose Markdown Logic MCP transport, authorization, discovery, rendering, and source-evidence refusals without exposing secrets or changing credentials.\ncompatibility: Applies to the authenticated Markdown Logic MCP service. Client protocol and skills support vary; use the actual discovery response and error.\nmetadata:\n  author: Markdown Logic\n  version: \"0.1.0\"\n  audience: authenticated\n---\n\n# Integration troubleshooting\n\nRecord the intended server origin, client/version, selected transport/revision, method/tool, HTTP status, error code, and safe request ID. Exclude tokens, passwords, authorization headers, private source bytes, and webhook secrets. A resource URI is scoped to its originating server; identical URI strings across servers are unrelated.\n\nUse the authenticated service's stateless JSON-only Streamable HTTP endpoint and the client's actual supported negotiation path. Legacy clients initialize; modern `2026-07-28` clients use discovery and required per-request metadata/header binding. Legacy HTTP+SSE sessions are not implemented. Do not advertise a session ID or mutate the tool catalogue after a skill/resource read.\n\nDistinguish authorization failures from empty results: 401 can indicate invalid/expired/revoked credentials; scope refusals, bound-team limits, account status, and project policy can prevent otherwise valid access. Discovery and skills cannot grant new scopes. Diagnose using safe, read-only calls appropriate to the existing credential; do not create credentials, grants, registrations, or repeated authorization attempts from this workflow.\n\nPreserve actual `PLAN_RESTRICTION`, `CONFIG`, `CONFLICT`, limit, unsupported-profile, and parse-failure reasons. A missing converter/search binding is not an empty successful operation. A stale revision needs a fresh read and reconciliation, not a retry loop. Honor `Retry-After` and stop repeated failing work.\n\nFor skills and importer compatibility, load [protocol profiles](references/protocol-profiles.md). Give the user the narrow supported correction and remaining uncertainty; do not claim desktop/live-edge support from a synthetic fixture.\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}