PythonIDE Link Site

This directory is a zero-cost GitHub Pages site for:

• https://link.pythonide.xin/s/{scriptID} community work shares
• https://link.pythonide.xin/l/{code} reserved short links
• https://link.pythonide.xin/import?url=... remote import links
• https://link.pythonide.xin/.well-known/apple-app-site-association iOS Universal Links
• https://link.pythonide.xin/mcp-oauth/client.json MCP OAuth Client ID Metadata Document
• https://link.pythonide.xin/mcp-oauth/callback MCP OAuth HTTPS callback

Repository and deployment

The canonical repository is Python-IDE/pythonide-link. GitHub Pages deploys from the default branch root with the custom domain link.pythonide.xin and enforced HTTPS.

To publish changes, copy the contents of this link-site/ directory to that repository root and verify the Pages deployment. The DNS record is:

Type: CNAME
Host: link
Value: Python-IDE.github.io
TTL: 10 minutes

Do not change the root @ or www records used by the main website. Do not recreate a repository named pythonide-link under the previous owner because that would break GitHub's repository-transfer redirects.

iOS Requirement

The app entitlements must include:

applinks:link.pythonide.xin
webcredentials:link.pythonide.xin

The AASA file currently registers /s/* and /import. Keep /l/* out of AASA until the short-link resolver backend is connected, so unfinished short links still open the web fallback instead of launching the app with no resolved target.

The AASA file must be reachable without redirects:

https://link.pythonide.xin/.well-known/apple-app-site-association

MCP OAuth

The app and hosted files share one callback contract:

Client ID:    https://link.pythonide.xin/mcp-oauth/client.json
Redirect URI: https://link.pythonide.xin/mcp-oauth/callback

iOS 17.4 and later match the HTTPS callback directly through ASWebAuthenticationSession.Callback.https(host:path:). On iOS 16.2–17.3, the callback page forwards the OAuth query to the app-owned pythonide://mcp-oauth/callback compatibility URL. The app converts it back to the canonical HTTPS URL before the official MCP SDK validates state and PKCE.

Both MCP OAuth files and the AASA file must be deployed together. Do not add the OAuth callback path to applinks; the compatibility page must remain loadable on iOS versions earlier than 17.4.