Repository navigation
Submission docs: domain verification via the parent origin; drop stale redirect caveats - #196
Merged
Merged
Conversation
…e redirect caveats OpenAI's submission guide still called domain verification blocker 1: the gateway front on mcp.internetcomputer.org answers /.well-known/openai-apps-challenge with a redirect, so the app's route never sees the portal's check. That is true and irrelevant. OpenAI's submission docs accept the challenge on "the MCP host name or a parent host name; paths are ignored", and the parent origin already serves the token: dfinity/internetcomputer-org#99 (2026-09-03) commits it at public/.well-known/openai-apps-challenge, and https://internetcomputer.org/.well-known/openai-apps-challenge returns exactly the token as text/plain (re-verified 2026-09-22). Section 1 now records that, tells the submitter to choose internetcomputer.org as the challenge base, and keeps the app route and repository secret as the fallback for a portal that insists on the server host. The header callout and the submission-day checklist say the same: the gateway item is done, the secret item is conditional. Both guides also carried caveats that have expired: "the old mcp.internetcomputer.org URL redirects there from the release that ships #165" (#165 merged 2026-08-28 and the gateway redirects those paths as well) and "dfinity/internetcomputer-org#77 refreshes its text to the current draft" (#77 merged 2026-08-28). Those read as pending work; they now state the redirect as a fact. The Anthropic guide's reviewer-access text and its test-credentials draft still sent reviewers to https://mcp.internetcomputer.org for setup instructions; that origin redirects to the landing page, so name the page itself, https://internetcomputer.org/icp-mcp/. The OpenAI support row now names the public status page rather than "the status dashboard", which the support page no longer links. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TGhwpdTbUqQbR5AiiN8Ljw
There was a problem hiding this comment.
Copilot review overview
🟢 Approval recommended
The documentation changes are consistent with the verified routing and deployment behavior.
Review effort: Balanced
Findings: None
What changed in this PR
Updates directory-submission guidance to reflect current redirects, parent-host domain verification, and canonical public URLs.
Changes:
- Documents OpenAI verification via
internetcomputer.org. - Removes stale redirect caveats.
- Corrects Anthropic reviewer setup and public support/status references.
| File | Description |
|---|---|
docs/openai-directory-submission.md |
Updates verification, support, privacy, and checklist guidance. |
docs/anthropic-directory-submission.md |
Updates canonical documentation, privacy, and reviewer setup URLs. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
sea-snake
approved these changes
Sep 22, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Both directory-submission guides carried statements that were true when written and have since expired, and one of them still framed a solved problem as a blocker.
OpenAI guide — domain verification (blocker 1) is resolved. The guide said the gateway front on
mcp.internetcomputer.organswers/.well-known/openai-apps-challengewith a redirect, so the app's route never sees the portal's check. That is still true — and irrelevant: OpenAI's submission docs accept the challenge on "the MCP host name or a parent host name; paths are ignored", and the parent origin already serves the token. dfinity/internetcomputer-org#99 (2026-09-03) commits it atpublic/.well-known/openai-apps-challenge;https://internetcomputer.org/.well-known/openai-apps-challengereturns exactly the token astext/plain(re-verified 2026-09-22). Section 1 now records that, tells the submitter to chooseinternetcomputer.orgas the challenge base in the portal, and keeps the app's own route plus theOPENAI_APPS_CHALLENGE_TOKENsecret as the fallback for a portal that insists on the server host. The header callout and the submission-day checklist say the same: the gateway-forwarding item is done, the secret item is conditional.Both guides — expired caveats. "the old mcp.internetcomputer.org URL redirects there from the release that ships #165" (#165 merged 2026-08-28, and the gateway front redirects those paths regardless) and "dfinity/internetcomputer-org#77 refreshes its text to the current draft" (#77 merged 2026-08-28) read as pending work. They now state the redirect as a fact and #77 as done.
Anthropic guide — setup URL. The reviewer-access section and the test-credentials draft still sent reviewers to
https://mcp.internetcomputer.orgfor setup instructions. That origin redirects to the landing page, so the guide now names the page itself,https://internetcomputer.org/icp-mcp/.OpenAI guide — support row. Named "the status dashboard" among what the support page routes users to; the support page now links the public status page (
status.internetcomputer.org), so the row says that.Related issues
Follows #194 (status surface → Statuspage) and #195 (staging deploy fix). Companion to dfinity/internetcomputer-org#99 (parent-origin verification token) and #131 (status redirect).
Changes
docs/openai-directory-submission.md: header callout, compliance rows (privacy/support), section 1 (heading, resolution, fallback), submission-day checklist items for blocker 1 and the privacy policy.docs/anthropic-directory-submission.md: documentation row, privacy-policy publication paragraph, reviewer-access section, Documentation/Privacy URL parentheticals, test-credentials draft, submission-day checklist.Testing
https://internetcomputer.org/.well-known/openai-apps-challenge→ 200text/plain, body is the single token (2026-09-22); OpenAI's parent-host rule quoted fromdevelopers.openai.com/apps-sdk/deploy/submissionas fetched the same daymcp.internetcomputer.org/{,privacy-policy,terms,support}308 to theirinternetcomputer.org/icp-mcp/…homes (2026-09-22)/versiononly, which is still accurate.github/scripts/scan-internal-identifiers.sh origin/main...HEAD— cleancargo build/cargo test/cargo fmt/cargo clippy— n/anpm test --prefix monitoring/mcp-status— n/aChecklist
🤖 Generated with Claude Code
https://claude.ai/code/session_01TGhwpdTbUqQbR5AiiN8Ljw
Generated by Claude Code