Skip to content

docs(gateway): explain attachment URL refusal without a public origin - #20

Merged
joeldickson merged 1 commit into
ShipLean:mainfrom
jdotc1:docs/gateway-public-origin-15
Nov 4, 2026
Merged

joeldickson merged 1 commit into
ShipLean:mainfrom
jdotc1:docs/gateway-public-origin-15

Conversation

@jdotc1

@jdotc1 jdotc1 commented Nov 2, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Explain why MCP attachment transfer tools refuse to return cluster-local upload or download URLs when no public origin is known.
  • Document the inline base64 upload fallback, trusted forwarded-host requirements, and the remaining open_url limitation.
  • Describe the publicOrigin warning in GET /health and Instance settings → General, with links to production gateway setup.

Fixes #15.

Validation

  • corepack pnpm check — passed (0 errors, warnings or hints).
  • corepack pnpm build — passed (52 pages; internal links valid).

Documentation only; no proxy trust or attachment behavior is changed.

@joeldickson
joeldickson merged commit 608605f into ShipLean:main Nov 4, 2026
3 of 4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document refused agent file URLs and publicOrigin when base_url is blank

2 participants